安卓手机怎么提取json集合值

安卓手机如何高效提取JSON集合值？实用方法与代码示例详解

在安卓开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于前后端数据交互，无论是从API接口获取数据，还是解析本地存储的配置文件，经常需要从JSON集合（如数组、对象列表）中提取特定值，本文将详细介绍安卓手机中提取JSON集合值的多种方法，包括原生代码实现和第三方库使用,帮助开发者高效处理JSON数据。

安卓JSON解析的基础：核心类与数据结构

在安卓开发中，处理JSON主要依赖两种核心类：JSONObject和JSONArray，它们位于org.json包中（安卓SDK自带，无需额外依赖）。

JSONObject：表示JSON对象，类似于Java中的Map，以键值对（key-value）形式存储数据，如{"name":"张三", "age":18}。
JSONArray：表示JSON数组，类似于Java中的List，按顺序存储值，值可以是String、Number、JSONObject等，如[{"name":"张三"}, {"name":"李四"}]。

提取JSON集合值的关键，就是通过遍历JSONArray或解析JSONObject中的嵌套结构,定位目标数据。

原生方法提取JSON集合值（无需第三方库）

安卓原生org.json包提供了完整的JSON解析能力，适合处理简单的JSON数据,以下是具体步骤和示例代码。

解析JSON数组（JSONArray）

假设从服务器获取的JSON数据是一个用户数组：

[
  {"id":1, "name":"张三", "hobbies":["篮球", "编程"]},
  {"id":2, "name":"李四", "hobbies":["音乐", "阅读"]}
]

目标是提取所有用户的name和hobbies。

步骤：

将JSON字符串转换为JSONArray对象；
遍历JSONArray，逐个取出每个用户对应的JSONObject；
从每个JSONObject中通过键（如"name"）获取值。

代码示例：

import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
import java.util.ArrayList;
import java.util.List;
public class JsonParser {
    public static List<String> extractUserNames(String jsonString) throws JSONException {
        List<String> names = new ArrayList<>();
        // 1. 将JSON字符串转换为JSONArray
        JSONArray jsonArray = new JSONArray(jsonString);
        // 2. 遍历JSONArray
        for (int i = 0; i < jsonArray.length(); i++) {
            // 3. 获取每个用户对应的JSONObject
            JSONObject userObject = jsonArray.getJSONObject(i);
            // 4. 通过键"name"获取用户名
            String name = userObject.getString("name");
            names.add(name);
        }
        return names;
    }
    public static List<String> extractAllHobbies(String jsonString) throws JSONException {
        List<String> allHobbies = new ArrayList<>();
        JSONArray jsonArray = new JSONArray(jsonString);
        for (int i = 0; i < jsonArray.length(); i++) {
            JSONObject userObject = jsonArray.getJSONObject(i);
            // 获取hobbies对应的JSONArray
            JSONArray hobbiesArray = userObject.getJSONArray("hobbies");
            // 遍历hobbies数组，添加到结果列表
            for (int j = 0; j < hobbiesArray.length(); j++) {
                String hobby = hobbiesArray.getString(j);
                allHobbies.add(hobby);
            }
        }
        return allHobbies;
    }
    public static void main(String[] args) {
        String jsonStr = "[\n" +
                "  {\"id\":1, \"name\":\"张三\", \"hobbies\":[\"篮球\", \"编程\"]},\n" +
                "  {\"id\":2, \"name\":\"李四\", \"hobbies\":[\"音乐\", \"阅读\"]}\n" +
                "]";
        try {
            // 提取所有用户名
            List<String> names = extractUserNames(jsonStr);
            System.out.println("用户名列表：" + names); // 输出：[张三, 李四]
            // 提取所有爱好
            List<String> hobbies = extractAllHobbies(jsonStr);
            System.out.println("所有爱好：" + hobbies); // 输出：[篮球, 编程, 音乐, 阅读]
        } catch (JSONException e) {
            e.printStackTrace();
        }
    }
}

解析嵌套JSON集合

如果JSON数据存在多层嵌套（如对象中嵌套数组，或数组中嵌套对象），只需逐层解析即可。

{
  "class":"高三(1)班",
  "students":[
    {"id":1, "name":"张三", "scores":{"math":95, "english":88}},
    {"id":2, "name":"李四", "scores":{"math":87, "english":92}}
  ]
}

目标是提取所有学生的name和math成绩。

代码示例：

public static List<String> extractStudentScores(String jsonString) throws JSONException {
    List<String> results = new ArrayList<>();
    JSONObject classObject = new JSONObject(jsonString); // 最外层JSONObject
    JSONArray studentsArray = classObject.getJSONArray("students"); // 获取students数组
    for (int i = 0; i < studentsArray.length(); i++) {
        JSONObject student = studentsArray.getJSONObject(i);
        String name = student.getString("name");
        // 解析嵌套的scores对象
        JSONObject scores = student.getJSONObject("scores");
        int mathScore = scores.getInt("math");
        results.add(name + "的数学成绩：" + mathScore);
    }
    return results;
}
// 调用示例
String jsonStr = "{\"class\":\"高三(1)班\",\"\n" +
        "  \"students\":[\n" +
        "    {\"id\":1, \"name\":\"张三\", \"scores\":{\"math\":95, \"english\":88}},\n" +
        "    {\"id\":2, \"name\":\"李四\", \"scores\":{\"math\":87, \"english\":92}}\n" +
        "  ]\n" +
        "}";
List<String> scoreResults = extractStudentScores(jsonStr);
System.out.println(scoreResults); 
// 输出：[张三的数学成绩：95, 李四的数学成绩：87]

原生方法的注意事项

异常处理：JSON解析过程中可能出现格式错误（如缺少引号、括号不匹配），需用try-catch捕获JSONException。
数据类型匹配：调用getString()、getInt()等方法时，需确保JSON中的值类型与Java方法参数类型一致，否则会抛出异常。
性能问题：对于大型JSON数据（如超过1MB），原生org.json的解析效率可能较低，建议使用第三方库（如Gson、Jackson）。

使用第三方库提取JSON集合值（更高效便捷）

原生org.json功能基础，但在处理复杂数据结构或需要对象映射时，代码较为繁琐，第三方库如Gson（Google）、Jackson、**Moshi`等提供了更强大的功能，支持直接将JSON转换为Java对象（反序列化）,极大简化开发。

使用Gson库提取JSON集合值

（1）添加Gson依赖

在app/build.gradle文件中添加：

implementation 'com.google.code.gson:gson:2.10.1'

（2）定义Java模型类

根据JSON结构定义对应的Java类，例如针对前面的用户数组：

// 用户爱好类（对应"hobbies"数组）
public class Hobby {
    private String hobby;
    public Hobby(String hobby) {
        this.hobby = hobby;
    }
    public String getHobby() {
        return hobby;
    }
    @Override
    public String toString() {
        return hobby;
    }
}
// 用户类（对应单个用户对象）
public class User {
    private int id;
    private String name;
    private List<Hobby> hobbies;
    // 必须提供无参构造方法（Gson反射需要）
    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 List<Hobby> getHobbies() {
        return hobbies;
    }
    public void setHobbies(List<Hobby> hobbies) {
        this.hobbies = hobbies;
    }
}

（3）使用Gson解析JSON

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.ArrayList;
import java.util.List;
public class GsonJsonParser {
    public static List<String> extractUserNamesWithGson(String jsonString) {
        Gson gson = new Gson();
        // 将JSON字符串