安卓怎么把json转化为对象

安卓开发指南：轻松将JSON数据转换为对象

在安卓开发中,我们经常需要从网络API、本地文件或用户输入中获取JSON格式的数据，直接在代码中操作这些字符串数据（如使用JSONObject和JSONArray手动解析）不仅繁琐，而且容易出错，代码可读性也差，最佳实践是将JSON数据自动或半自动地转换为与我们应用数据模型对应的Java或Kotlin对象。

本文将详细介绍在安卓开发中将JSON转换为对象的主流方法,从最基础的手动解析到目前最推荐的现代化方案，帮助你选择最适合你项目的技术。

为什么需要将JSON转换为对象？

将JSON字符串直接映射到应用程序中的对象（我们通常称之为“模型类”或“实体类”）有诸多好处：

代码可读性强：user.getName()远比jsonObject.getString("name")更直观、更易于理解。
类型安全：编译器可以检查类型错误，而不是在运行时才发现getInt()试图获取一个字符串而导致的崩溃。
易于维护：当JSON结构变化时，我们只需修改对应的模型类，而不需要在业务逻辑代码中大海捞针地查找所有get和put方法。
业务逻辑解耦：数据模型与UI或网络逻辑分离，使代码结构更清晰。

手动解析（不推荐，但需了解）

这是最原始的方式,使用安卓内置的org.json包，在处理非常简单的JSON或对第三方库有严格限制的极端情况下可能会用到。

示例：

假设我们有如下JSON：

{
  "name": "张三",
  "age": 30,
  "isStudent": false,
  "courses": ["数学", "物理"]
}

Java代码：

import org.json.JSONObject;
import org.json.JSONArray;
import java.util.ArrayList;
import java.util.List;
public class ManualJsonParser {
    public User parseUser(String jsonString) throws Exception {
        JSONObject jsonObject = new JSONObject(jsonString);
        User user = new User();
        user.setName(jsonObject.getString("name"));
        user.setAge(jsonObject.getInt("age"));
        user.setStudent(jsonObject.getBoolean("isStudent"));
        // 解析数组
        JSONArray coursesArray = jsonObject.getJSONArray("courses");
        List<String> courses = new ArrayList<>();
        for (int i = 0; i < coursesArray.length(); i++) {
            courses.add(coursesArray.getString(i));
        }
        user.setCourses(courses);
        return user;
    }
}
// 对应的User模型类
class User {
    private String name;
    private int age;
    private boolean isStudent;
    private List<String> courses;
    // getters and setters...
}

缺点：

代码冗长：每个字段都需要手动调用get方法。
容易出错：字段名拼写错误、类型不匹配等问题只能在运行时通过异常暴露。
处理嵌套和复杂数据结构时非常痛苦。

使用Gson（Google官方库）

Gson是Google开发的一个强大的JSON库,它可以将Java对象序列化为JSON，也可以将JSON反序列化为Java对象，这是安卓开发中非常流行和成熟的解决方案。

添加依赖

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

dependencies {
    implementation 'com.google.code.gson:gson:2.10.1' // 使用最新版本
}

创建模型类

模型类的字段名和类型必须与JSON中的键和值类型一一对应,Gson支持嵌套对象和数组。

// User.java
public class User {
    private String name;
    private int age;
    private boolean isStudent;
    private List<String> courses;
    // 必须提供一个无参构造函数，Gson在反序列化时会使用它
    public User() {
    }
    // 强烈推荐：添加getter和setter方法
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    // ... 其他getter和setter
}

进行转换

JSON字符串 -> 对象 (反序列化)

import com.google.gson.Gson;
public class GsonConverter {
    public User jsonToUser(String jsonString) {
        Gson gson = new Gson();
        User user = gson.fromJson(jsonString, User.class);
        return user;
    }
}

Gson非常智能,它会自动将JSON的键映射到对象的属性名，如果JSON键和Java属性名不一致，可以使用@SerializedName注解来解决：

public class User {
    @SerializedName("user_name") // 对应JSON中的 "user_name"
    private String name;
    // ...
}

对象 -> JSON字符串 (序列化)

User user = new User();
user.setName("李四");
user.setAge(25);
Gson gson = new Gson();
String jsonString = gson.toJson(user);
// jsonString 结果: {"name":"李四","age":25,"isStudent":false,"courses":[]}

使用Moshi（Square出品，现代之选）

Moshi是Square公司（也是Retrofit和OkHttp的创造者）推出的JSON库，被认为是Gson的现代替代品，它完全使用Kotlin和Java注解API构建，性能更好，并且对Kotlin的支持尤其出色。

添加依赖

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

dependencies {
    implementation "com.squareup.moshi:moshi:1.15.0" // 使用最新版本
    // 如果需要Kotlin代码生成功能（推荐）
    kapt "com.squareup.moshi:moshi-kotlin-codegen:1.15.0"
}

创建模型类

Moshi通常与Kotlin的data class完美结合，使用@Json注解处理命名不一致问题。

Kotlin代码示例：

import com.squareup.moshi.Json
data class User(
    @Json(name = "name") val name: String,
    @Json(name = "age") val age: Int,
    @Json(name = "isStudent") val isStudent: Boolean,
    @Json(name = "courses") val courses: List<String>
)

进行转换

你需要创建一个Moshi实例：

val moshi = Moshi.Builder().build()

JSON字符串 -> 对象 (反序列化)

val jsonAdapter = moshi.adapter(User::class.java)
val user = jsonAdapter.fromJson(jsonString)

对象 -> JSON字符串 (序列化)

val jsonAdapter = moshi.adapter(User::class.java)
val jsonString = jsonAdapter.toJson(user)

Moshi的优势：

性能更高：基于动态代理，运行时开销更小。
Kotlin友好：无缝支持Kotlin的默认参数、数据类等特性。
类型适配器：可以轻松扩展，自定义复杂类型的转换逻辑。

使用Kotlinx Serialization（Kotlin官方方案）

如果你是纯Kotlin开发者,那么Kotlin官方推出的序列化库是最佳选择，它与Kotlin语言深度集成，提供了编译时检查和零反射开销的序列化/反序列化。

添加依赖

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

plugins {
    // ...
    id 'kotlinx-serialization' // 确保应用了插件
}
dependencies {
    implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.0" // 使用最新版本
}

创建模型类

使用@Serializable注解来标记一个类可以被序列化。

Kotlin代码示例：

import kotlinx.serialization.Serializable
import kotlinx.serialization.json.Json
@Serializable
data class User(
    val name: String,
    val age: Int,
    val isStudent: Boolean,
    val courses: List<String>
)

进行转换

Kotlinx Serialization使用一个Json实例来配置和执行操作。

// 创建一个Json实例，可以配置策略等
val json = Json { 
    prettyPrint = true // 输出格式化的JSON
}
// JSON字符串 -> 对象 (反序列化)
val user = json.decodeFromString<User>(jsonString)
// 对象 -> JSON字符串 (序列化)
val jsonString = json.encodeToString(user)

Kotlinx Serialization的优势：