This project is quickstart using Scala 3 and Quarkus, the Supersonic Subatomic Java Framework.
If you want to learn more about Quarkus, please visit its website: https://quarkus.io/.
To learn more about Scala and new in Scala 3, check-out https://docs.scala-lang.org/scala3/new-in-scala3.html.
To start developing in Quarkus/Scala 3, I recommend the following:
- Coursier to manage Scala tools and JVM install
- GraalVM 21 installed thru Coursier
- Quarkus CLI
- VSCode as IDE
- The following VSCode Extensions
- Metals by ScalaMeta
- Scala Syntax
- Scaladex search
- Quarkus Tools
The repository also comes with a Github Action that runs tests on PRs and pushes.
Run your application in dev mode that enables live coding using:
./mvnw compile quarkus:dev
# or using the quarkus-cli (https://quarkus.io/get-started/)
quarkus dev
NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.
To run tests, use:
# using quarkus-cli which will run in continuous testing
quarkus test
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
.
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/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.
Easily start your Reactive RESTful Web Services