Как я могу исключить контроллер Spring Data REST из сгенерированной документации OpenAPI

Это больше относится к категории «хакерских обходных путей», но я обнаружил, что использование настроенного bean-компонента SpringRepositoryRestResourceProvider , который явно исключает данный тип сущности, работает. Определение его как bean-компонента переопределяет значение по умолчанию в SpringDocDataRestConfiguration.

@Configuration
public class OpenApiConfig {
    @Bean
    public SpringRepositoryRestResourceProvider springRepositoryRestResourceProvider(
            ResourceMappings mappings, ListableBeanFactory listableBeanFactory,
            Associations associations, ApplicationContext applicationContext, 
            DataRestRouterOperationService dataRestRouterOperationService,
            PersistentEntities persistentEntities, ObjectMapper mapper, 
            SpringDocDataRestUtils springDocDataRestUtils) {
        Repositories filteredRepositories = 
                new RepositoriesWithoutExcludeMe(listableBeanFactory);

        return new SpringRepositoryRestResourceProvider(
                mappings, filteredRepositories, associations, 
                applicationContext, dataRestRouterOperationService, 
                persistentEntities, mapper, springDocDataRestUtils);
    }

    private static class RepositoriesWithoutExcludeMe extends Repositories {
        RepositoriesWithoutExcludeMe(ListableBeanFactory factory) {
            super(factory);
        }

        @Override
        public boolean hasRepositoryFor(Class<?> domainClass) {
            return !isExcludeMe(domainClass) 
                   && super.hasRepositoryFor(domainClass);
        }

        @Override
        public Optional<Object> getRepositoryFor(Class<?> domainClass) {
            return optional(domainClass, super::getRepositoryFor);
        }

        @Override
        public <T, S> EntityInformation<T, S> getEntityInformationFor(
                Class<?> domainClass) {
            return nullable(domainClass, super::getEntityInformationFor);
        }

        @Override
        public Optional<RepositoryInformation> getRepositoryInformationFor(
                Class<?> domainClass) {
            return optional(domainClass, super::getRepositoryInformationFor);
        }

        @Override
        public RepositoryInformation getRequiredRepositoryInformation(
                Class<?> domainType) {
            if (isExcludeMe(domainType)) {
                throw new IllegalArgumentException(
                        "No required RepositoryInformation found for domain type " 
                        + domainType.getName());
            } else {
                return nullable(domainType, 
                        super::getRequiredRepositoryInformation);
            }
        }

        @Override
        public Optional<RepositoryInformation> getRepositoryInformation(
                Class<?> repositoryInterface) {
            return optional(repositoryInterface, 
                    super::getRepositoryInformation);
        }

        @Override
        public PersistentEntity<?, ?> getPersistentEntity(
                Class<?> domainClass) {
            return nullable(domainClass, super::getPersistentEntity);
        }

        @Override
        public List<QueryMethod> getQueryMethodsFor(Class<?> domainClass) {
            return isExcludeMe(domainClass) 
                    ? List.of() : super.getQueryMethodsFor(domainClass);
        }

        @Override
        public Iterator<Class<?>> iterator() {
            return Iterators.filter(super.iterator(), c -> !isExcludeMe(c));
        }

        private static boolean isExcludeMe(Class<?> domainClass) {
            return ExcludeMe.class.isAssignableFrom(domainClass);
        }

        private <C extends Class<?>, R> Optional<R> optional(
                C domainClass, Function<C, Optional<R>> function) {
            return isExcludeMe(domainClass) 
                    ? Optional.empty() : function.apply(domainClass);
        }

        private <C extends Class<?>, R> R nullable(
                C domainClass, Function<C, R> function) {
            return isExcludeMe(domainClass) 
                    ? null : function.apply(domainClass);
        }
    }
}

Возможно @RepositoryRestResource(exported = false) это то, что вы ищете. Для вашего примера это будет выглядеть следующим образом:

@Repository
@RepositoryRestResource(exported = false)
public interface ExcludeMeRepository extends
        PagingAndSortingRepository<ExcludeMe, Integer> {}

См. Справочное руководство Spring Data REST — Скрытие определенных репозиториев, методов запросов или полей

Аннотация @Hidden теперь поддерживается, начиная с версии v2.0.0-M7 springdoc-openapi, хотя на момент написания этой статьи она еще недоступна в релизной версии. Это изменение было добавлено согласно springdoc-openapi#1881.

@Hidden // Works as of v2.0.0-M7
@Repository
public interface ExcludeMeRepository extends
        PagingAndSortingRepository<ExcludeMe, Integer> {}