A simple project designed to explore CRUD operations using Hibernate with the MongoDB Dialect.
The goal is to understand how Hibernate interacts with MongoDB and how traditional JPA operations map to BSON documents.
This repository is organized into two tagged versions, each representing a stage of the learning series:
| Tag | Description |
|---|---|
| v1.0 | Part 1 – Basic CRUD operations with the Book entity (insert, list, update, delete). Focuses on Hibernate setup, MongoDB connection, and simple persistence using the MongoDB Dialect. |
| v2.0 | Part 2 – Modeling relationships between Book and Review. Explores embedded documents, unbounded arrays, and a two-collection approach using native MongoDB queries. |
You can check out each version with:
# Part 1
git checkout v1.0
# Part 2
git checkout v2.0
Before running the project, make sure you have:
- Java 17 or newer
- Apache Maven 3.8+
- MongoDB 6.0+ configured as a replica set (required by the MongoDB Hibernate Dialect for transaction support)
- Clone the repository and enter the project folder:
git clone https://github.com/mongodb-developer/mongodb-hibernate-crud
cd mongodb-hibernate-crud
- Edit the MongoDB connection URL
Open the file src/main/resources/hibernate.cfg.xml and replace the value of the jakarta.persistence.jdbc.url property with your own MongoDB URI:
<property name="jakarta.persistence.jdbc.url">
mongodb+srv://<username>:<password>@<cluster-url>/mydb?appName=devrel-mongodb-hibernate
</property>
- Build the project with Maven:
mvn clean package
- Run the application:
mvn exec:java -Dexec.mainClass="com.mongodb.MyApplication"
When you run the project, you'll see an interactive CLI menu:
=== BOOK MENU ===
1 - Add Book
2 - List Books
3 - Update Book Title
4 - Delete Book
5 - Add Review
0 - Exit
