在Java和Android开发中，JSON格式是前后端交互最常用的数据格式之一，其中JSONArray作为存储多个JSON对象的数组结构，经常出现在接口返回的数据中，掌握其解析与筛选方法是开发者的必备技能。
JSONArray基础认知
JSONArray本质上是一个有序的值集合，内部可以存放JSONObject、字符串、数字、布尔值等多种类型的数据，结构示例如下：
[
{"id":1,"name":"张三","age":20,"score":85},
{"id":2,"name":"李四","age":22,"score":90},
{"id":3,"name":"王五","age":20,"score":78}
]
原生org.json库解析JSONArray
Java和Android原生都提供了org.json库，无需额外引入依赖即可使用，下面是基础解析示例：
基础解析步骤
首先需要将JSON字符串转换为JSONArray对象，再遍历取出每个元素：
import org.json.JSONArray;
import org.json.JSONObject;
public class JsonArrayParseDemo {
public static void main(String[] args) {
// 模拟接口返回的JSONArray字符串
String jsonStr = "[{"id":1,"name":"张三","age":20,"score":85}," +
"{"id":2,"name":"李四","age":22,"score":90}," +
"{"id":3,"name":"王五","age":20,"score":78}]";
try {
// 将字符串转换为JSONArray对象
JSONArray jsonArray = new JSONArray(jsonStr);
// 遍历JSONArray
for (int i = 0; i < jsonArray.length(); i++) {
// 获取每个位置的JSONObject
JSONObject item = jsonArray.getJSONObject(i);
int id = item.getInt("id");
String name = item.getString("name");
int age = item.getInt("age");
int score = item.getInt("score");
System.out.println("id:" + id + ",name:" + name + ",age:" + age + ",score:" + score);
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
数据筛选实现
如果需要筛选出符合条件的数据，比如筛选年龄等于20岁的用户，可以在遍历过程中添加判断逻辑：
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.ArrayList;
import java.util.List;
public class JsonArrayFilterDemo {
public static void main(String[] args) {
String jsonStr = "[{"id":1,"name":"张三","age":20,"score":85}," +
"{"id":2,"name":"李四","age":22,"score":90}," +
"{"id":3,"name":"王五","age":20,"score":78}]";
try {
JSONArray jsonArray = new JSONArray(jsonStr);
// 存储筛选后的结果
List<JSONObject> filterList = new ArrayList<>();
for (int i = 0; i < jsonArray.length(); i++) {
JSONObject item = jsonArray.getJSONObject(i);
int age = item.getInt("age");
// 筛选年龄等于20的数据
if (age == 20) {
filterList.add(item);
}
}
System.out.println("筛选后符合条件的数量：" + filterList.size());
for (JSONObject obj : filterList) {
System.out.println("筛选结果：" + obj.toString());
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
使用Gson库解析与筛选JSONArray
Gson是Google推出的JSON处理库，相比原生库使用更简洁，需要先引入依赖，Android项目可以在build.gradle中添加：
implementation 'com.google.code.gson:gson:2.10.1'
定义实体类
首先定义对应的实体类，用于映射JSONArray中的每个对象：
public class User {
private int id;
private String name;
private int age;
private int score;
// 必须提供无参构造方法
public User() {
}
// getter和setter方法
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public int getScore() {
return score;
}
public void setScore(int score) {
this.score = score;
}
}
解析与筛选操作
使用Gson可以直接将JSONArray转换为实体类集合，再配合Stream API（Java8及以上）完成筛选：
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;
import java.util.stream.Collectors;
public class GsonParseDemo {
public static void main(String[] args) {
String jsonStr = "[{"id":1,"name":"张三","age":20,"score":85}," +
"{"id":2,"name":"李四","age":22,"score":90}," +
"{"id":3,"name":"王五","age":20,"score":78}]";
Gson gson = new Gson();
// 定义类型，转换为List<User>
Type userListType = new TypeToken<List<User>>(){}.getType();
List<User> userList = gson.fromJson(jsonStr, userListType);
// 筛选年龄等于20且分数大于80的用户
List<User> filterUsers = userList.stream()
.filter(user -> user.getAge() == 20 && user.getScore() > 80)
.collect(Collectors.toList());
System.out.println("Gson筛选后结果数量：" + filterUsers.size());
for (User user : filterUsers) {
System.out.println("用户姓名：" + user.getName() + "，分数：" + user.getScore());
}
}
}
注意事项
- 解析JSON数据时一定要做好异常处理，避免JSON格式错误导致应用崩溃
- 使用原生库获取值时，如果key不存在会抛出异常，建议先使用
has("key")方法判断是否存在该字段 - Android开发中如果JSON数据量较大，解析操作建议放在子线程执行，避免阻塞主线程
- 使用Gson时实体类的字段名需要和JSON中的key一致，如果不一致可以使用
@SerializedName注解映射
常见问题解答
JSONArray中嵌套JSONArray怎么解析
如果JSONArray内部还包含JSONArray，可以先获取外层JSONArray，再通过getJSONArray("key")方法获取内层的JSONArray，继续遍历即可，示例：
import org.json.JSONArray;
import org.json.JSONObject;
public class NestedJsonArrayDemo {
public static void main(String[] args) {
String jsonStr = "[{"id":1,"name":"张三","hobbies":["篮球","足球"]}," +
"{"id":2,"name":"李四","hobbies":["跑步","游泳"]}]";
try {
JSONArray jsonArray = new JSONArray(jsonStr);
for (int i = 0; i < jsonArray.length(); i++) {
JSONObject item = jsonArray.getJSONObject(i);
String name = item.getString("name");
JSONArray hobbiesArray = item.getJSONArray("hobbies");
System.out.print(name + "的爱好：");
for (int j = 0; j < hobbiesArray.length(); j++) {
System.out.print(hobbiesArray.getString(j) + " ");
}
System.out.println();
}
} catch (Exception e) {
e.printStackTrace();
}
}
}
筛选时如何处理空值
筛选前可以先判断字段是否为空，比如使用原生库时先判断item.isNull("age")，避免空指针异常，使用Gson时实体类字段可以用包装类型如Integer代替基本类型int，方便判断空值。