Für die Entwicklung von REST APIs ist die Swagger-UI sehr hilfreich.
Ok, dann wollen wir mal in einem Quarkus Projekt eine Swagger-UI hinzufügen. Das geht mit einem Befehl, da Quarkus einen guten Plugin Mechanismus hat:
./mvnw quarkus:add-extension -Dextensions=“openapi“
Nach 27 Sekunden kommt das Build Success:
1 2 3 4 |
[INFO] --- quarkus-maven-plugin:0.24.0:add-extension (default-cli) @ info-kleinhirn --- ✅ Adding extension io.quarkus:quarkus-smallrye-openapi [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS |
So, das wars schon. Nun noch die Anwendung starten mit
./mvnw compile quarkus:dev
im Log kommt dann:
1 |
INFO [io.quarkus] (main) Installed features: [cdi, resteasy, smallrye-openapi, swagger-ui] |
Also die swagger-ui ist installiert.
Nun starten wir den Browser mit der Swagger-UI über:
http://[PI-Adresse]/swagger-ui
Erste Ergebnisse: