Android Gson使用详解，android开发基础书

最新推荐文章于 2025-05-23 14:06:28 发布
原创 最新推荐文章于 2025-05-23 14:06:28 发布 · 297 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#面试 #移动开发 #android

本文详细介绍了Android中Gson库的使用，包括基本用法如创建Gson对象、生成Json，以及Json与数组、List的转化。还深入讨论了属性重命名、字段过滤的各种策略，如基于@Expose注解、版本控制、访问修饰符和自定义策略。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

Gson 的 GitHub 主页点击这里：Gson

一、Gson的基本用法

1.1、Gson对象

在进行序列化与反序列操作前，需要先实例化一个 com .google.gson.Gson 对象，获取 Gson 对象的方法有两种

//通过构造函数来获取
Gson gson = new Gson();
//通过 GsonBuilder 来获取，可以进行多项特殊配置
Gson gson = new GsonBuilder().create();

1.2、生成 Json

利用 Gson 可以很方便地生成 Json 字符串，通过使用 addProperty 的四个重载方法

public static void main(String[] args) {
JsonObject jsonObject = new JsonObject();
jsonObject.addProperty(“String”, “leavesC”);
jsonObject.addProperty(“Number_Integer”, 23);
jsonObject.addProperty(“Number_Double”, 22.9);
jsonOb

《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》

【docs.qq.com/doc/DSkNLaERkbnFoS0ZF】 完整内容开源分享

ject.addProperty(“Boolean”, true);
jsonObject.addProperty(“Char”, ‘c’);
System.out.println();
System.out.println(jsonObject);
}

addProperty 方法底层调用的是 add(String property, JsonElement value) 方法，即将基本数据类型转化为了 JsonElement 对象，JsonElement 是一个抽象类，而 JsonObject 继承了 JsonElement ，因此我们可以通过 JsonObject 自己来构建一个 JsonElement

public static void main(String[] args) {
JsonObject jsonObject = new JsonObject();
jsonObject.addProperty(“String”, “leavesC”);
jsonObject.addProperty(“Number”, 23);
jsonObject.addProperty(“Number”, 22.9);
jsonObject.addProperty(“Boolean”, true);
jsonObject.addProperty(“Char”, ‘c’);

JsonObject jsonElement = new JsonObject();
jsonElement.addProperty(“Boolean”, false);
jsonElement.addProperty(“Double”, 25.9);
jsonElement.addProperty(“Char”, ‘c’);
jsonObject.add(“JsonElement”, jsonElement);

System.out.println();
System.out.println(jsonObject);
}

1.3、Json与数组、List的转化

Json数组 与 字符串数组

