当前位置：首页 > article >正文

【JavaEE】快速上手JSON：构建高效 Java 后端数据桥梁，开启交互新篇，以 @RequestBody 为引的探索之旅

article 2025/3/17 7:21:29

1.接收Json数据@RequestBody

如果对Json不了解，可以看2，3，4，5章。

接收Json数据需要使用注解@RequestBody

RequestBody: 请求正⽂，意思是这个注解作⽤在请求正⽂的数据绑定，请求参数必须在写在请求正⽂中。

后端实现：

//   User 类
public class User {

    private String name;
    private Integer age;
    private String sex;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", sex='" + sex + '\'' +
                '}';
    }
}

@RequestMapping("/basic")
@Controller
public class BasicController {

    // http://127.0.0.1:8080/hello?name=lisi
    @RequestMapping("/user")
    @ResponseBody
    public String user(@RequestBody User user) // @RequeatParam注解
    {
        return "接收到的参数user是：" + user.toString();
    }

}

运行后，在Postman工具中传参Json数据：
在这里插入图片描述

2.Json的概念

JSON：JavaScript Object Notation 【JavaScript 对象表⽰法】

JSON是⼀种轻量级的数据交互格式。它基于 ECMAScript (欧洲计算机协会制定的js规范)的⼀个⼦集，采⽤完全独⽴于编程语⾔的⽂本格式来存储和表⽰数据。

简单来说：JSON就是⼀种数据格式, 有⾃⼰的格式和语法, 使⽤⽂本表⽰⼀个对象或数组的信息, 因此 JSON本质是字符串。主要负责在不同的语⾔中数据传递和交换。

类似于：
• 国际通⽤语⾔-英语
• 中国56个⺠族不同地区的通⽤语⾔-普通话有⾃⼰的语法, 其他语⾔也认识。

JSON与Javascript的关系
没有关系, 只是语法相似。 js开发者能更快的上⼿⽽已, 但是他的语法本⾝⽐较简单, 所以也很好学

3.Json语法

JSON 是⼀个字符串，其格式⾮常类似于 JavaScript 对象字⾯量的格式我们先来看⼀段JSON数据：

{
	"squadName": "Super hero squad",
	"homeTown": "Metro City",
	"formed": 2016,
	"secretBase": "Super tower",
	"active": true,
	"members": [{
			"name": "Molecule Man",
			"age": 29,
			"secretIdentity": "Dan Jukes",
			"powers": ["Radiation resistance", "Turning tiny", "Radiation blast "]
		},
		{
			"name": "Madame Uppercut",
			"age": 39,
			"secretIdentity": "Jane Wilson",
			"powers": ["Million tonne punch", "Damage resistance", "Superhuman reflexes "]
		},
		{
			"name": "Eternal Flame",
			"age": 1000000,
			"secretIdentity": "Unknown",
			"powers": ["Immortality", "Heat Immunity", "Inferno",
				"Teleportation", "Interdimensional travel"
			]
		}
	]
}

上述代码也可以压缩表示：

{"squadName":"Super hero squad","homeTown":"Metro City","formed":2016,"secretBase":"Super tower","active":true,"members":[{"name":"Molecule Man","age":29,"secretIdentity":"Dan Jukes","powers":["Radiation resistance","Turning tiny","Radiation blast "]},{"name":"Madame Uppercut","age":39,"secretIdentity":"Jane Wilson","powers":["Million tonne punch","Damage resistance","Superhuman reflexes "]},{"name":"Eternal Flame","age":1000000,"secretIdentity":"Unknown","powers":["Immortality","Heat Immunity","Inferno","Teleportation","Interdimensional travel"]}]}

上⾯描述和第一个的数据⼀样, 只不过第一个数据进⾏了格式化, 更易读。

JSON的语法:
1.数据在键值对（Key/Value）中
2.数据由逗号（,）分割
3.对象⽤大括号（{}）表示
4.数组⽤（[]）表示
5.值可以为对象, 也可以为数组, 数组中可以包含多个对象

JSON的两种结构：

对象: ⼤括号{}保存的对象是⼀个⽆序的键值对集合。⼀个对象以左括号{ 开始，}右括号结束。每个"键"后跟⼀个冒号:，键值对使⽤逗号,分隔
```
{"name": "Molecule Man","age": 29,"secretIdentity": "Dan Jukes"}
```
数组: 中括号 []保存的数组是值（value）的有序集合。⼀个数组以左中括号[开始，]右括号结束，值之间使⽤逗号分隔。
```
["Million tonne punch", "Damage resistance", "Superhuman reflexes "]
```

在这里插入图片描述
所以, 以下都是合法的JSON数据：

{"name":"admin","age":18}
["hello", 3.1415, "json"]
[{"name":"admin","age":18},{"name":"root","age":16},{"name":"张三","age":20}]

可以使⽤在线JSON格式化⼯具来进⾏校验和书写: 在线JSON校验格式化⼯具（Be JSON）

4.JSON字符串和Java对象互转

JSON本质上是⼀个字符串, 通过⽂本来存储和描述数据。

Spring MVC框架也集成了JSON的转换⼯具, 我们可以直接使⽤, 来完成JSON字符串和Java对象的互转。本质上是jackson-databind提供的功能, Spring MVC框架中已经把该⼯具包引⼊了进来, 咱们直接使⽤即可, 如果脱离Spring MVC使⽤, 需要引⼊相关依赖：

<dependency>
	<groupId>com.fasterxml.jackson.core</groupId>
	<artifactId>jackson-databind</artifactId>
	<version>2.13.5</version>
</dependency>

JSON的转换⼯具包有很多, jackson-databind只是其中的⼀种.

public class JSONUtils {
	private static ObjectMapper objectMapper = new ObjectMapper(); 3
	public static void main(String[] args) throws JsonProcessingException {
		Person person = new Person();
		person.setId(5);
		person.setName("zhangsan");
		person.setPassword("123456");
		//对象转为JSON字符串
		String jsonStr = objectMapper.writeValueAsString(person);
		System.out.println("JSON字符串为:"+jsonStr);
		//JSON字符串转为对象
		Person p = objectMapper.readValue(jsonStr,Person.class);
		System.out.println("转换的对象
		id:"+p.getId()+",name:"+p.getName()+",password:"+p.getPassword());
	}
 }