SpringBoot - 获取POST请求参数详解（附样例：表单数据、json、数组、对象）

最新推荐文章于 2025-04-28 17:59:37 发布

按下那个按钮

最新推荐文章于 2025-04-28 17:59:37 发布

阅读量8k

点赞数 3

CC 4.0 BY-SA版权

分类专栏： springboot笔记

本文链接：https://blog.youkuaiyun.com/TheGreatButton/article/details/107717595

springboot笔记专栏收录该内容

22 篇文章

订阅专栏

本文详细介绍了SpringBoot如何处理POST请求的各种参数，包括Form表单数据、字符串文本、JSON数据的接收方法。通过实例展示了如何使用Map、对象、数组、默认值以及处理带有前缀的参数。同时，讲解了接收Text文本数据和JSON对象转换为Bean对象的方式。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

上一篇：SpringBoot - 获取Get请求参数详解（附样例：非空、默认值、数组、对象）

一、接收 Form 表单数据

1，基本的接收方法
（1）编写hello.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<form action="/hello" enctype="multipart/form-data" method="post">
    name: <input type="text" name="name">
    age: <input type="text" name="age">
    <input type="submit">
</form>
</body>
</html>

（2）下面样例 Controller 接收 form-data 格式的 POST 数据：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestParam("name") String name,
                        @RequestParam("age") Integer age) {
        return "name：" + name + "\nage：" + age;
    }
}

（3）测试结果：
在这里插入图片描述

2，参数没有传递的情况
（1）如果没有传递参数 Controller 将会报错，这个同样有如下两种解决办法：
使用 required = false 标注参数是非必须的。
使用 defaultValue 给参数指定个默认值。

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestParam(name = "name", defaultValue = "xxx") String name,
                        @RequestParam(name = "age", required = false) Integer age) {
        return "name：" + name + "\nage：" + age;
    }
}

3，使用 map 来接收参数

（1）Controller 还可以直接使用 map 来接收所有的请求参数：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.Map;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestParam Map<String,Object> params) {
        return "name：" + params.get("name") + "\nage：" + params.get("age");
    }
}

4，接收一个数组
（1）表单中有多个同名参数，Controller 这边可以定义一个数据进行接收：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.Map;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestParam("name") String[] names) {
        String result = "";
        for(String name:names){
            result += name + "\n";
        }
        return result;
    }
}

5，使用对象来接收参数
（1）如果一个 post 请求的参数太多，我们构造一个对象来简化参数的接收方式：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(User user) {
        return "name：" + user.getName() + "\nage：" + user.getAge();
    }
}

（2）User 类的定义如下，到时可以直接将多个参数通过 getter、setter 方法注入到对象中去：

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

//用了lombok插件省去了get和set方法
@Setter
@Getter
@ToString
public class User {
    private String name;
    private Integer age;
}

（3）如果传递的参数有前缀，且前缀与接收实体类的名称相同，那么参数也是可以正常传递的。

（4）如果一个 get 请求的参数分属不同的对象，也可以使用多个对象来接收参数：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(User user, Phone phone) {
        return "name：" + user.getName() + "\nage：" + user.getAge()
                + "\nnumber：" + phone.getNumber();
    }
}

6，使用对象接收时指定参数前缀
（1）如果传递的参数有前缀，且前缀与接收实体类的名称不同相，那么参数无法正常传递：

http://localhost:8080/hello?u.name=tom&u.age=10

（2）我们可以结合 @InitBinder 解决这个问题，通过参数预处理来指定使用的前缀为 u.
除了在 Controller 里单独定义预处理方法外，我们还可以通过 @ControllerAdvice 结合 @InitBinder 来定义全局的参数预处理方法，方便各个 Controller 使用。

package com.example.demo;
 
import org.springframework.web.bind.WebDataBinder;
import org.springframework.web.bind.annotation.*;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@ModelAttribute("u") User user) {
        return "name：" + user.getName() + "\nage：" + user.getAge();
    }
 
    @InitBinder("u")
    private void initBinder(WebDataBinder binder) {
        binder.setFieldDefaultPrefix("u.");
    }
}

（3）重启程序再次发送请求，可以看到参数已经成功接收了：

二、接收字符串文本数据

（1）如果传递过来的是 Text 文本，我们可以通过 HttpServletRequest 获取输入流从而读取文本内容。

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
 
import javax.servlet.ServletInputStream;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(HttpServletRequest request) {
        ServletInputStream is = null;
        try {
            is = request.getInputStream();
            StringBuilder sb = new StringBuilder();
            byte[] buf = new byte[1024];
            int len = 0;
            while ((len = is.read(buf)) != -1) {
                sb.append(new String(buf, 0, len));
            }
            System.out.println(sb.toString());
            return "获取到的文本内容为：" + sb.toString();
        } catch (IOException e) {
            e.printStackTrace();
        } finally {
            try {
                if (is != null) {
                    is.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        return null;
    }
}

三、接收 JSON 数据

1，使用 Map 来接收数据
（1）如果把 json 作为参数传递，我们可以使用 @requestbody 接收参数，将数据转换 Map：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.Map;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestBody Map params) {
        return "name：" + params.get("name") + "\n age：" + params.get("age");
    }
}

2，使用 Bean 对象来接收数据
（1）如果把 json 作为参数传递，我们可以使用 @requestbody 接收参数，将数据直接转换成对象：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestBody User user){
        return user.getName() + " " + user.getAge();
    }
}

（2）如果传递的 JOSN 数据是一个数组也是可以的，Controller 做如下修改：

package com.example.demo;
 
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
 
import java.util.List;
 
@RestController
public class HelloController {
    @PostMapping("/hello")
    public String hello(@RequestBody List<User> users){
        String result = "";
        for(User user:users){
            result += user.getName() + " " + user.getAge() + "\n";
        }
        return result;
    }
}

参考来自：航歌