Configuring OpenAPI and the Swagger UI

The OpenAPI specification aims to provide a set of Java interfaces and programming models that can natively produce OpenAPI v3 documents from JAX-RS services. The default OpenAPI implementation in Quarkus provides an out-of-the-box standard documentation for all the exposed services that can be generated through the /openapi endpoint.

Nevertheless, you can augment JAX-RS services even further using specific annotations to provide more insights about the endpoint, its parameters, and the response. Moving on to the code, we will focus on the Chapter06/openapi-swagger example. As you can check from its configuration, we have added the following extension to the project:

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

Since we have several REST...