https://github.com/mongodb-developer/quarkus-mongodb-crud
https://github.com/mongodb-developer/quarkus-mongodb-crud
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mongodb-developer/quarkus-mongodb-crud
- Owner: mongodb-developer
- License: apache-2.0
- Created: 2024-04-15T23:33:38.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-04-16T01:20:47.000Z (over 1 year ago)
- Last Synced: 2025-04-12T16:18:19.149Z (8 months ago)
- Language: Java
- Size: 20.5 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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:
```shell script
./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:
```shell script
./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:
```shell script
./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:
```shell script
./mvnw package -Dnative
```
Or, if you don't have GraalVM installed, you can run the native executable build in a container using:
```shell script
./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](https://quarkus.io/guides/rest)): 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](https://quarkus.io/guides/mongodb)): Connect to MongoDB in either imperative or reactive style
- SmallRye OpenAPI ([guide](https://quarkus.io/guides/openapi-swaggerui)): Document your REST APIs with OpenAPI - comes with Swagger UI
- 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
## Provided Code
### REST
Easily start your REST Web Services
[Related guide section...](https://quarkus.io/guides/getting-started-reactive#reactive-jax-rs-resources)
## Tests the routes
```bash
curl http://localhost:8080/api/hello
```
```bash
curl -X POST http://localhost:8080/api/person \
-H 'Content-Type: application/json' \
-d '{"name": "John Doe", "age": 30}'
```
```bash
curl http://localhost:8080/api/persons
```
```bash
curl -X PUT http://localhost:8080/api/person/661b52a1ce40c303a49e2c85
```
```bash
curl -X DELETE http://localhost:8080/api/person/661c4b711508a4729b9e6f4e
```
## Author
Maxime Beugnet
- maxime@mongodb.com
- MaBeuLux88 on [GitHub](https://github.com/mabeulux88)
- MaBeuLux88 in the [MongoDB Developer Community forum](https://www.mongodb.com/community/forums/u/MaBeuLux88/summary).