public static void main(String[] args) {
//Json数组 转为 字符串数组
Gson gson = new Gson();
String jsonArray = “[“https://github.com/leavesC”,“https://www.jianshu.com/u/9df45b87cfdf”,“Java”,“Kotlin”,“Git”,“GitHub”]”;
String[] strings = gson.fromJson(jsonArray, String[].class);
System.out.println("Json数组 转为 字符串数组: “);
for (String string : strings) {
System.out.println(string);
}
//字符串数组 转为 Json数组
jsonArray = gson.toJson(jsonArray, new TypeToken() {
}.getType());
System.out.println(”\n字符串数组 转为 Json数组: ");
System.out.println(jsonArray);
}

Json数组 与 List

public static void main(String[] args) {
//Json数组 转为 List
Gson gson = new Gson();
String jsonArray = “[“https://github.com/leavesC”,“https://www.jianshu.com/u/9df45b87cfdf”,“Java”,“Kotlin”,“Git”,“GitHub”]”;
List stringList = gson.fromJson(jsonArray, new TypeToken<List>() {
}.getType());
System.out.println("\nJson数组 转为 List: “);
for (String string : stringList) {
System.out.println(string);
}
//List 转为 Json数组
jsonArray = gson.toJson(stringList, new TypeToken<List>() {
}.getType());
System.out.println(”\nList 转为 Json数组: ");
System.out.println(jsonArray);
}

1.4、序列化与反序列化

Gson 也提供了 toJson() 和 fromJson() 两个方法用于转化 Model 与 Json，前者实现了序列化，后者实现了反序列化 首先，声明一个 User 类

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class User {

private String name;

private int age;

private boolean sex;

public User(String name, int age, boolean sex) {
this.name = name;
this.age = age;
this.sex = sex;
}

@Override
public String toString() {
return “User{” +
“name=’” + name + ‘’’ +
“, age=” + age +
“, sex=” + sex +
‘}’;
}

}

序列化的方法很简单，调用 gson 对象的 toJson 方法，传入要序列化的对象

public static void main(String[] args) {
//序列化
User user = new User(“leavesC”, 24, true);
Gson gson = new Gson();
System.out.println();
System.out.println(gson.toJson(user));
}

反序化的方式也类似

public static void main(String[] args) {
//反序列化
String userJson = “{“name”:“leavesC”,“age”:24,“sex”:true}”;
Gson gson = new Gson();
User user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);
}

二、属性重命名

继续使用上一节声明的 User 类，根据 User 类声明的各个属性名，移动端的开发者希望接口返回的数据格式即是如下这样的

{“name”:“leavesC”,“age”:24,“sex”:true}

如果没有和服务器端沟通好或者是 API 改版了，接口返回的数据格式可能是这样的

{“Name”:“leavesC”,“age”:24,“sex”:true}

{“userName”:“leavesC”,“age”:24,“sex”:true}

如果继续使用上一节介绍的方法，那无疑会解析出错 例如

public static void main(String[] args) {
//反序列化
String userJson = “{“userName”:“leavesC”,“age”:24,“sex”:true}”;
Gson gson = new Gson();
User user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);
}

name 属性值解析不到，所以为 null

此时为了兼顾多种格式的数据，就需要使用 SerializedName 注解 根据 SerializedName 的声明来看，SerializedName 包含两个属性值，一个是字符串，一个是字符串数组，而字符串数组含有默认值

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
public @interface SerializedName {
String value();

String[] alternate() default {};
}

SerializedName 的作用是为了在序列化或反序列化时，指导 Gson 如果将原有的属性名和其它特殊情况下的属性名联系起来

例如，修改 User 类，为 name 声明 SerializedName 注解，注解值为 userName

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class User {

@SerializedName(“userName”)
private String name;

private int age;

private boolean sex;

}

在序列时，Json 格式就会相应改变

public static void main(String[] args) {
//序列化
User user = new User(“leavesC”, 24, true);
Gson gson = new Gson();
System.out.println();
System.out.println(gson.toJson(user));
}

在反序列化时也一样，能够解析到正确的属性值

public static void main(String[] args) {
//反序列化
String userJson = “{“userName”:“leavesC”,“age”:24,“sex”:true}”;
Gson gson = new Gson();
User user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);
}

还有个问题没解决，为了应对多种属性名不一致的情况，难道我们要声明多个 User 类吗？这显然是不现实的，所以还需要为 User 类设置多个备选属性名，这就需要用到 SerializedName 注解的另一个属性值 alternate 了。

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class User {

@SerializedName(value = “userName”, alternate = {“user_name”, “Name”})
private String name;

private int age;

private boolean sex;

}

以下几种情况都能够被正确的反序列化

public static void main(String[] args) {
//反序列化
Gson gson = new Gson();
String userJson = “{“userName”:“leavesC”,“age”:24,“sex”:true}”;
User user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);

userJson = “{“user_name”:“leavesC”,“age”:24,“sex”:true}”;
user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);

userJson = “{“Name”:“leavesC”,“age”:24,“sex”:true}”;
user = gson.fromJson(userJson, User.class);
System.out.println();
System.out.println(user);
}

三、字段过滤

有时候并不是所有的字段都需要进行系列化和反序列化，因此需要对某些字段进行排除，有四种方法可以来实现这种需求。

3.1、基于@Expose注解

Expose 注解包含两个属性值，且均声明了默认值。Expose 的含义即为“暴露”，即用于对外暴露字段，serialize 用于指定是否进行序列化，deserialize 用于指定是否进行反序列化。如果字段不声明 Expose 注解，则意味着不进行序列化和反序列化操作，相当于两个属性值均为 false 。此外，Expose 注解需要和 GsonBuilder 构建的 Gson 对象一起使用才能生效。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD})
public @interface Expose {
boolean serialize() default true;

boolean deserialize() default true;
}

