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 the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.