Spring - REST JSON Response

In Spring, a REST JSON response is used to send data from the server to the client in JSON (JavaScript Object Notation) format. Spring simplifies this process by automatically converting Java objects into JSON using Jackson when building RESTful web services.

The diagram illustrates how a client communicates with a Spring REST API by sending requests and receiving JSON responses.

Prerequisites

The prerequisites required are as follows: 

• Basic knowledge of Spring Boot and REST APIs.
• A Spring Boot project set up with Maven or Gradle.
• Familiarity with JSON and its structure.

JSON

JSON stands for JavaScript Object Notation. It is a text-based data format used to exchange data between a server and a client. Although derived from JavaScript syntax, JSON is language-independent and supported by most programming languages.

Example: JSON Object

{
"id": 07,
"framework": "Spring",
"API": "REST API",
"Response JSON": true
}

Example: JSON Array

[
{
"id": 07,
"name": "darshan"
},
{
"id": 08,
"name": "geek"
}
]

Setting Up the Spring Boot Project

Step 1: Project Structure

The project structure for the application is as follow:

Step 2: Verify pom.xml

Spring Initializr automatically adds required dependencies. Make sure spring-boot-starter-web is present:

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

This dependency also includes Jackson for JSON conversion.

pom.xml:

Step 3: Bootstrapping the Spring Application

Create the main application class to bootstrap the Spring Boot application.

GfgJsonRestResponseApplication.java:

Step 4: Creating the Domain Bean

The domain bean defines the structure of the JSON response.

Steps

• Create a class DomainBean
• Use Lombok to automatically generate getters and setters.

Maven Dependency:

Dependency is as depicted below as follows:

<dependency>

<groupId>org.projectlombok</groupId>

<artifactId>lombok</artifactId>

<optional>true</optional>

</dependency>

DomainBean.java:

Spring automatically converts this Java object into JSON.

Step 5: Implementing the REST Controller

The REST controller handles incoming requests and sends JSON responses. Key annotations used include @RestController, @RequestMapping, and @GetMapping.

Important Annotations Used

RestJsonResponse.java:

This class provides RESTful services.

Outputs:

REST API's JSON response can be consumed by:

• Spring application itself.
• Front-end application/framework

Consuming REST API in a Spring Application

Spring provides RestTemplate for consuming REST APIs.

ConsumeResponse.java ( Consume REST API response ):

A normal Spring controller is used to retrieve the responses from the RestTemplate method and returns a view.

Displaying Response Using Thymeleaf

ResponseController.java ( Regular Controller ):

Output.html (output of API: Thymeleaf template):

Output:

Front-end Application/Framework - Angular

consume-json.component.ts (Angular component):

• This component retrieves the JSON data from the specified URL targeting REST API.
• Retrieved data is stored in a variable.

import { Component, OnInit, Injectable } from '@angular/core';

import { HttpClient } from '@angular/common/http';

@Component({

selector: 'app-consume-json',

templateUrl: './consume-json.component.html',

styleUrls: ['./consume-json.component.css']

})

export class ConsumeJsonComponent implements OnInit {

restData : any;

constructor(private http:HttpClient) { }

ngOnInit() {

this.http.get('http://localhost:8080/JSON/data')

.subscribe(data => this.restData = data);

}

}

consume-json.component.html (view of component):

• Get the stored data by dot( . ) notation.
• 'ngFor' is an Angular template directive used for iterating through the collection of objects.

consume-json.component.css (Style file):

Add - '<app-consume-json></app-consume-json>' in the 'app.component.html' file

Output:

Note: spring-boot-starter-web already includes:

• jackson-databind
• jackson-core
• jackson-annotations

Spring Boot automatically converts Java objects into JSON.