Expose 注解的注解值声明情况有四种

@Expose(serialize = true, deserialize = true) //序列化和反序列化都生效
@Expose(serialize = false, deserialize = true) //序列化时不生效，反序列化时生效
@Expose(serialize = true, deserialize = false) //序列化时生效，反序列化时不生效
@Expose(serialize = false, deserialize = false) //序列化和反序列化都不生效，和不写注解一样

现在来看个例子，修改 User 类

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class User {

@Expose(serialize = true, deserialize = true) //序列化和反序列化都生效
private String a;

@Expose(serialize = false, deserialize = true) //序列化时不生效，反序列化时生效
private String b;

@Expose(serialize = true, deserialize = false) //序列化时生效，反序列化时不生效
private String c;

@Expose(serialize = false, deserialize = false) //序列化和反序列化都不生效，和不写注解一样
private String d;

private String e;

public User(String a, String b, String c, String d, String e) {
this.a = a;
this.b = b;
this.c = c;
this.d = d;
this.e = e;
}

@Override
public String toString() {
return “User{” +
“a=’” + a + ‘’’ +
“, b=’” + b + ‘’’ +
“, c=’” + c + ‘’’ +
“, d=’” + d + ‘’’ +
“, e=’” + e + ‘’’ +
‘}’;
}

}

按照如上的注解值，只有声明了 Expose 注解且 serialize 值为 true 的字段才能被序列化，只有声明了 Expose 注解且 deserialize 值为 true 的字段才能被反序列化

public static void main(String[] args) {
Gson gson = new GsonBuilder().excludeFieldsWithoutExposeAnnotation().create();
User user = new User(“A”, “B”, “C”, “D”, “E”);
System.out.println();
System.out.println(gson.toJson(user));

String json = “{“a”:“A”,“b”:“B”,“c”:“C”,“d”:“D”,“e”:“E”}”;
user = gson.fromJson(json, User.class);
System.out.println();
System.out.println(user.toString());
}

3.2、基于版本

Gson 提供了 @Since 和 @Until 两个注解基于版本对字段进行过滤，@Since 和 @Until 都包含一个 Double 属性值，用于设置版本号。Since 的意思是“自……开始”，Until 的意思是“到……为止”，一样要和 GsonBuilder 配合使用。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.TYPE})
public @interface Since {
double value();
}

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.TYPE})
public @interface Until {
double value();
}

当版本( GsonBuilder 设置的版本) 大于或等于 Since 属性值或小于 Until 属性值时字段会进行序列化和反序列化操作，而没有声明注解的字段都会加入序列化和反序列操作

现在来看个例子，修改 User 类

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class User {

@Since(1.4)
private String a;

@Since(1.6)
private String b;

@Since(1.8)
private String c;

@Until(1.6)
private String d;

@Until(2.0)
private String e;

public User(String a, String b, String c, String d, String e) {
this.a = a;
this.b = b;
this.c = c;
this.d = d;
this.e = e;
}

@Override
public String toString() {
return “User{” +
“a=’” + a + ‘’’ +
“, b=’” + b + ‘’’ +
“, c=’” + c + ‘’’ +
“, d=’” + d + ‘’’ +
“, e=’” + e + ‘’’ +
‘}’;
}

}

public static void main(String[] args) {
Gson gson = new GsonBuilder().setVersion(1.6).create();
User user = new User(“A”, “B”, “C”, “D”, “E”);
System.out.println();
System.out.println(gson.toJson(user));

String json = “{“a”:“A”,“b”:“B”,“c”:“C”,“d”:“D”,“e”:“E”}”;
user = gson.fromJson(json, User.class);
System.out.println();
System.out.println(user.toString());
}

