Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/upa-io/quarkus-gradle-chassis-kotlin

apis kotlin quarkus

Last synced: 3 days ago
JSON representation

Host: GitHub
URL: https://github.com/upa-io/quarkus-gradle-chassis-kotlin
Owner: upa-io
License: apache-2.0
Created: 2024-06-22T17:47:28.000Z (3 months ago)
Default Branch: main
Last Pushed: 2024-09-25T13:32:20.000Z (8 days ago)
Last Synced: 2024-09-25T20:02:42.674Z (8 days ago)
Topics: apis, kotlin, quarkus
Language: Kotlin
Homepage:
Size: 138 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# rest-kotlin-quickstart

[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=upa-io_quarkus-gradle-chassis-kotlin&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=upa-io_quarkus-gradle-chassis-kotlin)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=upa-io_quarkus-gradle-chassis-kotlin&metric=coverage)](https://sonarcloud.io/summary/new_code?id=upa-io_quarkus-gradle-chassis-kotlin)
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=upa-io_quarkus-gradle-chassis-kotlin&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=upa-io_quarkus-gradle-chassis-kotlin)

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.jar.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.native.enabled=true
```

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

You can then execute your native executable with: `./build/rest-kotlin-quickstart-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

- REST Jackson ([guide](https://quarkus.io/guides/rest#json-serialisation)): Jackson serialization support for Quarkus REST. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it
- Kotlin ([guide](https://quarkus.io/guides/kotlin)): Write your services in Kotlin

## Provided Code

### REST

Easily start your REST Web Services

[Related guide section...](https://quarkus.io/guides/getting-started-reactive#reactive-jax-rs-resources)