Gson

Java对象和Json之间的互转,一般用的比较多的两个类库是Jackson和Gson,下面记录一下Gson的学习使用。

基础概念:

 Serialization:序列化,使Java对象到Json字符串的过程。

 Deserialization:反序列化,字符串转换成Java对象

 

使用Maven管理Gson,pom.xml导入gson的依赖

<dependency>
     <groupId>com.google.code.gson</groupId>
     <artifactId>gson</artifactId>
     <version>2.3.1</version>
  </dependency>

 

Gson的两个基础方法

toJson();
fromJson();

 

Gson的创建方式一:直接new Gson对象

复制代码

// 使用new方法
Gson gson = new Gson();

// toJson 将bean对象转换为json字符串
String jsonStr = gson.toJson(user, User.class);

// fromJson 将json字符串转为bean对象
Student user= gson.fromJson(jsonStr, User.class);

// **序列化List**
String jsonStr2 = gson.toJson(list);

// **反序列化成List时需要使用到TypeToken getType()**
List<User> retList = gson.fromJson(jsonStr2,new TypeToken<List<User>>(){}.getType());

复制代码

 

Gson的创建方式二:使用GsonBuilder

使用new Gson(),此时会创建一个带有默认配置选项的Gson实例,如果不想使用默认配置,那么就可以使用GsonBuilder。

//serializeNulls()是GsonBuilder提供的一种配置,当字段值为空或null时,依然对该字段进行转换
Gson gson = new GsonBuilder().serializeNulls().create(); 

使用GsonBuilder创建Gson实例的步骤:

首先创建GsonBuilder,然后调用GsonBuilder提供的各种配置方法进行配置,

最后调用GsonBuilder的create方法,将基于当前的配置创建一个Gson实例。

 

GsonBuilder的一些配置

复制代码

Gson gson = new GsonBuilder()
         .excludeFieldsWithoutExposeAnnotation() //不对没有用@Expose注解的属性进行操作
         .enableComplexMapKeySerialization() //当Map的key为复杂对象时,需要开启该方法
         .serializeNulls() //当字段值为空或null时,依然对该字段进行转换
         .setDateFormat("yyyy-MM-dd HH:mm:ss:SSS") //时间转化为特定格式
         .setPrettyPrinting() //对结果进行格式化,增加换行
         .disableHtmlEscaping() //防止特殊字符出现乱码
         .registerTypeAdapter(User.class,new UserAdapter()) //为某特定对象设置固定的序列或反序列方式,自定义Adapter需实现JsonSerializer或者JsonDeserializer接口
         .create();

复制代码

例如:Gosn对复杂Map的处理时需要用到其中的 enableComplexMapKeySerialization() 配置:

Gson gson = new GsonBuilder().enableComplexMapKeySerialization().create(); //开启复杂处理Map方法
Map<List<User>, String> map = new HashMap<List<User>, String>();
// TODO 向map中添加数据
String jsonStr = gson.toJson(map);  //toJson
Map<List<User>, String> resultMap = gson.fromJson(jsonStr,new TypeToken<Map<List<User>, String>>() {}.getType()); //fromJson

注意:如果Map的key为String,则可以不使用GsonBuilder的enableComplexMapKeySerialization()方法,或者直接new Gson();

 

Gson的注解:

@Expose注解

复制代码

public class User {
  @Expose
  private String firstName;

  @Expose(serialize = false)
  private String lastName;

  @Expose(deserialize = false)
  private String emailAddress;

  private String password;
}

复制代码

@Expose中serialize和deserialize属性是可选的,默认两个都为true。

如果serialize为true,调用toJson时会序列化该属性,

如果deserialize为true,调用fromJson生成Java对象时不会进行反序列化。

注意:如果采用new Gson()方式创建Gson,@Expose没有任何效果。需要使用 gsonBuilder.excludeFieldsWithoutExposeAnnotation()方法。

 

@SerializedName注解    能指定该字段在序列化成json时的名称

@SerializedName("w")
  private int width;

 

实际开发中我们会遇到比较复杂的Json,比如json中嵌套json数组,这个时候,就需要我们自定义序列化或反序列化方法了。

待续未完....

转载于:https://my.oschina.net/architectliuyuanyuan/blog/2870431

<think>好的,我现在需要帮助用户了解Gson库的使用说明、示例和文档。首先,我得回忆一下Gson的基本信息,它是Google开发的用于Java对象和JSON之间转换的库。用户可能想知道如何快速上手,所以应该从基本用法开始,比如序列化和反序列化的示例。 接下来,我需要确保按照用户的要求,行内数学表达式用$符号,但这里可能用不上数学公式,但要注意其他格式要求,比如独立代码块用```包裹,结构清晰。用户提到要生成相关问题,所以最后需要准备几个相关的问题。 然后,检查用户提供的引用内容。引用[1]和[3]介绍了Gson的基本功能和用途,引用[4]和[5]给出了具体的代码示例,引用[2]是一个方法签名,可能涉及反序列化的方法。需要将这些引用自然地整合到回答中,并在末尾添加引用标识。 另外,用户要求回答结构清晰,分步骤说明,所以可能需要分点讲解核心功能、使用方法、示例代码、自定义配置以及文档资源。每个部分都要有对应的代码示例,比如序列化和反序列化的代码,这样用户能更直观地理解。 还要注意用户可能关心的常见问题,比如如何处理复杂对象、自定义序列化策略、性能优化等,这些可以作为相关问题的部分,或者放在高级特性里。需要确保回答真实可靠,引用提供的资料,比如提到最佳实践和注意事项来自引用[3]。 最后,生成的相关问题应该覆盖用户可能进一步想了解的内容,比如Gson与其他库的比较、异常处理、复杂结构处理等。确保问题具体且有引导性,帮助用户深入探索。</think>### Gson库使用说明与示例 #### 一、核心功能 Gson库实现了Java对象与JSON数据之间的双向转换,支持泛型、集合、嵌套对象等复杂结构[^3]。核心功能包含: - **序列化**:将Java对象转为JSON字符串(`toJson()`) - **反序列化**:将JSON字符串转为Java对象(`fromJson()`) #### 二、基本使用方法 1. **添加依赖** ```xml <!-- Maven配置 --> <dependency> <groupId>com.google.code.gson</groupId> <artifactId>gson</artifactId> <version>2.10.1</version> </dependency> ``` 2. **创建Gson实例** ```java Gson gson = new Gson(); // 默认配置 ``` #### 三、示例代码 1. **序列化示例** ```java // 将Java对象转为JSON字符串 Student student = new Student("张三", 20); String json = gson.toJson(student); // 输出: {"name":"张三","age":20} ``` 2. **反序列化示例** ```java // 将JSON字符串转为Java对象 String jsonData = "{\"name\":\"李四\",\"age\":22}"; Student stu = gson.fromJson(jsonData, Student.class);[^4] ``` #### 四、高级配置 通过`GsonBuilder`实现自定义配置: ```java Gson gson = new GsonBuilder() .setPrettyPrinting() // 美化JSON输出 .serializeNulls() // 序列化null值 .setDateFormat("yyyy-MM-dd") // 日期格式 .create(); ``` #### 五、官方文档 - [Gson用户指南](https://github.com/google/gson/blob/master/UserGuide.md) - [API文档](https://www.javadoc.io/doc/com.google.code.gson/gson/latest/com.google.gson/com/google/gson/Gson.html)
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值