gintsgints/quarkus-ws

Quarkus restufl webservice example

Quarkus WS example project

Framework project site - https://quarkus.io/

Working example

All code is automaticaly deployed on development environment. To access it you have to modify your local hosts file and add entry:

10.203.8.21 wsexample.dev.balcia.com

then go http://wsexample.dev.balcia.com:30310/

Getting started

Make sure you point your environment to Java 11 JDK:

set JAVA_HOME=C:\Development\exec\jdk-11

To start development start first start database:

docker-compose up -d db

If you are going to work with secured endpoints, you have to start keycloak server:

docker-compose up -d keycloak

After you start keycloak, login to server - http://localhost:8280/auth/ with admin/admin_234 and create realm from file - quarkus-realm.json

then start with mvn command:

mvnw compile quarkus:dev -Dquarkus.profile=dev

Then go

http://localhost:8080/hello http://localhost:8080/hello/greeting/type_your_name_here http://localhost:8080/fruits/

Also you can check swagger here:

http://localhost:8080/swagger-ui

Some test commands:

curl -X POST "http://wsexample.dev.balcia.com:30310/fruits" -H "accept: application/json" -H "Content-Type: application/json" -d '{"name": "First fruit"}'
curl -X GET "http://wsexample.dev.balcia.com:30310/fruits/{id_you_got_form_previous}" -H "accept: application/json"

Testing

To test project you execute:

mvnw test

Building docker image

Docker image is build with command:

docker build -t registry.balcia.com/balcia_dev/java/quarkus-ws .

then you start whole project by docker compose:

docker-compose up -d