1、Gson的安装引用
下载地址:https://github.com/google/gson/releases
1)通过Gradle引用
dependencies {
implementation 'com.google.code.gson:gson:2.8.5'
}
2)通过Maven引用
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.5</version>
</dependency>
2、Gson使用示例代码
1)基本数据类型示例
// 序列化
Gson gson = new Gson();
gson.toJson(1); // ==> 1
gson.toJson("abcd"); // ==> "abcd"
gson.toJson(new Long(10)); // ==> 10
int[] values = { 1 };
gson.toJson(values); // ==> [1]
// 反序列化
int one = gson.fromJson("1", int.class);
Integer one = gson.fromJson("1", Integer.class);
Long one = gson.fromJson("1", Long.class);
Boolean false = gson.fromJson("false", Boolean.class);
String str = gson.fromJson("\"abc\"", String.class);
String[] anotherStr = gson.fromJson("[\"abc\"]", String[].class);
2)对象类型示例
class BagOfPrimitives {
private int value1 = 1;
private String value2 = "abc";
private transient int value3 = 3;
BagOfPrimitives() {
// no-args constructor
}
}
// 序列化
BagOfPrimitives obj = new BagOfPrimitives();
Gson gson = new Gson();
String json = gson.toJson(obj);
// ==> json is {"value1":1,"value2":"abc"}
注意:不能使用循环引用序列化对象,因为这会导致无限递归。
// 反序列化
BagOfPrimitives obj2 = gson.fromJson(json, BagOfPrimitives.class);
// ==> obj2 is just like obj
3)嵌套类(包括内部类)
Gson可以很容易地序列化静态嵌套类。
Gson还可以反序列化静态嵌套类。但是,Gson 不能自动反序列化纯内部类,
因为它们的no-args构造函数还需要对反序列化时不可用的包含Object
的引用。
您可以通过使内部类静态或为其提供自定义InstanceCreator来解决此问题。示例代码:
public class A {
public String a;
class B {
public String b;
public B() {
// No args constructor for B
}
}
}
注意:上述class B不能(默认情况下)使用Gson序列化。{"b":"abc"}
由于B类是一个内部类,Gson不能反序列化为B的实例。
如果它被定义为静态类B,那么Gson就能够反序列化字符串。
另一种解决方案是为B编写自定义实例创建器。
public class InstanceCreatorForB implements InstanceCreator<A.B> {
private final A a;
public InstanceCreatorForB(A a) {
this.a = a;
}
public A.B createInstance(Type type) {
return a.new B();
}
}
以上是可以的,但不推荐
4)数组示例
Gson gson = new Gson();
int[] ints = {1, 2, 3, 4, 5};
String[] strings = {"abc", "def", "ghi"};
// 序列化
gson.toJson(ints); // ==> [1,2,3,4,5]
gson.toJson(strings); // ==> ["abc", "def", "ghi"]
// 反序列化
int[] ints2 = gson.fromJson("[1,2,3,4,5]", int[].class);
// ==> ints2 will be same as ints
支持具有任意复杂元素类型的多维数组。
5)Collections示例
Gson gson = new Gson();
Collection<Integer> ints = Lists.immutableList(1,2,3,4,5);
// 序列化
String json = gson.toJson(ints); // ==> json is [1,2,3,4,5]
// 反序列化
Type collectionType = new TypeToken<Collection<Integer>>(){}.getType();
Collection<Integer> ints2 = gson.fromJson(json, collectionType);
// ==> ints2 is same as ints
6)序列化和反序列化泛型类型示例
class Foo<T> {
T value;
}
Gson gson = new Gson();
Foo<Bar> foo = new Foo<Bar>();
gson.toJson(foo); // May not serialize foo.value correctly
gson.fromJson(json, foo.getClass()); // Fails to deserialize foo.value as Bar
上面的代码无法将值解释为类型Bar,因为Gson调用list.getClass()
获取其类信息,但此方法返回一个原始类,Foo.class
。这意味着Gson无法知道这是一个类型的对象Foo<Bar>
,而不仅仅是普通的Foo。
可以通过为泛型类型指定正确的参数化类型来解决此问题。可以使用TypeToken该类来完成此操作;
Type fooType = new TypeToken<Foo<Bar>>() {}.getType();
gson.toJson(foo, fooType);
gson.fromJson(json, fooType);
参考文档:https://github.com/google/gson/blob/master/UserGuide.md