【Spring】“请求“ 之传递 JSON 数据

JSON 概念

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

JSON 就是一种数据格式，有自己的格式和语法，使用文本表示一个对象或数组的信息，因此 JSON 本质是字符串，主要负责在不同的语言中数据传递和交换

类似于：

• 国际通用语言——英语
• 中国 56 个民族不同地区的通用语言——普通话
  有自己的语法，其他语言也认识

JSON 和 JavaScript 没有关系，只是语法类似，JavaScript 开发者能更快的上手而已，但是他的语法本身比较简单，所以也很好学

---

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"]
        }
    ]
}

也可以压缩表示：

{"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"]}]}

• 和上面描述的数据一样，只不过上面进行了格式化，更易读

---

JSON 的语法

• 数据在键值对（Key/Value）中
• 数据由 , 分隔
• 对象用 {} 表示
• 数组用 [] 表示
• 值可以为对象，也可以为数组，数组中可以包含多个对象

---

JSON 的两种结构

1. 对象：大括号 {} 保存的对象是一个无序的键值对集合。一个对象以左括号 { 开始，右括号 } 结束。每个“键”后跟一个冒号 :，键值对使用逗号 , 分隔

2. 数组：中括号 [] 保存的数组是值（value）的有序集合。一个数组以左中括号 [ 开始，右中括号 ] 结束。值之间使用 , 分隔
   

所以，以下都是合法的 JSON 数据：

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

---

JSON 字符串和 Java 对象互转

JSON 本质上是一个字符串，通过文本来存储和描述数据

Spring MVC 框架也集成了 JSON 的转换工具，我们可以直接使用，来完成 JSON 字符串和 Java 对象的互转

本质上是 jackson-databind 提供的功能，Spring MVC 框架中已经把该工具包引入了进来，我们可以直接进行使用。如果脱离了 Spring MVC 使用，就需要引入相关依赖

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

• JSON 的转换工具包有很多，jackson-databind 只是其中一种

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

• 使用 ObjectMapper 对象提供的两个方法，可以完成对象和 JSON 字符串的互转
• writeValueAsString：把对象转换为 JSON 字符串
• readValue：把 JSON 字符串转换为对象

---

JSON 优点

1. 简单易用：语法简单，易于理解和编写，可以快速地进行数据交换
2. 跨平台支持：JSON 可以被多种编程语言解析和生成，可以在不同的平台和语言之间进行数据交换和传输
3. 轻量级：相较于 XML 格式，JSON 数据格式更加轻量级，传输数据时占用带宽较小，可以提高数据传输速度
4. 易于扩展：JSON 的数据结构灵活，支持嵌套对象和数组等复杂的数据结构，便于扩展和使用
5. 安全性：JSON 数据格式是一种纯文本格式，不包含可执行代码，不会执行恶意代码，因此具有较高的安全性

基于以上特点，JSON 在 Web 应用程序中被广泛使用，如前后端交互，API 接口数据传输等

---

传递 JSON 对象

接收 JSON 对象，需要使用 @RequestBody 注解

• RequestBody：请求正文，意思是这个注解作用在请求正文的数据绑定，请求参数必须写在正文中

后端实现：

@RequestMapping("/m8")  
    public Object method8(@RequestBody Person person){  
        return person.toString();  
    }  
}

使用 Postman 来发送 JSON 请求：

• 可以看到，后端正确接收了，通过 Fiddler 观察一下请求参数

---

尝试去掉 @RequestBody 试试

@RequestMapping("/m9")  
public Object method9(Person person){  
    return person.toString();  
}

请求响应结果如下：

• 后端未能成功给 Person 对象赋值