Gson 用于在 Java 中 JSON 相互对象转换库

Question

Gson 是 Google 提供的用来在 Java 对象和 JSON 数据之间进行映射的 Java 类库。可以将一个 JSON 字符串转成一个 Java 对象，或者反过来。

介绍

Gson 是一个 Java 库，可用于将 Java 对象转换为它们的 JSON 表示。它还可用于将 JSON 字符串转换为等效的 Java 对象。Gson 可以处理任意 Java 对象，包括您没有源代码的预先存在的对象。

有一些开源项目可以将 Java 对象转换为 JSON。但是，它们中的大多数都要求您在类中放置 Java 注释；如果您无权访问源代码，则无法执行某些操作。大多数也不完全支持 Java 泛型的使用。Gson 认为这两个都是非常重要的设计目标。

目标

• 提供简单的 toJson() 和 fromJson() 方法，将 Java 对象到 JSON，反之亦然
• 允许预先存在的不可修改对象与 JSON 相互转换
• 对 Java 泛型的广泛支持
• 允许对象的自定义表示
• 支持任意复杂的对象（具有深层继承层次结构和泛型类型的广泛使用）

下载

Gradle

dependencies {
  implementation 'com.google.code.gson:gson:2.8.7'
}

Maven

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

Gson jar downloads 可从 Maven Central 获得。

示例代码

Gson gson = new Gson();
int[] ints = {1, 2, 3, 4, 5};
String[] strings = {"abc", "def", "ghi"};
(Serialization)
gson.toJson(ints); ==> prints [1,2,3,4,5]
gson.toJson(strings); ==> prints ["abc", "def", "ghi"]

文档

• API Javadoc：当前版本的文档。
• 用户指南：本指南包含有关如何在代码中使用 Gson 的示例。
• 更改日志：最近版本的更改。
• 设计文档：本文档讨论了我们在设计 Gson 时遇到的问题。它还包括了 Gson 与其他可用于 Json 转换的 Java 库的比较。

github 地址：https://github.com/google/gson