Gson(Google Gson)是一个Java库,用于将Java对象转换为其JSON表示,或者将JSON字符串转换为等效的Java对象。Gson由Google开发,并广泛用于处理JSON数据,特别是在Java服务器端编程和Android应用程序开发中。
2. 基本用法
2.1 引入Gson
首先,需要在项目中引入Gson库。如果你使用Maven,可以在pom.xml
中添加以下依赖:
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.9</version>
</dependency>
或者直接导入gson的软件包,导入到项目文件中并添加到library库 :
链接:https://pan.baidu.com/s/1nJrSZiYA2hKvAqUm86F5NQ?pwd=mnle
提取码:mnle
2.2 创建Gson实例
Gson gson = new Gson();
2.3 序列化:Java对象 -> JSON字符串
class Person {
private String name;
private int age;
// getters and setters
}
Person person = new Person("John", 30);
String json = gson.toJson(person);
System.out.println(json); // 输出: {"name":"John","age":30}
2.4 反序列化:JSON字符串 -> Java对象
String json = "{\"name\":\"John\",\"age\":30}";
Person person = gson.fromJson(json, Person.class);
System.out.println(person.getName()); // 输出: John
3. 高级用法
3.1 使用注解
Gson提供了多个注解来控制序列化和反序列化的行为:
@SerializedName
:指定字段在JSON中的名称。@Expose
:标记字段是否应该被序列化或反序列化。@Since
和@Until
:根据版本号包含或排除字段。
3.2 自定义序列化和反序列化
class PersonTypeAdapter extends TypeAdapter<Person> {
@Override
public void write(JsonWriter out, Person value) throws IOException {
// 自定义序列化逻辑
}
@Override
public Person read(JsonReader in) throws IOException {
// 自定义反序列化逻辑
}
}
GsonBuilder builder = new GsonBuilder();
builder.registerTypeAdapter(Person.class, new PersonTypeAdapter());
Gson gson = builder.create();
3.3 GsonBuilder
GsonBuilder
类用于创建一个自定义配置的Gson实例。例如,可以启用或禁用特定的序列化特性:
Gson gson = new GsonBuilder()
.serializeNulls() // 序列化null值
.disableHtmlEscaping() // 禁用HTML转义
.setDateFormat("yyyy-MM-dd HH:mm:ss") // 设置日期格式
.create();