OpenAPI design-first approach with Quarkus server and Swagger Codegen

This directory contains a simple service implemented

using the design-first approach to provide an OpenAPI document
running with Quarkus server (providing the MicroProfile OpenAPI endpoints), serving the static hand-written OpenAPI document that is also used to generate the POJOs of the service interface
the POJOs are generated using Swagger Codegen's Maven plugin

For more information consult the README in the parent directory.

How to run the service

Using Quarkus's dev mode:

mvn compile quarkus:dev

Once the service runs:

http://localhost:8080/openapi fetches the OpenAPI document
http://localhost:8080/swagger-ui shows an interactive view of the API (based on Swagger-UI)