如何使用springdoc-openapi将Open API 3与Spring project（而不是Spring Boot）集成

Answer 1

使用springdoc-openapi-ui 1.5.2为spring-mvc(5.3.1)加载ui看起来更加简单：

build.gradle（gradle Version6.5)

implementation 'org.springdoc:springdoc-openapi-ui:1.5.2'

dependencies一节中不显式地需要spring-boot-autocfigure和spring-boot，因为org.springdoc:springdoc-openapi-ui:1.5.2已经有了这两者（版本2.4.0)。您会惊讶于最终应用程序将添加多少依赖项以及哪些依赖项。

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = {"org.springdoc"})
@Import({org.springdoc.core.SpringDocConfiguration.class,
         org.springdoc.webmvc.core.SpringDocWebMvcConfiguration.class,
         org.springdoc.webmvc.ui.SwaggerConfig.class,
         org.springdoc.core.SwaggerUiConfigProperties.class,
         org.springdoc.core.SwaggerUiOAuthProperties.class,
         org.springframework.boot.autoconfigure.jackson.JacksonAutoConfiguration.class})

class OpenApiConfig implements WebMvcConfigurer {
}

<security:intercept-url pattern="/swagger*/**" access="ROLE_DEVELOPER"/>
<security:intercept-url pattern="/v3/api-docs" access="ROLE_DEVELOPER"/>

http://localhost:8080/your_context_path/swagger-ui.html
http://localhost:8080/your_context_path/v3/api-docs