- Java 8 to 13
- Spring boot 2.2.0.RELEASE
- MongoDB 4.2.1
- MongoDB Java driver 3.11.1
- Maven 3.6.2
- Get started with a Free Tier Cluster on MongoDB Atlas.
- Read this blog post: Quick Start - Getting your Free MongoDB Atlas Cluster.
- You will need to update the default MongoDB URI
spring.data.mongodb.uriin theapplication.propertiesfile.
- Start the server in a console with
mvn spring-boot:run. - If you add some Unit Tests, you would start them with
mvn clean test. - You can start the end to end tests with
mvn clean integration-test. - You can build the project with :
mvn clean package. - You can run the project with the fat jar and the embedded Tomcat:
java -jar target/java-spring-boot-mongodb-starter-1.0.0.jarbut I would use a real tomcat in production.
- Swagger is already configured in this project in
SwaggerConfig.java. - The API can be seen at http://localhost:8080/swagger-ui.html.
- You can also try the entire REST API directly from the Swagger interface!
This project showcases several features of MongoDB:
- MongoDB multi-document ACID transactions for 3 functions. See
MongoDBPersonRepository.saveAll(). - MongoDB Aggregation pipeline. See
MongoDBPersonRepository.getAverageAge(). - Implementation of basic CRUD queries. See
MongoDBPersonRepository.java. - MongoDB typed collection with automatic mapping to POJOs using codecs: See
ConfigurationSpring.java. - How to manipulate correctly ObjectidId across, the REST API, the POJOs and the database itself. See the main trick in
Person.java.
And some other cool stuff:
- You can change the default Spring Boot logo by adding a banner.txt file in your properties.
- You don't have to use Spring Data MongoDB. The MongoDB driver is more flexible and already provide everything you need to code efficiently and optimise your queries correctly.
- Maxime Beugnet @ MongoDB.