Thomas Peetz
79 lines
2.8 KiB
Markdown
79 lines
2.8 KiB
Markdown
# kontor Project
|
||
|
||
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:
|
||
```shell script
|
||
./gradlew quarkusDev
|
||
```
|
||
|
||
> **_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:
|
||
```shell script
|
||
./gradlew build
|
||
```
|
||
It produces the `quarkus-run.jar` file in the `build/quarkus-app/` directory.
|
||
Be aware that it’s not an _über-jar_ as the dependencies are copied into the `build/quarkus-app/lib/` directory.
|
||
|
||
The application is now runnable using `java -jar build/quarkus-app/quarkus-run.jar`.
|
||
|
||
If you want to build an _über-jar_, execute the following command:
|
||
```shell script
|
||
./gradlew build -Dquarkus.package.type=uber-jar
|
||
```
|
||
|
||
The application, packaged as an _über-jar_, is now runnable using `java -jar build/*-runner.jar`.
|
||
|
||
## Creating a native executable
|
||
|
||
You can create a native executable using:
|
||
```shell script
|
||
./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:
|
||
```shell script
|
||
./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true
|
||
```
|
||
|
||
You can then execute your native executable with: `./build/kontor-1.0.0-SNAPSHOT-runner`
|
||
|
||
If you want to learn more about building native executables, please consult https://quarkus.io/guides/gradle-tooling.
|
||
|
||
## Related Guides
|
||
|
||
- JDBC Driver - H2 ([guide](https://quarkus.io/guides/datasource)): Connect to the H2 database via JDBC
|
||
- Hibernate ORM with Panache and Kotlin ([guide](https://quarkus.io/guides/hibernate-orm-panache-kotlin)): Define your persistent model in Hibernate ORM with Panache
|
||
- SmallRye OpenAPI ([guide](https://quarkus.io/guides/openapi-swaggerui)): Document your REST APIs with OpenAPI - comes with Swagger UI
|
||
- YAML Configuration ([guide](https://quarkus.io/guides/config#yaml)): Use YAML to configure your Quarkus application
|
||
- SmallRye Health ([guide](https://quarkus.io/guides/microprofile-health)): Monitor service health
|
||
|
||
## Provided Code
|
||
|
||
### YAML Config
|
||
|
||
Configure your application with YAML
|
||
|
||
[Related guide section...](https://quarkus.io/guides/config-reference#configuration-examples)
|
||
|
||
The Quarkus application configuration is located in `src/main/resources/application.yml`.
|
||
|
||
### RESTEasy Reactive
|
||
|
||
Easily start your Reactive RESTful Web Services
|
||
|
||
[Related guide section...](https://quarkus.io/guides/getting-started-reactive#reactive-jax-rs-resources)
|
||
|
||
### SmallRye Health
|
||
|
||
Monitor your application's health using SmallRye Health
|
||
|
||
[Related guide section...](https://quarkus.io/guides/smallrye-health)
|