第 6 章 在 Spring Web 示例中启用 OpenAPI 和 Swagger-UI 支持

流程

1. 输入以下命令将 quarkus-smallrye-openapi 扩展添加为 Spring Web 示例的依赖项。添加扩展足以从 REST 端点生成基本 OpenAPI 模式文档：

   ./mvnw quarkus:add-extension -Dextensions="io.quarkus:quarkus-smallrye-openapi"

   Copy to Clipboard Toggle word wrap

   输入命令会在 pom.xml 中添加以下依赖项：

   pom.xml

   <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-smallrye-openapi</artifactId>
   </dependency>

   Copy to Clipboard Toggle word wrap

2. 输入以下命令从 /q/openapi 获取 schema 文档：

   curl http://localhost:8080/q/openapi

   Copy to Clipboard Toggle word wrap

   您以 YAML 格式收到对生成的 OpenAPI 模式文档的响应：

   ---
   openapi: 3.0.3
   info:
     title: Generated API
     version: "1.0"
   paths:
     /greeting:
       get:
         responses:
           "200":
             description: OK
             content:
               text/plain:
                 schema:
                   type: string
     /greeting/{name}:
       get:
         parameters:
         - name: name
           in: path
           required: true
           schema:
             type: string
         responses:
           "200":
             description: OK
             content:
               application/json:
                 schema:
                   $ref: '#/components/schemas/Greeting'
   components:
     schemas:
       Greeting:
         type: object
         properties:
           message:
             type: string

   Copy to Clipboard Toggle word wrap