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

Get Hands-On Cloud-Native Applications with Java and Quarkus now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.