Gson入门教程：让JSON处理变得简单到爆！

原创于 2025-10-02 09:59:00 发布 · 672 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#json #python #开发语言 #其他

文章目录

JSON数据处理在现代Java开发中简直是家常便饭。无论你是在写Web API、移动端接口，还是处理配置文件，JSON都会频繁出现在你的代码里。而Gson，这个Google开源的JSON库，绝对是处理JSON数据的最佳选择之一！

什么是Gson？为什么它这么受欢迎

Gson（Google JSON）是Google开发的一个开源Java库，专门用来在Java对象和JSON数据之间进行转换。说白了，就是帮你把复杂的Java对象轻松转成JSON字符串，或者把JSON字符串还原成Java对象。

你可能会问：市面上这么多JSON库，为啥偏偏选Gson？

原因很简单：

零配置：大多数情况下，你啥都不用配置就能直接用
性能优秀：转换速度快，内存占用合理
社区活跃：Google出品，文档齐全，社区支持给力
功能强大：支持复杂的数据结构，包括泛型、继承等

快速上手：第一个Gson程序

首先得把Gson加到你的项目里。如果用Maven，在pom.xml里加上这几行：

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

Gradle用户就更简单了：

implementation 'com.google.code.gson:gson:2.10.1'

然后我们来写第一个例子。假设你有个简单的用户类：

public class User {
    private String name;
    private int age;
    private String email;
    
    // 构造函数、getter、setter省略...
}

Java对象转JSON（序列化）：

Gson gson = new Gson();
User user = new User("张三", 25, "zhangsan@example.com");
String json = gson.toJson(user);
System.out.println(json);
// 输出：{"name":"张三","age":25,"email":"zhangsan@example.com"}

JSON转Java对象（反序列化）：

String json = "{\"name\":\"李四\",\"age\":30,\"email\":\"lisi@example.com\"}";
User user = gson.fromJson(json, User.class);
System.out.println(user.getName()); // 输出：李四

就这么简单！是不是感觉比想象中容易很多？

深入理解：处理复杂数据结构

集合类型的处理

实际开发中，你经常需要处理列表、数组这样的集合类型。Gson处理起来也很轻松：

// List转JSON
List<User> userList = Arrays.asList(
    new User("张三", 25, "zhangsan@example.com"),
    new User("李四", 30, "lisi@example.com")
);
String json = gson.toJson(userList);

但是JSON转List就稍微复杂一点（这里有个小坑要注意！）：

// 错误的方式（会报错）
List<User> users = gson.fromJson(json, List<User>.class); // 编译错误！

// 正确的方式
Type listType = new TypeToken<List<User>>(){}.getType();
List<User> users = gson.fromJson(json, listType);

为什么会这样？因为Java的泛型擦除机制。运行时JVM无法知道List里装的是什么类型，所以需要用TypeToken来明确指定。

嵌套对象的处理

现实中的数据结构往往比较复杂，对象里包含对象是常有的事。比如一个部门类包含多个员工：

public class Department {
    private String name;
    private List<User> employees;
    // 构造函数、getter、setter省略...
}

Gson处理嵌套对象简直是小菜一碟：

Department dept = new Department("技术部", userList);
String json = gson.toJson(dept);
// Gson会自动递归处理所有嵌套对象

Department parsedDept = gson.fromJson(json, Department.class);

高级技巧：让Gson更强大

自定义字段名称

有时候JSON字段名和Java属性名不一致。比如API返回的是snake_case，但Java习惯用camelCase：

public class ApiResponse {
    @SerializedName("user_name")
    private String userName;
    
    @SerializedName("created_at")
    private String createdAt;
}

排除某些字段

有些敏感字段（比如密码）不想序列化到JSON里：

public class User {
    private String name;
    
    @Expose(serialize = false)
    private String password; // 这个字段不会出现在JSON中
    
    private transient String tempData; // transient字段也会被忽略
}

记得在创建Gson时启用Expose注解：

Gson gson = new GsonBuilder()
    .excludeFieldsWithoutExposeAnnotation()
    .create();

自定义日期格式

默认情况下，Gson对Date类型的处理可能不符合你的预期：

Gson gson = new GsonBuilder()
    .setDateFormat("yyyy-MM-dd HH:mm:ss")
    .create();

