/quarkus-gw2-rest

Evaluating Quarkus by integrating the Guild Wars 2 api

Primary LanguageJavaMIT LicenseMIT

Quarkus Guild Wars 2 REST

This project uses Quarkus, the Supersonic Subatomic Java Framework. If you want to learn more about Quarkus, please visit: https://quarkus.io/

The project is an attempt of evaluating Quarkus in a non "Hello World!" scenario. The use case considered is integrating the Guild Wars 2 (https://www.guildwars2.com/en-gb/) api to retrieve the list of achievements for an in game character using a rest client. This data is then filtered to remove already completed achievements and sorted to highlight the easiest achievements to complete next, before being exposed via a rest endpoint.

Quarkus extensions support

Quarkus allows adding various component via extensions.

./gradlew listExtensions
./gradlew addExtension --extensions="rest-client"

Running the application in dev mode

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

./gradlew quarkusDev

Packaging and running the application

The application can be packaged using ./gradlew quarkusBuild. It produces the quarkus-gw2-rest-1.0.0-runner.jar file in the build directory. Be aware that it’s not an über-jar as the dependencies are copied into the build/lib directory.

The application is now runnable using java -jar build/quarkus-gw2-rest-1.0.0-runner.jar.

If you want to build an über-jar, just add the --uber-jar option to the command line:

./gradlew quarkusBuild --uber-jar

Creating a native executable

You can create a native executable using: ./gradlew build -Dquarkus.package.type=native.

Or, if you don't have GraalVM installed, you can run the native executable build in a container using: ./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true.

You can then execute your native executable with: ./build/quarkus-gw2-rest-1.0.0-runner

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