3.3、基于访问修饰符

访问修饰符由 java.lang.reflect.Modifier 提供 int 类型的定义，而 GsonBuilder 对象的 excludeFieldsWithModifiers方法接收一个 int 类型可变参数，指定不进行序列化和反序列化操作的访问修饰符字段 看个例子

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class ModifierSample {

public String publicField = “public”;

protected String protectedField = “protected”;

private String privateField = “private”;

String defaultField = “default”;

final String finalField = “final”;

static String staticField = “static”;

}

public static void main(String[] args) {
Gson gson = new GsonBuilder().excludeFieldsWithModifiers(Modifier.PRIVATE, Modifier.STATIC).create();
ModifierSample modifierSample = new ModifierSample();
System.out.println(gson.toJson(modifierSample));
}

3.4、基于策略

GsonBuilder 类包含 setExclusionStrategies(ExclusionStrategy... strategies)方法用于传入不定长参数的策略方法，用于直接排除指定字段名或者指定字段类型 看个例子

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class Strategies {

private String stringField;

private int intField;

private double doubleField;

hModifiers(Modifier.PRIVATE, Modifier.STATIC).create();
ModifierSample modifierSample = new ModifierSample();
System.out.println(gson.toJson(modifierSample));
}

[外链图片转存中…(img-U4HOWycx-1640835873719)]

3.4、基于策略

GsonBuilder 类包含 setExclusionStrategies(ExclusionStrategy... strategies)方法用于传入不定长参数的策略方法，用于直接排除指定字段名或者指定字段类型 看个例子

