安卓平台JSON适配全攻略：从解析到高效实践**
在安卓开发中,JSON（JavaScript Object Notation）作为一种轻量级的数据交换格式，因其简洁、易读以及易于机器解析和生成的特点，成为了前后端数据交互的主流选择，无论是从服务器获取用户信息、加载配置文件，还是进行复杂的数据同步，都离不开JSON的身影，安卓平台下JSON的适配与处理，是每一位安卓开发者的必备技能，本文将详细介绍在安卓平台上如何高效、稳定地适配和使用JSON。
JSON在安卓中的核心角色
JSON在安卓应用中主要扮演着“数据搬运工”的角色：
- 数据接收：从API接口、服务器响应中获取JSON格式的数据。
- 数据解析：将接收到的JSON字符串转换成安卓应用可以识别和操作的对象（如Java对象或Map/List）。
- 数据发送：将安卓应用中的对象转换成JSON字符串，发送给服务器或保存到本地。
- 数据存储：将JSON格式的数据保存到SharedPreferences、数据库或文件中，实现轻量级本地存储。
安卓原生JSON解析方案
安卓系统本身提供了内置的JSON解析库,无需额外依赖，主要包括org.json包下的几个核心类。
核心类介绍
JSONObject：代表JSON对象，是一个无序的“键/值对”集合，可以通过键（String）来获取对应的值（可以是String, JSONNumber, JSONObject, JSONArray等）。JSONArray：代表JSON数组，是一个有序的值集合，值可以是String, JSONNumber, JSONObject, JSONArray等。JSONStringer/JSONWriter：用于手动构建JSON字符串的类，较少直接使用，通常更推荐使用JSONObject和JSONArray的put()方法来构建。
解析JSON字符串为Java对象（以JSONObject为例）
假设我们有如下JSON字符串：
{
"name": "张三",
"age": 30,
"isStudent": false,
"courses": ["数学", "物理", "化学"],
"address": {
"city": "北京",
"district": "海淀区"
}
}
解析步骤：
import org.json.JSONObject;
import org.json.JSONArray;
import org.json.JSONException;
public class JsonParserExample {
public void parseJson(String jsonString) {
try {
// 1. 创建JSONObject对象
JSONObject jsonObject = new JSONObject(jsonString);
// 2. 获取基本类型数据
String name = jsonObject.getString("name");
int age = jsonObject.getInt("age");
boolean isStudent = jsonObject.getBoolean("isStudent");
// 3. 获取JSONArray
JSONArray coursesArray = jsonObject.getJSONArray("courses");
for (int i = 0; i < coursesArray.length(); i++) {
String course = coursesArray.getString(i);
System.out.println("课程: " + course);
}
// 4. 获取嵌套的JSONObject
JSONObject addressObject = jsonObject.getJSONObject("address");
String city = addressObject.getString("city");
String district = addressObject.getString("district");
System.out.println("姓名: " + name);
System.out.println("年龄: " + age);
System.out.println("是否学生: " + isStudent);
System.out.println("城市: " + city + ", 区: " + district);
} catch (JSONException e) {
e.printStackTrace();
System.err.println("JSON解析出错: " + e.getMessage());
}
}
}
将Java对象转换为JSON字符串
构建JSON字符串：
import org.json.JSONObject;
public class JsonBuilderExample {
public String buildJson() {
JSONObject jsonObject = new JSONObject();
try {
jsonObject.put("name", "李四");
jsonObject.put("age", 25);
jsonObject.put("isStudent", true);
JSONArray coursesArray = new JSONArray();
coursesArray.put("语文");
coursesArray.put("英语");
jsonObject.put("courses", coursesArray);
JSONObject addressObject = new JSONObject();
addressObject.put("city", "上海");
addressObject.put("district", "浦东新区");
jsonObject.put("address", addressObject);
} catch (JSONException e) {
e.printStackTrace();
}
return jsonObject.toString();
}
}
原生方案的优缺点
- 优点：
- 系统自带,无需添加第三方依赖，减小APK体积。
- 简单场景下使用方便,无需额外学习成本。
- 缺点：
- 功能相对基础,缺乏高级特性（如自动类型转换、日期处理等）。
- 解析和构建过程需要手动编写大量代码,尤其对于复杂的JSON结构，代码冗长且容易出错。
- 不支持直接将JSON映射到JavaBean（POJO），需要手动逐个赋值。
- 错误处理较为繁琐,需要频繁捕获
JSONException。
第三方JSON库适配（推荐）
为了解决原生方案的痛点,社区涌现了许多优秀的第三方JSON库，它们提供了更强大、更便捷的功能，目前主流的有：
- Gson (Google)
- Moshi (Square)
- Jackson (FasterXML)
这些库的核心优势在于序列化（对象转JSON）和反序列化（JSON转对象）的自动化，只需定义好JavaBean（POJO），库就能自动完成映射。
Gson示例
在build.gradle (Module: app)中添加依赖：
implementation 'com.google.code.gson:gson:2.10.1' // 使用最新版本
定义JavaBean：
// Address.java
public class Address {
private String city;
private String district;
// 必须有无参构造函数
public Address() {}
// getter和setter方法
public String getCity() { return city; }
public void setCity(String city) { this.city = city; }
public String getDistrict() { return district; }
public void setDistrict(String district) { this.district = district; }
@Override
public String toString() {
return "Address{" + "city='" + city + '\'' + ", district='" + district + '\'' + '}';
}
}
// User.java
import java.util.List;
public class User {
private String name;
private int age;
private boolean isStudent;
private List<String> courses;
private Address address;
// 必须有无参构造函数
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; }
public List<String> getCourses() { return courses; }
public void setCourses(List<String> courses) { this.courses = courses; }
public Address getAddress() { return address; }
public void setAddress(Address address) { this.address = address; }
@Override
public String toString() {
return "User{" + "name='" + name + '\'' + ", age=" + age + ", isStudent=" + isStudent + ", courses=" + courses + ", address=" + address + '}';
}
}
使用Gson解析和构建：
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.Arrays;
import java.util.List;
public class GsonExample {
public void gsonDemo() {
Gson gson = new Gson();
// JSON字符串转Java对象 (反序列化)
String jsonString = "{\"name\":\"张三\",\"age\":30,\"isStudent\":false,\"courses\":[\"数学\",\"物理\",\"化学\"],\"address\":{\"city\":\"北京\",\"district\":\"海淀区\"}}";
User user = gson.fromJson(jsonString, User.class);
System.out.println("解析后的User对象: " + user);
// Java对象转JSON字符串 (序列化)
User newUser = new User();
newUser.setName("李四");
newUser.setAge(25);
newUser.setStudent(true);
newUser.setCourses(Arrays.asList("语文", "英语"));
Address address = new Address();
address.setCity("上海");
address.setDistrict("浦东新区");
newUser.setAddress(address);
String newUserJsonString = gson.toJson(newUser);
System.out.println("User对象转JSON字符串: " + newUserJsonString);
// 解析复杂JSON数组
String jsonArrayString = "[{\"name\":\"王五\",\"age\":20},{\"name\":\"赵六\",\"age\":22}]";
Type userListType = new TypeToken<List<User>>(){}.getType();
List<User> userList = gson.fromJson(jsonArrayString, userListType);
System.out.println("解析后的User列表: " + userList);
还没有评论，来说两句吧...