安卓json解析数据怎么用

安卓JSON解析数据完全指南：从入门到实践

在安卓开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其可读性强、解析便捷，已成为前后端数据交互的主流选择，无论是从服务器获取用户信息、加载商品列表，还是同步配置数据，都离不开JSON解析，本文将详细介绍安卓中JSON解析的核心方法、常用工具及完整实践流程,帮助开发者快速这一关键技能。

JSON基础：在安卓中为何需要JSON？

JSON是一种键值对（Key-Value）结构的数据格式，支持两种核心结构：

• 对象（Object）：用 表示，键值对以 key: value 形式存储，如 {"name": "张三", "age": 25}。
• 数组（Array）：用 [] 表示，多个值按顺序排列，如 ["苹果", "香蕉", "橙子"]。

在安卓中，客户端与服务器通信时，服务器通常以JSON格式返回数据（如API响应），客户端需要解析JSON，将其转换为安卓可识别的对象（如Java实体类、List等）,才能在UI上展示或进行业务逻辑处理。

安卓JSON解析工具对比

安卓生态中提供了多种JSON解析工具，各有优劣，开发者可根据需求选择：

实践：三种主流工具的JSON解析详解

使用原生 org.json 解析（无需依赖）

org.json 是安卓系统内置的JSON解析库，适合处理简单JSON数据。

示例：解析JSON对象并提取数据

假设服务器返回的JSON数据为：

{
  "code": 200,
  "message": "success",
  "data": {
    "userId": 1001,
    "userName": "李四",
    "hobbies": ["篮球", "编程", "旅行"]
  }
}

解析步骤：

import org.json.JSONObject;
import org.json.JSONArray;
import java.util.ArrayList;
import java.util.List;
public class JsonParseDemo {
    public void parseJson(String jsonString) {
        try {
            // 1. 解析外层JSON对象
            JSONObject jsonObject = new JSONObject(jsonString);
            int code = jsonObject.getInt("code");
            String message = jsonObject.getString("message");
            // 2. 解析嵌套的data对象
            JSONObject dataObject = jsonObject.getJSONObject("data");
            int userId = dataObject.getInt("userId");
            String userName = dataObject.getString("userName");
            // 3. 解析hobbies数组
            JSONArray hobbiesArray = dataObject.getJSONArray("hobbies");
            List<String> hobbies = new ArrayList<>();
            for (int i = 0; i < hobbiesArray.length(); i++) {
                hobbies.add(hobbiesArray.getString(i));
            }
            // 输出结果
            System.out.println("Code: " + code);
            System.out.println("User: " + userName + ", ID: " + userId);
            System.out.println("Hobbies: " + hobbies);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

注意事项：

• 使用 getJSONObject()、getJSONArray() 等方法时，需确保键名存在，否则会抛出 JSONException。
• 数组遍历通过 length() 获取长度，用 get(index) 提取元素。

使用Gson解析（推荐：自动映射对象）

Gson是Google开发的JSON库，支持将JSON字符串直接转换为Java对象（实体类），极大简化解析逻辑。

步骤1：添加依赖（app/build.gradle）

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

步骤2：创建实体类（与JSON结构对应）

// 外层响应类
public class ApiResponse {
    private int code;
    private String message;
    private UserData data;
    // Getter & Setter
    public int getCode() { return code; }
    public void setCode(int code) { this.code = code; }
    public String getMessage() { return message; }
    public void setMessage(String message) { this.message = message; }
    public UserData getData() { return data; }
    public void setData(UserData data) { this.data = data; }
}
// 用户数据类
public class UserData {
    private int userId;
    private String userName;
    private List<String> hobbies;
    // Getter & Setter
    public int getUserId() { return userId; }
    public void setUserId(int userId) { this.userId = userId; }
    public String getUserName() { return userName; }
    public void setUserName(String userName) { this.userName = userName; }
    public List<String> getHobbies() { return hobbies; }
    public void setHobbies(List<String> hobbies) { this.hobbies = hobbies; }
}

步骤3：使用Gson解析

import com.google.gson.Gson;
public class GsonParseDemo {
    public void parseJson(String jsonString) {
        Gson gson = new Gson();
        try {
            // 直接将JSON字符串转换为ApiResponse对象
            ApiResponse response = gson.fromJson(jsonString, ApiResponse.class);
            // 提取数据
            System.out.println("Code: " + response.getCode());
            UserData user = response.getData();
            System.out.println("User: " + user.getUserName() + ", ID: " + user.getUserId());
            System.out.println("Hobbies: " + user.getHobbies());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

高级用法：解析JSON数组

若JSON是数组格式（如 [{...}, {...}]），可定义实体类List进行解析：

// 假设JSON字符串为："[{\"userId\":1001,\"userName\":\"张三\"},{\"userId\":1002,\"userName\":\"王五\"}]"
List<UserData> userList = gson.fromJson(jsonString, new TypeToken<List<UserData>>(){}.getType());

注意事项：

• 实体类的字段名需与JSON的键名一致（若不一致，可用 @SerializedName("json_key") 注解映射，如 @SerializedName("user_name") private String userName;）。
• 需为实体类提供无参构造方法（Gson反射需要）。

使用Moshi解析（Kotlin友好）

Moshi是Square公司开发的JSON库，在Kotlin项目中表现优异，支持注解和空安全。

步骤1：添加依赖

implementation("com.squareup.moshi:moshi:1.15.0")
// Kotlin代码生成插件（可选，简化注解处理）
kapt("com.squareup.moshi:moshi-kotlin-codegen:1.15.0")

步骤2：定义实体类（Kotlin）

import com.squareup.moshi.JsonClass
@JsonClass(generateAdapter = true) // 生成适配器，自动解析
data class ApiResponse(
    val code: Int,
    val message: String,
    val data: UserData
)
@JsonClass(generateAdapter = true)
data class UserData(
    val userId: Int,
    val userName: String,
    val hobbies: List<String>
)

步骤3：使用Moshi解析

import com.squareup.moshi.Moshi
class MoshiParseDemo {
    fun parseJson(jsonString: String) {
        val moshi = Moshi.Builder().build()
        val jsonAdapter = moshi.adapter(ApiResponse::class.java)
        try {
            val response = jsonAdapter.fromJson(jsonString)
            response?.let {
                println("Code: ${it.code}")
                println("User: ${it.data.userName}, ID: ${it.data.userId}")
                println("Hobbies: ${it.data.hobbies}")
            }
        } catch (e: Exception) {
            e.printStackTrace()
        }
    }
}

优势：

• 对Kotlin的 data class、nullable type 支持友好，无需额外配置。
• 性能优于Gson，适合高频解析场景。

JSON解析常见问题与解决方案

JSON键名与实体类字段名不一致

问题：JSON中的键