java如何接受json数组

Java如何接收JSON数组：从基础到实践的全面指南

在当今的软件开发中,JSON（JavaScript Object Notation）已成为数据交换的主流格式之一，Java作为企业级开发的主流语言，经常需要处理JSON格式的数据，其中JSON数组的接收是常见需求，本文将详细介绍Java中接收JSON数组的多种方法，从基础的JSON库使用到Spring框架中的集成，帮助开发者这一技能。

JSON数组简介

JSON数组是值的有序集合,用方括号[]表示，值之间用逗号分隔。

[
  {"name": "张三", "age": 25},
  {"name": "李四", "age": 30},
  {"name": "王五", "age": 28}
]

在Java中接收这样的JSON数组,通常需要将其转换为Java集合类型（如List）或数组。

使用Jackson库接收JSON数组

Jackson是Java中最流行的JSON处理库之一,Spring框架默认使用它进行JSON处理。

添加依赖

在Maven项目的pom.xml中添加Jackson依赖：

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

基本使用

假设有以下JSON数组字符串：

String jsonArrayString = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";

使用Jackson将其转换为List<Map>：

ObjectMapper objectMapper = new ObjectMapper();
List<Map<String, Object>> list = objectMapper.readValue(jsonArrayString, 
    new TypeReference<List<Map<String, Object>>>() {});
// 遍历结果
list.forEach(map -> System.out.println(map));

转换为自定义对象列表

如果JSON数组中的对象结构固定,可以定义对应的Java类，然后直接转换为对象列表：

// 定义Person类
public class Person {
    private String name;
    private int age;
    // getters and setters
}
// 转换
List<Person> personList = objectMapper.readValue(jsonArrayString, 
    new TypeReference<List<Person>>() {});

使用Gson库接收JSON数组

Google的Gson是另一个流行的JSON处理库。

添加依赖

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.9</version>
</dependency>

基本使用

Gson gson = new Gson();
String jsonArrayString = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
// 转换为List<Map>
List<Map<String, Object>> list = gson.fromJson(jsonArrayString, 
    new TypeToken<List<Map<String, Object>>>() {}.getType());
// 转换为自定义对象列表
List<Person> personList = gson.fromJson(jsonArrayString, 
    new TypeToken<List<Person>>() {}.getType());

使用org.json库接收JSON数组

这是一个轻量级的JSON处理库。

添加依赖

<dependency>
    <groupId>org.json</groupId>
    <artifactId>json</artifactId>
    <version>20220320</version>
</dependency>

基本使用

String jsonArrayString = "[{\"name\":\"张三\",\"age\":25},{\"name\":\"李四\",\"age\":30}]";
JSONArray jsonArray = new JSONArray(jsonArrayString);
// 遍历JSONArray
for (int i = 0; i < jsonArray.length(); i++) {
    JSONObject jsonObject = jsonArray.getJSONObject(i);
    String name = jsonObject.getString("name");
    int age = jsonObject.getInt("age");
    System.out.println(name + ": " + age);
}

Spring Boot中接收JSON数组

在Spring Boot应用中，控制器可以直接接收JSON数组参数。

使用@RequestBody注解

@RestController
@RequestMapping("/api")
public class PersonController {
    @PostMapping("/persons")
    public String savePersons(@RequestBody List<Person> persons) {
        // 处理接收到的Person列表
        persons.forEach(person -> System.out.println(person));
        return "Received " + persons.size() + " persons";
    }
}

发送请求

可以使用Postman或curl发送POST请求：

curl -X POST http://localhost:8080/api/persons \
-H "Content-Type: application/json" \
-d '[{"name":"张三","age":25},{"name":"李四","age":30}]'

处理复杂JSON数组

对于嵌套的JSON数组,需要定义相应的嵌套类结构。

[
  {
    "name": "项目1",
    "tasks": [
      {"title": "任务1", "completed": true},
      {"title": "任务2", "completed": false}
    ]
  }
]

对应的Java类：

public class Task {
    private String title;
    private boolean completed;
    // getters and setters
}
public class Project {
    private String name;
    private List<Task> tasks;
    // getters and setters
}

然后使用ObjectMapper或Gson进行转换：

String complexJsonArray = "[{\"name\":\"项目1\",\"tasks\":[{\"title\":\"任务1\",\"completed\":true}]}]";
List<Project> projects = objectMapper.readValue(complexJsonArray, 
    new TypeReference<List<Project>>() {});

常见问题与解决方案

日期处理：JSON中的日期可能需要特殊处理，可以使用@JsonFormat注解：
```
@JsonFormat(pattern = "yyyy-MM-dd")
private Date birthDate;
```
循环引用：对象间可能存在循环引用，可以配置ObjectMapper忽略：
```
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
```
性能优化：对于大量JSON数据，考虑使用JsonParser进行流式处理。