@PostMapping for POST requests in Spring Boot

Introduction

@PostMapping helps your Spring Boot app listen for POST requests easily. It connects a web address to a method that handles data sent by users.

When a user submits a form with data to save or process.

When you want to create a new record in a database via a web request.

When your app needs to receive JSON data from a client.

When you want to handle file uploads from a web page.

When you want to trigger an action that changes data on the server.

Syntax

Spring Boot

@PostMapping("/path")
public ReturnType methodName(@RequestBody DataType data) {
    // handle POST request
}

The string inside @PostMapping("/path") is the URL path this method listens to.

@RequestBody tells Spring to convert the incoming data (like JSON) into a Java object.

Examples

Handles POST requests to /submit and returns a confirmation message with the received data.

Spring Boot

@PostMapping("/submit")
public String submitData(@RequestBody String data) {
    return "Received: " + data;
}

Receives a User object in JSON, saves it, and returns the saved user.

Spring Boot

@PostMapping("/users")
public User createUser(@RequestBody User user) {
    // save user to database
    return user;
}

Sample Program

This Spring Boot controller listens for POST requests at /greet. It expects a plain text name in the request body and responds with a greeting message.

Spring Boot

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class GreetingController {

    @PostMapping("/greet")
    public String greetUser(@RequestBody String name) {
        return "Hello, " + name + "!";
    }
}

Important Notes

Always use @RequestBody to get data from the POST request body.

Make sure your client sends data in the correct format (like JSON or plain text) matching your method parameter.

Use @RestController to make your class ready to handle web requests and return responses directly.

Summary

@PostMapping connects a URL path to a method that handles POST requests.

Use it when you want to receive and process data sent by users or clients.

Remember to use @RequestBody to get the data from the request body.

Practice

1. What is the main purpose of the @PostMapping annotation in Spring Boot?

easy

A. To map HTTP PUT requests to a specific method

B. To map HTTP POST requests to a specific method

C. To map HTTP DELETE requests to a specific method

D. To map HTTP GET requests to a specific method

Solution

1. Step 1: Understand HTTP methods

   HTTP POST is used to send data to the server, so a method handling POST requests must be mapped accordingly.

2. Step 2: Role of @PostMapping

   @PostMapping specifically maps HTTP POST requests to a method in a Spring Boot controller.

3. Final Answer:

   To map HTTP POST requests to a specific method -> Option B

4. Quick Check:

   @PostMapping = POST request handler [OK]

Hint: POST requests use @PostMapping to connect URL and method [OK]

Common Mistakes:

• Confusing @PostMapping with @GetMapping
• Using @PostMapping for GET requests
• Not understanding HTTP method differences

2. Which of the following is the correct syntax to create a POST endpoint in Spring Boot that accepts JSON data?

easy

A. @PostMapping("/submit")
public String submitData(String data) { return "Received"; }

B. @GetMapping("/submit")
public String submitData(@RequestBody String data) { return "Received"; }

C. @PostMapping("/submit")
public String submitData(@RequestBody String data) { return "Received"; }

D. @PostMapping("/submit")
public String submitData(@RequestParam String data) { return "Received"; }

Solution

1. Step 1: Identify correct annotation and parameter

   The method must use @PostMapping to handle POST requests and @RequestBody to receive JSON data from the request body.

2. Step 2: Check each option

   @PostMapping("/submit") public String submitData(@RequestBody String data) { return "Received"; } uses @PostMapping and @RequestBody correctly. @GetMapping("/submit") public String submitData(@RequestBody String data) { return "Received"; } uses @GetMapping which is wrong. @PostMapping("/submit") public String submitData(String data) { return "Received"; } misses @RequestBody, so data won't be parsed from JSON. @PostMapping("/submit") public String submitData(@RequestParam String data) { return "Received"; } uses @RequestParam which reads query parameters, not JSON body.

3. Final Answer:

   @PostMapping("/submit") public String submitData(@RequestBody String data) { return "Received"; } -> Option C

