我目前正在将我们的API文档(即Swagger 1.5)迁移到Swagger 2.0(OpenApi 3.0)
API文档是Swagger文档,它使用maven包swagger-annotations和Java注释通过Java注释生成swagger-jaxrs。我已经用新版本更新了pom.xml,因此它看起来像:
        <dependency>
            <groupId>io.swagger.core.v3</groupId>
            <artifactId>swagger-annotations</artifactId>
            <version>2.0.6</version>
        </dependency>
        <dependency>
            <groupId>io.swagger.core.v3</groupId>
            <artifactId>swagger-jaxrs2</artifactId>
            <version>2.0.6</version>
        </dependency>
Run Code Online (Sandbox Code Playgroud)
并且所有旧注释都被新注释替换(变化很大)并且看起来不错。
关键是我们使用BeanConfig来定义文档的常规配置并自动扫描所有REST资源,因此文档是在自动生成的/swagger.json。
该问题是我无法找到做这样的事情,创建使一切变得在产生BeanConfig和自动扫描资源的“新路” /swagger.json或/openapi.json(也许现在是一样的东西OpenAPIDefinition?)
如果有人能指出我正确的方向,我将不胜感激。