Table of Contents

• code-with-quarkus Project
  • Requirements
    • PostgreSQL database
  • Running the application in dev mode
  • Packaging and running the application
  • Creating a native executable
  • Provided Code
    • RESTEasy JAX-RS

This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit its website: https://quarkus.io/ .

Requirements

PostgreSQL database

This Quarkus application uses a PostgreSQL database for the ORM operations. This database can be created using Podman and these are the instructions.

Remove an existing POD if it exists.

$ podman pod rm quarkus_test_db_pod

If the POD is running and the remove operation fails either stop the pod first or use the -f flag to force the POD removal.

Create a new POD mapping the internal 5432 PostgreSQL port with the host 5432 which is being used in the application.properties file.

$ podman pod create -p 5432:5432 --name quarkus_test_db_pod

Start a PostgreSQL container on the newly created POD using as database, user and password the same values used in the application.properties file.

$ podman run --name quarkus_test_db --pod quarkus_test_db_pod -d -e POSTGRES_DB=hibernate_db -e POSTGRES_USER=hibernate -e POSTGRES_PASSWORD=hibernate postgres:latest

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./mvnw compile quarkus:dev

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

Packaging and running the application

The application can be packaged using:

./mvnw package

It produces the quarkus-run.jar file in the target/quarkus-app/ directory. Be aware that it’s not an über-jar as the dependencies are copied into the target/quarkus-app/lib/ directory.

If you want to build an über-jar, execute the following command:

./mvnw package -Dquarkus.package.type=uber-jar

The application is now runnable using java -jar target/quarkus-app/quarkus-run.jar.

Creating a native executable

You can create a native executable using:

./mvnw package -Pnative

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

./mvnw package -Pnative -Dquarkus.native.container-build=true

You can then execute your native executable with: ./target/code-with-quarkus-1.0.0-SNAPSHOT-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/maven-tooling.html.

Provided Code

RESTEasy JAX-RS

Easily start your RESTful Web Services

Related guide section...