Quarkus MongoDB CRUD

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/.

This project also supports Swagger UI: http://localhost:8080/q/swagger-ui/#/

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-mongodb-crud-1.0.0-SNAPSHOT-runner

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

Related Guides

• REST (guide): A Jakarta REST implementation utilizing build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it.
• MongoDB client (guide): Connect to MongoDB in either imperative or reactive style
• SmallRye OpenAPI (guide): Document your REST APIs with OpenAPI - comes with Swagger UI
• REST Jackson (guide): 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

Provided Code

REST

Easily start your REST Web Services

Related guide section...

Tests the routes

curl http://localhost:8080/api/hello

curl -X POST http://localhost:8080/api/person \
     -H 'Content-Type: application/json' \
     -d '{"name": "John Doe", "age": 30}'

curl http://localhost:8080/api/persons

curl -X PUT http://localhost:8080/api/person/661b52a1ce40c303a49e2c85

curl -X DELETE http://localhost:8080/api/person/661c4b711508a4729b9e6f4e

Author

Maxime Beugnet

• maxime@mongodb.com
• MaBeuLux88 on GitHub
• MaBeuLux88 in the MongoDB Developer Community forum.