REST API is today's requirements for Mobile Apps, Web Application or Desktop Application that need to connect with Database. That's why we need to create a step by step tutorial of building Java REST API server using Spring Boot and MongoDB. The data store in MongoDB server And accessible everywhere via Java REST API. Previously, we have to create REST API in different technology and framework using Grails and Node.js. Now, we are using Spring Boot for it. After all, you can compare which technology or framework that fits Your needs.
1. Generate a New Spring Boot Gradle Project
We assume that you have installed JDK 8, Gradle and IDE (Netbeans, Eclipse, STS or IntellijIdea). Next, we will create a new Spring Boot Gradle project using Spring Initializer. Just go to Spring Initializr web-based Spring project generator then fill The required frameworks and libraries.
After filling all fields, click Generate Project. It will automatically download the zipped project. Next, extract the zipped project to your java projects folder. On the project folder root, you will find `build.gradle` file for register dependencies, initially it Looks like this.
Buildscript {
Ext {
springBootVersion = '1.5.7.RELEASE'
}
Repositories {
mavenCentral()
}
Dependencies {
Classpath( "org.springframework.boot:spring-boot-gradle-plugin: ${springBootVersion} " )
}
}
Apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'
Group = 'com.spring'
version = '0.0.1-SNAPSHOT'
source Compatibility = 1.8
Repositories {
mavenCentral()
}
Dependencies {
Compile( 'org.springframework.boot:spring-boot-starter-data-mongodb' ) Compile
( 'org.springframework.boot:spring-boot-starter-web' )
test Compile( 'org.springframework.boot: Spring-boot-starter-test' )
}
Then open the other terminal then run MongoDB server. In current terminal go to newly extracted Spring Boot project folder then type this command to compile the application.
./gradlew compile
Open and edit `src/resources/application.properties` then add this lines of strings.
Spring.data.mongodb.database=springmongodb
Spring.data.mongodb.host=localhost
Spring.data.mongodb.port= 27017
2. Create Model or Entity Class
We are not accessing directly to MongoDB collections and fields but we have to access it via Java Object. For that, we have to create a new Java Class as a model or entity. If you are using Netbeans (similar with some IDE), right -click project name then click `New` then click `Java Class`.
Fill necessary fields like above screenshot then click Finish button. Netbeans will automatically open the newly created file, replace all codes with this.
Package com.spring.restapi.models;
Import org.springframework.data.annotation.Id;
import org.springframework.data.mongodb.core.mapping.Document;
@Document (collection = "products" )
public class Product {
@Id
String id;
String prodName;
String prodDesc;
Double prodPrice;
String prodImage;
Public Product () {
}
Public Product (of prodName String, String prodDesc, prodPrice Double, String prodImage) {
the this .prodName of prodName =;
the this .prodDesc = prodDesc;
the this .prodPrice = prodPrice;
the this .prodImage = prodImage;
}
Public String getId () {
return id;
}
Public void setId (String id) {
this .id = id;
}
Public String getProdName () {
return prodName;
}
Public void setProdName (String prodName) {
this .prodName = prodName;
}
Public String getProdDesc () {
return prodDesc;
}
Public void setProdDesc (String prodDesc) {
this .prodDesc = prodDesc;
}
Public Double getProdPrice () {
return prodPrice;
}
Public void setProdPrice (Double prodPrice) {
this .prodPrice = prodPrice;
}
Public String getProdImage () {
return prodImage;
}
Public void setProdImage (String prodImage) {
this .prodImage = prodImage;
}
}
That product class mapping to products collections of MongoDB which has 5 fields (id, prodName, prodDesc, prodPrice, prodImage). Each field has getter and setter.
3. Create a New Repository Interface for Product Model
Now, we need to create an interface for connecting Product model and controller. On Netbeans right-click project name on projects left panel then choose `New` then choose `Java Interface`.
Fill necessary fields like above screenshot then click Finish button. Netbeans will automatically open the new `ProductRepository.java` interface file. Replace all codes with this.
Package com.spring.restapi.repositories;
Import com.spring.restapi.models.Product;
import org.springframework.data.repository.CrudRepository;
Public interface ProductRepository extends CrudRepository < Product , String > {
@Override
Product findOne (String id) ;
@Override
void delete (Product deleted) ;
}
We only add `findOne` and `delete` methods to the interface because the rest method already handled by `CrudRepository` of Spring Data MongoDB.
4. Create a New RESTful Controller for Accessing Product Data
Now, it's a time for RESTful Web Service (REST API) implementation by creating a new RESTful controller file. On the Netbeans right-click project name then click `New` then click `Java Class` again.
Fill necessary fields like above screen shot then click Finish button. Netbeans will automatically open the new `ProductController.java` class file. Replace all codes with this.
Package com.spring.restapi.controllers;
Import com.spring.restapi.models.Product;
import com.spring.restapi.repositories.ProductRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PathVariable;
import org .springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ProductController {
@Autowired
ProductRepository productRepository;
@RequestMapping (method=RequestMethod.GET, value= "/products" )
public Iterable<Product> product() {
return productRepository.findAll();
}
@RequestMapping (method=RequestMethod.POST, value= "/products" )
public String save( @RequestBody Product product) {
productRepository.save(product);
Return product.getId();
}
@RequestMapping (method=RequestMethod.GET, value= "/products/{id}" )
public Product show( @PathVariable String id) {
return productRepository.findOne(id);
}
@RequestMapping (method=RequestMethod.PUT, value= "/products/{id}" )
public Product update( @PathVariable String id, @RequestBody Product product) {
Product prod = productRepository.findOne(id);
If (product.getProdName () != null )
prod.setProdName(product.getProdName());
If (product.getProdDesc() != null )
prod.setProdDesc(product.getProdDesc());
If (product.getProdPrice() != null )
prod.setProdPrice(product.getProdPrice());
If(product.getProdImage() != null )
prod.setProdImage(product.getProdImage());
productRepository.save(prod);
Return prod;
}
@RequestMapping (method=RequestMethod.DELETE, value= "/products/{id}" )
public String delete ( @PathVariable String id) {
Product product = productRepository.findOne(id);
productRepository. delete (product);
Return "product deleted" ;
}
}
5.Run and Test the Spring Boot MongoDB RESTful Web Service
Let testing purpose, we use curl from terminal or command line. Let's start the server by type this command.
./gradlew bootRun
Open another terminal tab then type this command for post data to REST API.
Curl -i -X POST -H "Content-Type: application/json" -d '{ "prodName" : "Dummy Product 1" , "prodDesc" : "The Fresh Dummy Product in The world part 1" , " prodPrice" : 100 , "prodImage" : "https://dummyimage.com/600x400/000/fff" }' localhost: 8080 /products
You will see the successful response like this.
HTTP/ 1.1 200
Content-Type: text/plain;charset=UTF -8
Content-Length: 24
Date : Sun, 17 Sep 2017 10 : 14 : 39 GMT
59 be4b0fb1a2416a11a43c21
To get all product data type this command.
Curl -i -H "Accept: application/json" localhost:8080/products
You will see all data as JSON array like this.
HTTP/ 1.1 200
Content-Type: application/json;charset=UTF -8
Transfer-Encoding: chunked
Date : Sun, 17 Sep 2017 10 : 17 : 08 GMT
[{ "id" : "59be4b0fb1a2416a11a43c21" , "prodName" : " Dummy Product 1" , "prodDesc" : "The Fresh Dummy Product in The world part 1" , "prodPrice" : 100.0 , "prodImage" : "https:/ /dummyimage.com/600x400/000/fff"}]
To get single data, type this command.
Curl -i -H "Accept: application/json" localhost:8080/products/59be4b0fb1a2416a11a43c21
You will see the single object of JSON data.
HTTP/ 1.1 200
Content-Type: application/json;charset=UTF -8
Transfer-Encoding: chunked
Date : Sun, 17 Sep 2017 10 : 17 : 08 GMT
{ "id" : "59be4b0fb1a2416a11a43c21" , "prodName" : "Dummy Product 1" , "prodDesc" : "The Fresh Dummy Product in The world part 1" , "prodPrice" : 100.0 , "prodImage" : "https:// Dummyimage.com/600x400/000/fff"}
To update the specific data by ID type this command.
Curl -i -X PUT -H "Content-Type: application/json" -d '{"prodPrice":220}'
You will see this response on successful update.
HTTP/ 1.1 200
Content-Type: application/json;charset=UTF -8
Transfer-Encoding: chunked
Date : Sun, 17 Sep 2017 10 : 26 : 08 GMT
{ "id" : "59be4b0fb1a2416a11a43c21" , "prodName" : "Dummy Product 1" , "prodDesc" : "The Fresh Dummy Product in The world part 1" , "prodPrice" : 220.0 , "prodImage" : "https:// Dummyimage.com/600x400/000/fff"}
To delete specific data by ID, type this command.
Curl - i -X DELETE localhost: 8080 /products/ 59 be4b0fb1a2416a11a43c21
You will see this response if successful delete.
HTTP/ 1.1 200
Content-Type: text/plain;charset=UTF -8
Content-Length: 15
Date : Sun, 17 Sep 2017 10 : 28 : 38 GMT
Product deleted
RESOURCES:
SPRING BOOT REST
Spring official
Spring boot rest tutorial
