Quarkus ❤️ Logbook

This is a sample project to use Quarkus/Resteasy/Logbook together.

It was created as a reponse to Logbook issue 1384, which claims:

Quarkus Resteasy endpoint returning 500 to client after HEAD request because of Logbook NullPointerException

Note that the versions of Quarkus & Logbook in the ticket above is way older than in this repository.

How to test

Terminal 1: Run the project

./mvnw compile quarkus:dev

Terminal 2: Send a HEAD request, and note 200 OK.

curl -vI http://localhost:8080/handler/test
*   Trying 127.0.0.1:8080...
* Connected to localhost (127.0.0.1) port 8080 (#0)
> HEAD /handler/test HTTP/1.1
> Host: localhost:8080
> User-Agent: curl/8.1.2
> Accept: */*
> 
< HTTP/1.1 200 OK
HTTP/1.1 200 OK

< 
* Connection #0 to host localhost left intact

Terminal 1: Notince that Logbook has added the following logs:

2023-10-31 17:32:43,000 TRACE [org.zal.log.Logbook] (executor-thread-1) Incoming Request: d9737ababd353665
Remote: localhost:8080
HEAD http://localhost:8080/handler/test HTTP/1.1
Accept: */*
Host: localhost:8080
User-Agent: curl/8.1.2

Default Quarkus readme

Expan to see the default Quarkus readme

This project uses Quarkus, the Supersonic Subatomic Java Framework.

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

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.

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

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

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

The application, packaged as an über-jar, is now runnable using java -jar target/*-runner.jar.

Creating a native executable

You can create a native executable using:

./mvnw package -Dnative

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

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

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

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

Related Guides

RESTEasy Classic (guide): REST endpoint framework implementing Jakarta REST and more

Provided Code

RESTEasy JAX-RS

Easily start your RESTful Web Services

Related guide section...

msdousti/quarkus-logbook