美化JSON输出

调试时想让JSON更容易阅读？用这个：

Gson gson = new GsonBuilder()
    .setPrettyPrinting()
    .create();

实战案例：构建一个完整的配置文件读取器

让我们用Gson做个实际的小项目。假设你要为应用程序创建一个配置文件读取器：

public class AppConfig {
    @SerializedName("app_name")
    private String appName;
    
    @SerializedName("database")
    private DatabaseConfig database;
    
    @SerializedName("redis")
    private RedisConfig redis;
    
    // getter/setter省略...
}

public class DatabaseConfig {
    private String host;
    private int port;
    private String username;
    private String password;
    // getter/setter省略...
}

public class RedisConfig {
    private String host;
    private int port;
    private int timeout;
    // getter/setter省略...
}

配置文件（config.json）：

{
  "app_name": "我的应用",
  "database": {
    "host": "localhost",
    "port": 3306,
    "username": "root",
    "password": "123456"
  },
  "redis": {
    "host": "localhost",
    "port": 6379,
    "timeout": 5000
  }
}

读取配置的工具类：

public class ConfigReader {
    private static final Gson gson = new GsonBuilder()
        .setPrettyPrinting()
        .create();
    
    public static AppConfig loadConfig(String filePath) {
        try {
            String json = Files.readString(Paths.get(filePath));
            return gson.fromJson(json, AppConfig.class);
        } catch (Exception e) {
            throw new RuntimeException("配置文件读取失败！", e);
        }
    }
    
    public static void saveConfig(AppConfig config, String filePath) {
        try {
            String json = gson.toJson(config);
            Files.writeString(Paths.get(filePath), json);
        } catch (Exception e) {
            throw new RuntimeException("配置文件保存失败！", e);
        }
    }
}

使用起来超级简单：

// 读取配置
AppConfig config = ConfigReader.loadConfig("config.json");
System.out.println("应用名称：" + config.getAppName());

// 修改配置
config.getDatabase().setPassword("newPassword");

// 保存配置
ConfigReader.saveConfig(config, "config.json");

性能优化小贴士

虽然Gson已经很快了，但在高并发场景下还是有一些优化技巧：

复用Gson实例

Gson对象是线程安全的，而且创建成本相对较高。最好创建一个全局实例复用：

public class JsonUtils {
    private static final Gson GSON = new GsonBuilder()
        .setDateFormat("yyyy-MM-dd HH:mm:ss")
        .create();
    
    public static String toJson(Object obj) {
        return GSON.toJson(obj);
    }
    
    public static <T> T fromJson(String json, Class<T> clazz) {
        return GSON.fromJson(json, clazz);
    }
}

使用流式API处理大文件

如果要处理特别大的JSON文件，可以考虑使用Gson的流式API：

// 读取大型JSON数组
JsonReader reader = new JsonReader(new FileReader("large-file.json"));
reader.beginArray();
while (reader.hasNext()) {
    User user = gson.fromJson(reader, User.class);
    // 处理单个用户对象
}
reader.endArray();
reader.close();

常见问题和解决方案

问题1：空指针异常

如果JSON中某个字段为null，而你的Java类中对应字段是基本类型，就会出问题：

// 危险的写法
private int age; // 如果JSON中age为null，会抛异常

// 安全的写法
private Integer age; // 使用包装类型

问题2：字段名不匹配

JSON字段名和Java属性名不一致时，记得用@SerializedName注解：

@SerializedName("user_id")
private String userId;

问题3：循环引用

如果对象之间存在循环引用（A引用B，B又引用A），Gson会抛出StackOverflowError。解决方法是用@Expose注解排除某些字段，或者重新设计数据结构。

总结

Gson作为一个成熟的JSON处理库，真的是Java开发者的好伙伴。它的简洁API让JSON处理变得轻松愉快，强大的功能又能应对各种复杂场景。

掌握了这些基础知识和高级技巧，你就可以在项目中自信地使用Gson了。记住几个关键点：

简单场景直接用toJson()和fromJson()
复杂泛型用TypeToken
合理使用注解控制序列化行为
复用Gson实例提升性能

最后想说，学习新技术最好的方法就是动手实践。赶紧在你的项目里试试Gson吧，相信你会爱上它的便捷和强大！