接口文档选型

后端
created : 
OpenAPI 规范（OAS），是定义一个标准的、与具体编程语言无关的RESTful API的规范

OpenAPI 2
OpenAPI 3, 是 OpenAPI 规范的第一个正式版本,因为它是由 SmartBear Software 捐赠给 OpenAPI Initiative，并在 2015 年从 Swagger 规范重命名为 OpenAPI 规范。

Swagger 2 , 使用OpenAPI 2
坐标 io.springfox
springboot <= 2.5.6 

经典, 2.9.2 : Jun 23, 2018发布
 <!--swagger        -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<!--swagger-ui.html模式        -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.9.2</version>
</dependency>
<!--doc.html模式        -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.2</version>

后为了简化, 3.0.0 : Jul 14, 2020发布
注意: 这里还是swagger2 , 只是swagger2的版本是3.0.0, 简化了引入
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

至此 swagger2 结束, swagger3到来, 但改名为openapi了
springfox 代表 swagger2
OpenAPI 3 用 SpringDoc

OpenAPI 3 

SpringDoc 从 OpenAPI 3 开始
要求springboot >= 3.0.0

那么问题来了
springboot between 2.5.6 and 2.7.8 之间的呢? 
用swagger2

但是有冲突, 因为2.6.x 中

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher
      
matching-strategy 有两种 ant_path_matcher 和 path_pattern_parser  
2.5.6 为ant_path_matcher
2.6.6 之后改为 path_pattern_parser

swagger2 只解析为ant_path_matcher
所以在 pringboot between 2.5.6 and 2.7.8 之间需要修改 path_pattern_parser -> ant_path_matcher

©2020-2024