/**

  • 作者：chenZY
  • 时间：2018/3/17 18:32
  • 描述：https://github.com/leavesC
    */
    public class Strategies {

private String stringField;

private int intField;

private double doubleField;

Android Gson使用详解，android中级工程师面试题
m0_64383081的博客
12-15 542
例如，修改 User 类，为 name 声明 SerializedName 注解，注解值为 userName /** 作者：chenZY 时间：2018/3/17 18:32 描述：https://github.com/leavesC */ public class User { @SerializedName(“userName”) private String name; private int age; private boolean sex; } 在序列时，Json 格式就会相应改变 publi
Android Gson使用详解
2401_84149530的博客
04-09 953
Json数组 与 List//Json数组 转为 ListSystem.out.println("\nJson数组 转为 List: “);//List 转为 Json数组System.out.println(”\nList 转为 Json数组: ");
Android Gson使用Demo
06-19
android Gson使用实例 注释详细
android Gson的使用
热门推荐
空之城专栏
08-21 4万+
相对于较为传统的Json解析来说，google共享的开源Gson在解析速度和所使用的内存在有着明显的优势，虽然说阿里巴巴也提供了fastgson包，但是它跟Gson的处理速度大同小异，只是底层实现的原理不同，在这里就来学习一下怎么使用google的开源包Gson（在学习之间你应该下载好google gson包）        Gson的解析非常简单，但是它的解析规则是必须有一个bean文件，这个
深入理解并实践Gson库在Android中的应用
最新发布
weixin_36173034的博客
05-23 732
在当今的移动应用开发领域，尤其是在Android平台上，Gson库因其简洁的API和出色的性能而备受开发者青睐。Gson，全称为Google Gson，是一个用于将Java对象转换为JSON格式数据，以及将JSON数据转换回Java对象的库。它的流行不仅因为它是Google开发的开源项目，而且因为它能够在不需要任何外部依赖的情况下运行。Gson库的广泛使用源于其对复杂对象图的深度支持，包括多层嵌套的对象和数组。
Android Gson的使用总结
weixin_34293902的博客
09-05 169
1、概念 Gson是谷歌发布的一个json解析框架 2、如何获取     github:https://github.com/google/gson     android studio使用 compile 'com.google.code.gson:gson:2.7'     查看 最新版本号  下载最新的jar包 ，http://search.maven.org/#s...
Android Gson使用
JUN_LLLL的博客
06-28 3592
1.基本使用 GSON库主要就是可以将一段JSON格式的字符串自动映射成一个对象或者一个集合，从而不需要我们再手动去编写代码进行解析了。 不过需要添加相关依赖implementation 'com.google.code.gson:gson:2.8.2' {"name":"Tom","age":20} 定义一个 Person 类，并加入 name 和 age 两字段，然后只需调用如下...
Android Gson使用详解，吃一堑长一智
2401_84152140的博客
04-06 703
文章会持续更新的。绝对干货！！！Android进阶学习全套手册关于实战，我想每一个做开发的都有话要说，对于小白而言，缺乏实战经验是通病，那么除了在实际工作过程当中，我们如何去更了解实战方面的内容呢？实际上，我们很有必要去看一些实战相关的电子书。
Android Gson使用详解(1)
2401_84003630的博客
04-03 738
外链图片转存中…(img-QaFEQhKq-1712140290791)]
Android Gson使用详解(1)，程序设计+Android+Web+数据库+框架+分布式
2401_84152126的博客
04-06 493
算法知识点繁多，企业考察的题目千变万化，面对越来越近的“金九银十”，我给大家准备好了一套比较完善的学习方法，希望能帮助大家在有限的时间里尽可能系统快速的恶补算法，通过高效的学习来提高大家面试中算法模块的通过率。这一套学习资料既有文字档也有视频，里面不仅仅有关键知识点的整理，还有案例的算法相关部分的讲解，可以帮助大家更好更全面的进行学习，二者搭配起来学习效果会更好。部分资料展示：有了这套学习资料，坚持刷题一周，你就会发现自己的算法知识体系有明显的完善，离大厂Offer的距离更加近。
android网络开发技术实战详解电子书
03-15
《Android网络开发技术实战详解》是一本专注于Android平台网络编程的专著，旨在帮助开发者深入理解和实践Android应用程序中的网络通信技术。这本书详细介绍了如何在Android应用中实现各种网络功能，如HTTP请求、数据...
android gson的使用
全能小码农
07-27 4549
最近开始用这个工具，发现比较好用，不用写复杂的解析方法，只需要注意实体与json字段对应就ok了 1、添加gson-1.6.jar 2、最好写两个关于特殊的配置的类：日期的序列化和反序列化要实现的接口，这个很简单： public class UtilDateDeserilize implements JsonDeserializer{ @Override public Dat
Android GSON使用
Android唐浮的专栏
10-27 9767
Android GSON使用 使用场景及作用：Gson 是用来解析和生成Json，在实际项目中广泛使用。注意定义定对像的属性值必须和json中的保持一致，不然会解析失败。当然这就要求后台命名规范。 集成 dependencies { implementation 'com.google.code.gson:gson:2.8.6' } 一、对象转Json new Gson().toJson...
android GSON的使用
yann02的博客
09-06 456
1、json字符串转list 集合 Gson gson = new Gson(); if (!TextUtils.isEmpty(localContact)) { selectSortDtes = gson.fromJson(localContact, new TypeToken&lt;List&lt;ContactEntity.InfosBean.ListBean&g...
Android中Gson的使用
小书童的博客
11-15 1万+
Gson在android中的应用什么是Gson下载Json的生成Json的解析 什么是Gson Gson是一个Java库，可用于将Java对象转换为它们的Json 表示形式。它还可以用于将Json 字符串转换为等效的Java对象。Json 的解析和生成的方式很多，在 Android 平台上最常用的类库有 Gson 和 FastJson 两种，这里要介绍的是 Gson。 Gson 的 GitHub 主页点击这里：Gson 下载 Gradle: dependencies { implementation '
android-gson使用
chenyannan0617的博客
07-14 5541
android gson的使用
全面解析Android移动开发：15个案例深度详解
- Android开发环境搭建：包括JDK安装、Android Studio的下载与配置。 - Android SDK与NDK的区别与应用场景：解释系统开发工具包(SDK)和原生开发工具包(NDK)的基本使用场景。 ### 第2章：Android应用基础架构 - 应用...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值