揭秘 Fastjson 转化 DTO 大小写问题：从根本上掌握数据映射之精髓

2023-12-31 17:50:12

Fastjson 数据映射的艺术：解决 DTO 与 JSON 大小写差异

在软件开发中，数据映射是将一种格式的数据转换为另一种格式的常见任务。例如，我们需要将数据传输对象（DTO）转换为 JSON 字符串以与第三方接口通信。在这看似简单的过程中，大小写问题可能会导致意想不到的陷阱，尤其是使用流行的 Fastjson 库时。

Fastjson 的默认行为：自动转小写

默认情况下，Fastjson 遵循 Javabean 规范，将 Javabean 属性名转换为 JSON 中的小写字母。这是因为 Javabean 规范提倡在 Java 代码中使用小写属性名。当我们使用 JSON.toJSONString() 方法将 DTO 转换为 JSON 时，属性名会被自动转换为小写。

问题根源：冲突的需求

但是，在某些情况下，第三方接口要求 JSON 中的属性名是大写的。这导致 Fastjson 的默认行为与接口要求发生冲突。例如，我们可能有一个 DTO：

public class MyDTO {

    private String name;
    private int age;
}

当使用 Fastjson 转换时，结果 JSON 如下：

{
  "name": "John",
  "age": 25
}

显然，属性名是小写的，不符合接口要求。

解决方案：定制 JSON 序列化

为了解决此问题，我们需要定制 Fastjson 的 JSON 序列化配置以覆盖默认行为。Fastjson 提供了丰富的 API 来精细控制序列化过程。我们可以通过以下步骤将 DTO 属性名转换为大写：

创建一个 JSONSerializer 实例。
添加一个 NameFilter，该过滤器将属性名转换为大写。
将 NameFilter 添加到序列化器的属性过滤器列表中。

下面是一个代码示例：

JSONSerializer serializer = new JSONSerializer();
NameFilter filter = new NameFilter() {
    @Override
    public String process(Object object, String name, Object value) {
        return name.substring(0, 1).toUpperCase() + name.substring(1);
    }
};
serializer.getPropertyFilters().add(filter);
String jsonString = serializer.toJSONString(myDTO);