Spring - REST Controller

A REST Controller in Spring Boot is a class annotated with @RestController that processes incoming HTTP requests and returns data objects rather than views.

• It combines the functionality of @Controller and @ResponseBody.
• It is primarily used for building RESTful APIs.
• The response is automatically converted to JSON or XML using message converters.

@RestController Annotation

The @RestController annotation is used to define a class as a RESTful web controller in Spring.

• It marks the class as a controller where every method returns data instead of a view.
• It is a combination of @Controller and @ResponseBody.
• It automatically converts Java objects returned from methods into JSON or XML responses.

Example:

Explanation

• @RestController tells Spring that this class will handle REST API requests.
• @GetMapping("/hello") maps the HTTP GET request to the method.
• The method returns a String, which Spring sends directly to the client as the response.

@Controller vs @ResponseBody.

Step-by-Step Implementation

Step 1: Create a Spring Boot Project

Use Spring Initializr to generate a new Spring Boot project.

Project Configuration:

• Project Type: Maven
• Language: Java
• Spring Boot Version: 3.x (Latest Version)
• Dependencies: Spring Web
• Java Version: 17+

Click on Generate, which will download the starter project.

Step 2: Import the Project in IDE

• Open IntelliJ IDEA (or Eclipse/STS).
• Go to File -> New -> Project from Existing Sources and select pom.xml.
• Wait for Maven to download dependencies.

Note:

In the Import Project for Maven window, make sure you choose the same version of JDK which you selected while creating the project.

Step 3: Create the Model Class

Go to src -> main -> java, create a java class with the name Details.

Details.java:

Step 4: Create a REST Controller

Now create another Java class with the name Controller and add the annotation @RestController.

Controller.java:

This application is now ready to run.

Step 5: Run the Application

Run the SpringBootApplication class to start the embedded Tomcat server.

Note: The default port of the Tomcat server is 8080 and can be changed in the application.properties file.

Step 6: Test APIs using Postman

1. Add a New Detail (POST Request)

Endpoint: POST http://localhost:8080/api/details

Request Body:

{

"id": 1,

"name": "John Doe"

}

Response:

"Data Inserted Successfully"

2. Fetch All Details (GET Request)

Endpoint: GET http://localhost:8080/api/details

Response:

[

{

"id": 1,

"name": "John Doe"

}

]

3. Delete a Detail (DELETE Request)

Endpoint: DELETE http://localhost:8080/api/details/1

Response:

"Data Deleted Successfully"

To know how to use Postman, refer: How to test Rest APIs in Postman