安卓怎么导入json库

安卓开发中如何导入并使用JSON库：详细指南

在安卓开发中，JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，被广泛应用于网络请求、数据存储、配置文件解析等场景，安卓系统本身提供了内置的JSON解析工具（如org.json库），但开发者也常根据需求选择第三方库（如Gson、Moshi）以提升开发效率，本文将详细介绍如何在安卓项目中导入并使用这些JSON库,涵盖内置库和主流第三方库的配置及基本用法。

安卓内置JSON库：无需额外配置

安卓SDK已默认包含org.json库，无需手动添加依赖，可直接在代码中使用，该库提供了JSONObject、JSONArray等核心类，支持JSON字符串与Java对象的互转,适合轻量级JSON处理场景。

基本用法示例

（1）JSON字符串转Java对象

假设有以下JSON字符串：

{"name":"张三","age":25,"isStudent":true}

可通过JSONObject解析：

import org.json.JSONObject;
public class JsonParseExample {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"张三\",\"age\":25,\"isStudent\":true}";
        try {
            JSONObject jsonObject = new JSONObject(jsonString);
            String name = jsonObject.getString("name");
            int age = jsonObject.getInt("age");
            boolean isStudent = jsonObject.getBoolean("isStudent");
            System.out.println("姓名: " + name);
            System.out.println("年龄: " + age);
            System级.out.println("是否学生: " + isStudent);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

（2）Java对象转JSON字符串

将Java对象（如User类）转换为JSON字符串：

import org.json.JSONObject;
class User {
    private String name;
    private int age;
    private boolean isStudent;
    public User(String name, int age, boolean isStudent) {
        this.name = name;
        this.age = age;
        this.isStudent = isStudent;
    }
    // 生成JSON字符串
    public String toJsonString() {
        JSONObject jsonObject = new JSONObject();
        try {
            jsonObject.put("name", name);
            jsonObject.put("age", age);
            jsonObject.put("isStudent", isStudent);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return jsonObject.toString();
    }
}
public class JsonGenerateExample {
    public static void main(String[] args) {
        User user = new User("李四", 22, false);
        String jsonString = user.toJsonString();
        System.out.println(jsonString); // 输出: {"name":"李四","age":22,"isStudent":false}
    }
}

优缺点分析

• 优点：无需依赖，系统自带,适合简单JSON场景。
• 缺点：功能有限，手动解析字段繁琐，不支持直接与Java Bean互转（需手动映射）。

第三方JSON库：Gson与Moshi的导入与使用

对于复杂JSON场景或需要自动映射Java Bean的需求，第三方库（如Google的Gson、Square的Moshi）更高效,以下是两种主流库的配置方法。

（一）Gson库：Google官方推荐

Gson是Google开发的JSON库，支持JSON与Java对象的自动转换、泛型处理、自定义序列化/反序列化等功能。

添加依赖

在模块级build.gradle.kts（或build.gradle）文件中添加Gson依赖：

// build.gradle.kts
dependencies {
    implementation("com.google.code.gson:gson:2.10.1") // 建议使用最新版本
}

添加后点击“Sync Now”同步项目。

基本用法

（1）JSON字符串转Java对象（自动映射）

定义Java Bean类（字段名需与JSON键名一致）：

public class User {
    private String name;
    private int age;
    private boolean isStudent;
    // 必须提供无参构造方法（Gson反射需要）
    public User() {}
    // getter和setter方法
    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 boolean isStudent() { return isStudent; }
    public void setStudent(boolean student) { isStudent = student; }
    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + ", isStudent=" + isStudent + "}";
    }
}

使用Gson解析JSON：

import com.google.gson.Gson;
public class GsonExample {
    public static void main(String[] args) {
        String jsonString = "{\"name\":\"王五\",\"age\":23,\"isStudent\":true}";
        Gson gson = new Gson();
        // JSON字符串转Java对象
        User user = gson.fromJson(jsonString, User.class);
        System.out.println(user); // 输出: User{name='王五', age=23, isStudent=true}
        // Java对象转JSON字符串
        String jsonOutput = gson.toJson(user);
        System.out.println(jsonOutput); // 输出: {"name":"王五","age":23,"isStudent":true}
    }
}

（2）处理复杂JSON（嵌套对象、数组）

假设JSON包含嵌套对象和数组：

{
  "name":"赵六",
  "age":24,
  "hobbies":["编程","阅读"],
  "address":{
    "city":"北京",
    "district":"海淀区"
  }
}

定义对应Java类：

public class Address {
    private String city;
    private String district;
    // getter、setter、无参构造
}
public class ComplexUser {
    private String name;
    private int age;
    private List<String> hobbies;
    private Address address;
    // getter、setter、无参构造
}

解析代码：

String complexJson = "{\"name\":\"赵六\",\"age\":24,\"hobbies\":[\"编程\",\"阅读\"],\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
Gson gson = new Gson();
ComplexUser complexUser = gson.fromJson(complexJson, ComplexUser.class);
System.out.println(complexUser.getAddress().getCity()); // 输出: 北京

（二）Moshi库：Square出品，Kotlin友好

Moshi是Square开发的JSON库，以高性能和Kotlin支持著称，支持注解自动生成适配器（Adapter）,减少样板代码。

添加依赖

在模块级build.gradle.kts中添加Moshi依赖：

// build.gradle.kts
dependencies {
    implementation("com.squareup.moshi:moshi:1.15.0") // 最新版本
    // Kotlin支持（可选，Kotlin项目推荐）
    kapt("com.squareup.moshi:moshi-kotlin:1.15.0")
}

若使用Kotlin，需添加kapt插件并在build.gradle.kts中应用：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt") // 添加此行
}

基本用法

（1）Java/Kotlin对象与JSON互转

定义Kotlin数据类（Moshi对Kotlin支持更优）：

data class User(
    val name: String,
    val age: Int,
    val isStudent: Boolean
)

使用Moshi解析：

import com.squareup.moshi.Moshi
import com.squareup.moshi.kotlin.reflect.KotlinJsonAdapterFactory
fun main() {
    val json = """{"name":"孙七","age":26,"isStudent":false}"""
    // 创建Moshi实例，注册Kotlin适配器
    val moshi = Moshi.Builder()
        .add(KotlinJsonAdapterFactory())
        .build()
    // 获取JsonAdapter
    val jsonAdapter = moshi.adapter(User::class.java)
    // JSON转对象
    val user = jsonAdapter.fromJson(json)
    println(user) // 输出: User(name=孙七, age=26, isStudent=false)
    // 对象转JSON
    val jsonOutput = jsonAdapter.toJson(user)
    println(jsonOutput) // 输出: {"name":"孙七","age":26,"isStudent":false}
}

（2）处理JSON字段名映射（注解）

若JSON键名与Java/Kotlin字段名不一致,可通过注解映射：

data class User(
    @Json(name = "user_name") val name: String, // JSON中"user_name"映射到name字段
    @Json(name = "user_age") val age: Int
)

常见问题与解决方案

ClassNotFoundException: org.json.JSONObject

原因：未正确导入org.json包（实际应为import org.json.JSONObject，