Chapter 6. Enabling OpenAPI and Swagger-UI support in your Spring Web example

Procedure

1. Enter the following command to add the quarkus-smallrye-openapi extension as a dependency of your Spring Web example. Adding the extension is enough to generate a basic OpenAPI schema document from your REST Endpoints:

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

   Copy to Clipboard Toggle word wrap

   Entering the command adds the following dependency to your pom.xml:

   pom.xml

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

   Copy to Clipboard Toggle word wrap

2. Enter the following command to obtain the schema document from the /q/openapi:

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

   Copy to Clipboard Toggle word wrap

   You receive a response with the generated OpenAPI schema document in YAML format:

   ---
   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