4. Quick Check:

   @PostMapping + @RequestBody = correct syntax [OK]

Hint: Use @RequestBody to get JSON data in POST method [OK]

Common Mistakes:

• Using @GetMapping instead of @PostMapping
• Forgetting @RequestBody for JSON input
• Using @RequestParam for JSON body data

3. Given the following Spring Boot controller method, what will be the output when a POST request with body "Hello" is sent to /greet? @PostMapping("/greet") public String greet(@RequestBody String name) { return "Hi, " + name + "!"; }

medium

A. "Hi, Hello!"

B. "Hello"

C. "Hi, name!"

D. HTTP 404 Not Found

Solution

1. Step 1: Understand method behavior

   The method takes the request body as a String parameter named 'name' and returns "Hi, " plus that name plus "!".

2. Step 2: Apply input to output

   Input body is "Hello", so the output will be "Hi, Hello!".

3. Final Answer:

   "Hi, Hello!" -> Option A

4. Quick Check:

   Input "Hello" returns "Hi, Hello!" [OK]

Hint: Return greeting by concatenating input string [OK]

Common Mistakes:

• Ignoring @RequestBody and expecting query param
• Confusing output with input
• Assuming endpoint is missing (404)

4. Identify the error in this Spring Boot POST method: @PostMapping("/addUser") public String addUser(String user) { return "User " + user + " added"; }

medium

A. Method return type should be void

B. Incorrect HTTP method annotation, should be @GetMapping

C. Missing @PathVariable annotation

D. Missing @RequestBody annotation for 'user' parameter

Solution

1. Step 1: Check parameter binding

   The method expects to receive data in the POST request body, so the parameter must be annotated with @RequestBody to bind JSON or raw data.

2. Step 2: Verify annotations

   Without @RequestBody, Spring won't map the request body to the 'user' parameter, causing it to be null or empty.

3. Final Answer:

   Missing @RequestBody annotation for 'user' parameter -> Option D

4. Quick Check:

   POST body needs @RequestBody on parameter [OK]

Hint: Add @RequestBody to method parameter for POST data [OK]

Common Mistakes:

• Forgetting @RequestBody on POST method parameters
• Using @GetMapping for POST endpoints
• Confusing @PathVariable with request body

5. You want to create a Spring Boot POST endpoint /register that accepts a JSON object with fields username and email, maps it to a Java record UserData(String username, String email), and returns a confirmation message. Which method signature correctly implements this?

hard

A. @PostMapping("/register")
public String registerUser(@RequestBody UserData user) {
return "User " + user.username() + " registered with email " + user.email();
}

B. @PostMapping("/register")
public String registerUser(UserData user) {
return "User " + user.username() + " registered";
}

C. @PostMapping("/register")
public String registerUser(@RequestParam UserData user) {
return "User " + user.username() + " registered";
}

D. @PostMapping("/register")
public String registerUser(@PathVariable UserData user) {
return "User " + user.username() + " registered";
}

Solution

1. Step 1: Understand data binding for POST JSON

   To map JSON request body to a Java record, the parameter must be annotated with @RequestBody.

2. Step 2: Check each option

   @PostMapping("/register") public String registerUser(@RequestBody UserData user) { return "User " + user.username() + " registered with email " + user.email(); } correctly uses @RequestBody with UserData record and accesses its fields. @PostMapping("/register") public String registerUser(UserData user) { return "User " + user.username() + " registered"; } misses @RequestBody, so mapping fails. Options C and D use @RequestParam and @PathVariable which are for query/path parameters, not JSON body.

3. Final Answer:

   @PostMapping("/register") public String registerUser(@RequestBody UserData user) { return "User " + user.username() + " registered with email " + user.email(); } -> Option A

4. Quick Check:

   @RequestBody + record parameter = correct POST JSON mapping [OK]

Hint: Use @RequestBody with record to map JSON POST data [OK]

Common Mistakes:

• Omitting @RequestBody on complex objects
• Using @RequestParam or @PathVariable for JSON body
• Not accessing record fields correctly