JAVA：Gson：序列化和反序列化

        Gson 是 Google 提供的一个用于在 Java 中方便地进行 JSON 与对象互相转换的库。

        Gson 并不是 Android Studio（AS）专用的库，它是一个 通用的 Java JSON 解析库，可以在 任何 Java 项目 中使用。基本用法如下：

1. 把 Java 对象转换为 JSON

目的：将 Java 对象序列化为 JSON 以便存储或传输。

import com.google.gson.Gson;class User {String name;int age;public User(String name, int age) {this.name = name;this.age = age;}
}public class GsonExample {public static void main(String[] args) {Gson gson = new Gson();User user = new User("Alice", 25);// 对象转换为 JSONString json = gson.toJson(user);System.out.println(json); // 输出：{"name":"Alice","age":25}}
}

2. 把 JSON 转换为 Java 对象

目的：解析 JSON 数据并映射到 Java 对象，方便程序处理。

import com.google.gson.Gson;public class GsonExample {public static void main(String[] args) {Gson gson = new Gson();// JSON 字符串String json = "{\"name\":\"Alice\",\"age\":25}";// JSON 转换为对象User user = gson.fromJson(json, User.class);System.out.println("Name: " + user.name); // 输出：Name: AliceSystem.out.println("Age: " + user.age);   // 输出：Age: 25}
}

3. 解析 JSON 数组

目的：处理包含多个对象的 JSON 数据。

import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;public class GsonExample {public static void main(String[] args) {Gson gson = new Gson();// JSON 数组String jsonArray = "[{\"name\":\"Alice\",\"age\":25}, {\"name\":\"Bob\",\"age\":30}]";// 解析 JSON 数组Type listType = new TypeToken<List<User>>(){}.getType();List<User> users = gson.fromJson(jsonArray, listType);for (User user : users) {System.out.println("Name: " + user.name + ", Age: " + user.age);}}
}

输出：

Name: Alice, Age: 25
Name: Bob, Age: 30

如果某些字段不想被转换，可以用 @Expose：

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.annotations.Expose;class User {@ExposeString name; // 参与序列化 & 反序列化@Exposeint age; // 参与序列化 & 反序列化@Expose(serialize = false) // 不会出现在 JSON 里（不参与序列化）String password;@Expose(deserialize = false) // JSON 解析时会忽略这个字段（不参与反序列化）String internalId;public User(String name, int age, String password, String internalId) {this.name = name;this.age = age;this.password = password;this.internalId = internalId;}
}public class GsonExposeExample {public static void main(String[] args) {User user = new User("Alice", 25, "secret123", "XYZ987");// Gson 默认不会处理 @Expose，需要用 GsonBuilder 显式启用Gson gson = new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create();// 序列化：对象 -> JSONString json = gson.toJson(user);System.out.println("序列化后 JSON: " + json);// 反序列化：JSON -> 对象String jsonString = "{\"name\":\"Bob\",\"age\":30,\"password\":\"hidden\",\"internalId\":\"ABC123\"}";User parsedUser = gson.fromJson(jsonString, User.class);System.out.println("反序列化后对象: Name = " + parsedUser.name + ", Age = " + parsedUser.age + ", Password = " + parsedUser.password + ", InternalId = " + parsedUser.internalId);}
}

默认情况下，Gson 会序列化和反序列化所有字段，但是有时候：

• 你不想把某些字段暴露在 JSON 中（如密码 password、内部 ID internalId）。
• 你想仅序列化某些字段，而不希望它们在反序列化时被解析。
• 你想仅反序列化某些字段，而不希望它们在序列化时出现。

这时候，我们可以用 @Expose 进行控制。