使用Springdoc OpenAPI替代SpringFox提供微服务API文档 – Piotr

通常情况下,用项目SpringFox来为Spring Boot应用程序自动生成Swagger文档,Springdoc OpenAPI与OpenAPI 3兼容,并支持Spring WebFlux,而SpringFox不是这样。因此,似乎选择是显而易见的,尤其是在使用反应性API或Spring Cloud Gateway的情况下。在本文中,我向您展示了如何在具有网关模式的微服务架构中使用Springdoc。

作为本文中的代码示例,我们将使用由Spring Cloud构建的典型微服务架构。它由Spring Cloud Config Server,Eureka发现和Spring Cloud Gateway作为API网关组成。我们还有三个微服务,它们公开了REST API,并且是外部客户端的隐藏网关。他们每个人都公开OpenAPI文档,可以使用Swagger UI在网关上访问。带有源代码的存储库可在GitHub上找到: https
:  //github.com/piomin/sample-spring-microservices-new.git
。该存储库已在其他文章中用作示例,因此它不仅包含Springdoc库演示的代码。

与Swagger兼容迁移

与Springdoc OpenAPI库有关的第一个好消息是,它可以与SpringFox库一起存在,而不会发生任何冲突。如果有人使用Swagger文档,例如,用于合同测试的代码生成,则这可以简化向新工具的迁移。要为基于Spring MVC的标准应用程序启用Springdoc,您需要在Maven中包括以下依赖项pom.xml:

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-webmvc-core</artifactId>
    <version>1.2.32</version>
</dependency>

我们的每个Spring Boot微服务都建立在Spring MVC之上,并提供用于标准同步REST通信的端点。但是,基于Spring Cloud Gateway顶部构建的API网关使用Netty作为嵌入式服务器,并且基于反应式Spring WebFlux。它还提供Swagger UI来访问所有微服务公开的文档,因此它必须包括启用UI的库。必须包含以下两个库,以使Springdoc支持基于Spring WebFlux的反应式应用程序。

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-webflux-core</artifactId>
    <version>1.2.31</version>
</dependency>
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-webflux-ui</artifactId>
    <version>1.2.31</version>
</dependency>

我们使用@OpenAPIDefinition注释来定义Swagger网站上显示的应用程序的描述。如您所见,我们仍然可以通过启用SpringFox @EnableSwagger2:

@SpringBootApplication
@EnableDiscoveryClient
@EnableSwagger2
@OpenAPIDefinition(info =
    @Info(title = <font>"Employee API"</font><font>, version = </font><font>"1.0"</font><font>, description = </font><font>"Documentation Employee API v1.0"</font><font>)
)
<b>public</b> <b>class</b> EmployeeApplication {
    <b>public</b> <b>static</b> <b>void</b> main(String[] args) {
        SpringApplication.run(EmployeeApplication.<b>class</b>, args);
    }
}
</font>

一旦启动每个微服务,它将公开端点/v3/api-docs。我们可以通过使用springdoc.api-docs.pathSpring配置文件中的属性来自定义该上下文。

更多细节点击标题见原文。

原文 

https://www.jdon.com/53868

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » 使用Springdoc OpenAPI替代SpringFox提供微服务API文档 – Piotr

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址