Spring Data MongoDB Hello World Example

In this tutorial, we will show how to configure MongoDB using Spring Data. And then we will create hello world example to show how to perform CRUD operations with MongoDB and Spring Data.

For this you have to do the following steps.
Step 1: First you have to Install MongoDB to you system. For windows installation click here.
Step 2: Now add the following tools and libraries for minimum requirement of this example.
  • JDK/Java 1.6 or later
  • SpringSource Tool Suite or later
  • spring-data-mongodb-1.0.2.RELEASE (download it from here)
  • spring-data-commons-core-1.2.0.RELEASE (download it from here)
  • java mongodb driver 2.10.1 (dowload it from here)
  • spring-core-3.1.1.RELEASE
  • spring-context-3.1.1.RELEASE
  • spring-asm-3.1.1.RELEASE
  • spring-expression-3.1.1.RELEASE
  • spring-aop-3.1.1.RELEASE
  • spring-tx-3.1.1.RELEASE
  • cglib-nodep-2.1.3

Step 3: Spring XML configuration file (mongo-config.xml):
This spring configuration file contains related bean configurations in order to run this example.
<beans xmlns:context="http://www.springframework.org/schema/context" xmlns:mongo="http://www.springframework.org/schema/data/mongo" xmlns:p="http://www.springframework.org/schema/p" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.springframework.org/schema/beans" xsi:schemalocation="http://www.springframework.org/schema/beans 
 <!-- Default bean name is 'mongo' -->
 <mongo:mongo host="localhost" port="27017"/>
  <!-- Default bean name is 'mongo' -->
   <mongo:options connections-per-host="100"
    <context:component-scan base-package="com.dineshonjava.mongo">
      <context:exclude-filter type="annotation" expression="org.springframework.context.annotation.Configuration"/>
 <!-- Offers convenience methods and automatic mapping between MongoDB JSON documents and your domain classes. -->
  <bean class="org.springframework.data.mongodb.core.MongoTemplate" id="mongoTemplate">
       <constructor-arg ref="mongo"/>
         <constructor-arg name="databaseName" value="dineshonjavaDB"/>
The MongoTemplate is configured with a reference to a MongoDBFactoryBean (which handles the actual database connectivity) and is setup with a database name used for this example.

Step 4: Domain Objects or Classes-

Employee.java represent domain classe which spring data will use to convert them from/to mongodb representation.

package com.dineshonjava.mongo.dto;

import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;

 * @author Dinesh Rajput
@Document(collection = "dojCollection")
public class Employee {
 private int empId;
 private String empName;
 private long salary;
 private int empAge;
 public int getEmpId() {
  return empId;
 public void setEmpId(int empId) {
  this.empId = empId;
 public String getEmpName() {
  return empName;
 public void setEmpName(String empName) {
  this.empName = empName;
 public long getSalary() {
  return salary;
 public void setSalary(long salary) {
  this.salary = salary;
 public int getEmpAge() {
  return empAge;
 public void setEmpAge(int empAge) {
  this.empAge = empAge;
 public String toString() {
  return "Employee [age=" + empAge + ", empName=" + empName + ", empId="
    + empId + ", salary=" + salary + "]";
Now if you look at the class more closely you will see some Spring Data specific annotations like @Id and @Document . The @Document annotation identifies a domain object that is going to be persisted to MongoDB. Now that we have a persistable domain object we can move on to the real interaction.

Step 5: For easy connectivity with MongoDB we can make use of Spring Data's MongoTemplate class. Here is a simple HelloMongoDB object that handles all 'Employee' related interaction with MongoDB by means of the MongoTemplate.

package com.dineshonjava.mongo.main;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.data.mongodb.core.MongoOperations;
import org.springframework.stereotype.Repository;

import com.dineshonjava.mongo.dto.Employee;

 * @author Dinesh Rajput
public class HelloMongoDB {
 MongoOperations mongoOperations;
 public void execute() {
  if (mongoOperations.collectionExists(Employee.class)) {
  Employee employee = new Employee();
  employee.setEmpName("Dinesh Rajput");
  List<Employee> results = mongoOperations.findAll(Employee.class);
  System.out.println("Results: " + results);

Step 6: Running the Example
Following code shows how to run this example

package com.dineshonjava.mongo.main;

import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;

 * @author Dinesh Rajput
public class HelloMongoTestApp {

  * @param args
 public static void main(String[] args) {
   ConfigurableApplicationContext context = new ClassPathXmlApplicationContext("mongo-config.xml");
   HelloMongoDB hello = (HelloMongoDB) context.getBean("helloMongoDB");
   System.out.println( "DONE!" );


If everything is fine then run the above main application as Java Application we will get the following output.
log4j:WARN No appenders could be found for logger (org.springframework.context.support.ClassPathXmlApplicationContext).
log4j:WARN Please initialize the log4j system properly.
Results: [Employee [age=26, empName=Dinesh Rajput, empId=1001, salary=70000]]

Download SourceCode + Libs

Spring data for MongoDB

                             <<previous<<             || index  ||         >>next>>

1 comment:

  1. David Penn @LinkedIn

    Entertprise Software Developer/Architect

    Top Contributor

    Another of your stellar examples, Dinesh. Many thanks for your expertise and generosity.