JSON转换“驼峰”转“下划线”，阿里巴巴包搞定

2023-07-09 20:54:12

将 Java 集合转换为 JSON 字符串：深入剖析阿里巴巴的 FastJSON

简介

在日常的 Java 开发中，我们经常需要将 Java 对象或集合转换为 JSON 字符串。阿里巴巴的 FastJSON 是一个流行的高性能 JSON 处理库，可以帮助我们轻松高效地完成此任务。本文将深入探讨如何使用 FastJSON 将 Java 集合转换为 JSON 字符串，并提供详细的代码示例和常见问题解答。

1. 引入 FastJSON

首先，我们需要将 FastJSON 添加到我们的 Java 项目中。我们可以使用 Maven 或 Gradle 等包管理工具来实现这一点。在 Maven 中，添加以下依赖项到您的 pom.xml 文件：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>2.0.10</version>
</dependency>

在 Gradle 中，将以下依赖项添加到您的 build.gradle 文件：

dependencies {
    implementation 'com.alibaba:fastjson:2.0.10'
}

2. 创建 Java 集合对象

接下来，我们需要创建一个要转换为 JSON 字符串的 Java 集合对象。为了演示，我们创建一个包含用户信息的简单 Java 类：

public class User {

    private String userName;
    private Long userId;
    private Date createTime;

    // getters and setters
}

然后，我们可以创建一个包含用户信息的集合：

List<User> users = new ArrayList<>();
users.add(new User("yM", 12, new Date()));
users.add(new User("John Doe", 13, new Date()));
users.add(new User("Jane Smith", 14, new Date()));

3. 转换为 JSON 字符串

现在，我们可以使用 FastJSON 将集合对象转换为 JSON 字符串。我们可以使用以下代码来实现此目的：

String jsonString = JSON.toJSONString(users);

这将生成以下 JSON 字符串：

[
  {
    "userName": "yM",
    "userId": 12,
    "createTime": 1653568420000
  },
  {
    "userName": "John Doe",
    "userId": 13,
    "createTime": 1653568420000
  },
  {
    "userName": "Jane Smith",
    "userId": 14,
    "createTime": 1653568420000
  }
]

4. 驼峰式到下划线式键的转换

默认情况下，FastJSON 会将 Java 对象的驼峰式键转换为 JSON 字符串中的小写键。然而，我们可以通过配置 JSON.defaultGeneratorConfig.setPropertyNamingStrategy 来将驼峰式键转换为下划线式键：

JSON.defaultGeneratorConfig.setPropertyNamingStrategy(PropertyNamingStrategy.SnakeCase);

现在，我们可以再次将集合对象转换为 JSON 字符串：

String jsonString = JSON.toJSONString(users);

这将生成以下 JSON 字符串：

[
  {
    "user_name": "yM",
    "user_id": 12,
    "create_time": 1653568420000
  },
  {
    "user_name": "John Doe",
    "user_id": 13,
    "create_time": 1653568420000
  },
  {
    "user_name": "Jane Smith",
    "user_id": 14,
    "create_time": 1653568420000
  }
]

5. 格式化时间

默认情况下，FastJSON 会将 Java 对象的 Date 类型转换为 JSON 字符串中的时间戳。然而，我们可以通过配置 JSON.defaultGeneratorConfig.setDateFormat 来格式化时间：

JSON.defaultGeneratorConfig.setDateFormat("yyyy-MM-dd HH:mm:ss");

现在，我们可以再次将集合对象转换为 JSON 字符串：

String jsonString = JSON.toJSONString(users);

这将生成以下 JSON 字符串：

[
  {
    "user_name": "yM",
    "user_id": 12,
    "create_time": "2023-05-23 09:33:40"
  },
  {
    "user_name": "John Doe",
    "user_id": 13,
    "create_time": "2023-05-23 09:33:40"
  },
  {
    "user_name": "Jane Smith",
    "user_id": 14,
    "create_time": "2023-05-23 09:33:40"
  }
]

6. 注意事项

在使用 FastJSON 时，需要考虑以下几点：

确保使用最新版本的 FastJSON。
在将集合对象转换为 JSON 字符串之前，请务必配置好 JSON.defaultGeneratorConfig。
JSON 字符串中的键是区分大小写的。
时间格式化模式可以使用任何符合 SimpleDateFormat 语法的格式。

7. 代码示例

以下是本文中所述代码的示例：

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.PropertyNamingStrategy;
import com.alibaba.fastjson.serializer.SerializeConfig;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

public class Main {

    public static void main(String[] args) {

        // 创建 Java 集合对象
        List<User> users = new ArrayList<>();
        users.add(new User("yM", 12, new Date()));
        users.add(new User("John Doe", 13, new Date()));
        users.add(new User("Jane Smith", 14, new Date()));

        // 配置 JSON.defaultGeneratorConfig
        JSON.defaultGeneratorConfig.setPropertyNamingStrategy(PropertyNamingStrategy.SnakeCase);
        JSON.defaultGeneratorConfig.setDateFormat("yyyy-MM-dd HH:mm:ss");

        // 将集合对象转换为 JSON 字符串
        String jsonString = JSON.toJSONString(users);

        // 打印 JSON 字符串
        System.out.println(jsonString);
    }

    private static class User {

        private String userName;
        private Long userId;
        private Date createTime;

        // getters and setters
    }
}

输出结果：

[
  {
    "user_name": "yM",
    "user_id": 12,
    "create_time": "2023-05-23 09:33:40"
  },
  {
    "user_name": "John Doe",
    "user_id": 13,
    "create_time": "2023-05-23 09:33:40"
  },
  {
    "user_name": "Jane Smith",
    "user_id": 14,
    "create_time": "2023-05-23 09:33:40"
  }
]

结论

FastJSON 是一个强大的工具，可以轻松高效地将 Java 集合转换为 JSON 字符串。通过自定义配置，我们可以控制 JSON 字符串中键的格式、时间的格式化以及其他方面。希望本文对您使用 FastJSON 处理 Java 集合有所帮助。

常见问题解答

FastJSON 与 Jackson 的区别是什么？

FastJSON 和 Jackson 都是流行的 JSON 处理库，但它们在性能和功能方面有一些差异。FastJSON 通常比 Jackson 更快，尤其是在处理大型数据集时。Jackson 提供了更多高级功能，例如支持 JAXB 注释和树形模型。

如何将 JSON 字符串转换为 Java 集合？

可以使用 JSON.parseArray(jsonString, User.class) 将 JSON 字符串转换为 Java 集合。这里，jsonString 是要转换的 JSON 字符串，User.class 是集合中元素的类型。

如何处理 JSON 中的嵌套对象？

可以使用 JSON.parseObject(jsonString, UserWithNestedObject.class) 将 JSON 中的嵌套对象转换为 Java 对象。这里，jsonString 是要转换的 JSON 字符串，UserWithNestedObject.class 是嵌套对象的 Java 类。