Android开发 JSON数据解析

封面图 • 2025-12-24 • Android开发

在 Android 开发中，解析 JSON 数据是一个非常常见的需求。JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，常用于从服务器获取数据并展示在应用中。

下面我将介绍几种常用的 JSON 解析方法，包括 **原生的 `org.json` 库** 和 **第三方库如 Gson、Jackson 或 Kotlin 的 `kotlinx.serialization`**。

---

## 一、使用 Android 原生的 `org.json` 库

Android 自带了 `org.json` 库，可以直接使用，无需额外添加依赖。

### 示例 JSON 数据
```json
{
  "name": "John",
  "age": 30,
  "isStudent": false,
  "hobbies": ["reading", "gaming", "coding"],
  "address": {
    "city": "Shanghai",
    "country": "China"
  }
}
```

### Java 代码示例

```java
import org.json.JSONObject;
import org.json.JSONArray;

public class JsonParsingExample {

public static void parseJson(String json) {
        try {
            JSONObject jsonObject = new JSONObject(json);

String name = jsonObject.getString("name");
            int age = jsonObject.getInt("age");
            boolean isStudent = jsonObject.getBoolean("isStudent");

JSONArray hobbies = jsonObject.getJSONArray("hobbies");
            for (int i = 0; i < hobbies.length(); i++) {
                String hobby = hobbies.getString(i);
                System.out.println("Hobby: " + hobby);
            }

JSONObject address = jsonObject.getJSONObject("address");
            String city = address.getString("city");
            String country = address.getString("country");

// 打印结果
            System.out.println("Name: " + name);
            System.out.println("Age: " + age);
            System.out.println("Is Student: " + isStudent);
            System.out.println("City: " + city);
            System.out.println("Country: " + country);

} catch (Exception e) {
            e.printStackTrace();
        }
    }
}
```

---

## 二、使用 Gson 库（推荐）

Gson 是 Google 提供的一个强大的 JSON 解析库，支持将 JSON 字符串直接映射到 Java 对象。

### 添加依赖（Gradle）
在 `build.gradle` 文件中添加：

```gradle
dependencies {
    implementation 'com.google.code.gson:gson:2.10.1'
}
```

### 定义 Java Bean 类

```java
public class User {
    private String name;
    private int age;
    private boolean isStudent;
    private List<String> hobbies;
    private Address address;

// Getters and Setters
    // ...
}

public class Address {
    private String city;
    private String country;

// Getters and Setters
    // ...
}
```

### 使用 Gson 解析 JSON

```java
import com.google.gson.Gson;

public class JsonParsingWithGson {

public static void parseJson(String json) {
        Gson gson = new Gson();
        User user = gson.fromJson(json, User.class);

// 使用 user 对象
        System.out.println("Name: " + user.getName());
        System.out.println("Age: " + user.getAge());
        System.out.println("Is Student: " + user.isStudent());
        System.out.println("City: " + user.getAddress().getCity());
    }
}
```

---

## 三、使用 Kotlin 的 `kotlinx.serialization`（推荐 Kotlin 项目）

如果你使用的是 Kotlin，可以考虑使用 `kotlinx.serialization`，它提供了更简洁的语法和类型安全。

### 添加依赖（Gradle）

```gradle
plugins {
    id("org.jetbrains.kotlin.plugin.serialization") version "1.9.0"
}

dependencies {
    implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.1"
}
```

### 定义数据类

```kotlin
import kotlinx.serialization.Serializable

@Serializable
data class User(
    val name: String,
    val age: Int,
    val isStudent: Boolean,
    val hobbies: List<String>,
    val address: Address
)

@Serializable
data class Address(
    val city: String,
    val country: String
)
```

### 解析 JSON 字符串

```kotlin
import kotlinx.serialization.json.Json
import kotlinx.serialization.json.decodeFromStream

fun parseJson(jsonString: String) {
    val json = Json { ignoreUnknownKeys = true }
    val user = json.decodeFromString<User>(jsonString)
    println("Name: ${user.name}")
    println("Age: ${user.age}")
    println("Is Student: ${user.isStudent}")
    println("City: ${user.address.city}")
}
```

---

## 四、其他注意事项

- 如果 JSON 数据结构复杂（嵌套多层），建议使用 Gson 或 Kotlin 的序列化库。
- 在 Android 中，不要在主线程中做耗时操作（如网络请求或大量 JSON 解析），应使用 `AsyncTask`、`Thread` 或 `Coroutine`。
- 对于大型 JSON 数据，可以使用流式解析器（如 `JsonReader`）来节省内存。

---

## 总结

| 方法 | 优点 | 缺点 |
|------|------|------|
| `org.json` | 简单易用，无需依赖 | 功能有限，手动处理繁琐 |
| Gson | 强大、易于使用、支持复杂结构 | 需要添加依赖 |
| `kotlinx.serialization` | 类型安全、简洁 | 需要 Kotlin 支持 |

---

如果你有具体的 JSON 数据结构或需要解析的场景，欢迎提供详细信息，我可以帮你写出对应的解析代码。