Preventing Gson from Expressing Integers as Floats

1. 引言

Google开发的Gson库是Java对象与JSON格式之间序列化和反序列化的理想选择。在处理对象时，我们通常会遇到Gson将整数视为浮点数的问题。

本文将探讨为什么Gson会将整数视为浮点数，并提供一个解决方案来防止这种情况发生。

2. 问题定义

Gson将Java对象序列化为JSON。默认情况下，为了更精确地表示，Gson将整数序列化为浮点数。看下面的例子：

public String jsonString= "[{\"id\":4077395,\"field_id\":242566,\"body\":\"\"}, " +
  "{\"id\":4077398,\"field_id\":242569,\"body\":[[273019,0],[273020,1],[273021,0]]}, " +
  "{\"id\":4077399,\"field_id\":242570,\"body\":[[273022,0],[273023,1],[273024,0]]}]";

这里定义了一个名为jsonString的JSON字符串，它代表一个对象数组。这个JSON数组有不同字段，如id, field_id和body。

现在，我们将使用Gson库将JSON字符串反序列化为一个List类型的Hashtable<String, Object>对象。

ArrayList<Hashtable<String, Object>> responses;
Type ResponseList = new TypeToken<ArrayList<Hashtable<String, Object>>>() {}.getType();
responses = new Gson().fromJson(jsonString, ResponseList);

在这里，我们声明了一个名为responses的ArrayList，其中包含Hashtable类型的元素，带有String键和Object值。此外，我们利用Gson库将jsonString反序列化为一个Hashtables列表。

最后，我们使用TypeToken在反序列化过程中获取泛型类型信息。

responses将被格式化为：

[{
    body = ,
    field_id = 242566.0,
    id = 4077395.0
}, {
    body = [
        [273019.0, 0.0],
        [273020.0, 1.0],
        [273021.0, 0.0]
    ],
    field_id = 242569.0,
    id = 4077398.0
}, {
    body = [
        [273022.0, 0.0],
        [273023.0, 1.0],
        [273024.0, 0.0]
    ],
    field_id = 242570.0,
    id = 4077399.0
}]

请注意，Gson将整数表示为浮点数。

3. Gson中的默认数字策略

Gson的默认数字策略旨在在保留精度和灵活性之间取得平衡。将整数转换为浮点数的决定基于JSON缺乏明确区分整数和浮点数类型的机制。因此，Gson选择了一种默认策略，以确保数值在序列化过程中的精度。

然而，这种默认行为可能与特定需求或偏好不符，特别是在需要整数在JSON表示中保持不变的情况下。

4. 使用setObjectToNumberStrategy()方法

通过setObjectToNumberStrategy()方法，我们可以完全控制在反序列化过程中对象到数字转换机制的功能。

让我们通过一个示例来探索这一能力：

public static String expectedOutput ="[{body=, field_id=242566, id=4077395}, " +
  "{body=[[273019, 0], [273020, 1], [273021, 0]], field_id=242569, id=4077398}, " +
  "{body=[[273022, 0], [273023, 1], [273024, 0]], field_id=242570, id=4077399}]";

@Test
public void givenJsonString_whenUsingsetObjectToNumberStrategyMethod_thenValidateOutput() {
    Gson gson = new GsonBuilder()
      .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
      .create();
    ArrayList<Hashtable<String, Object>> responses = gson.fromJson(jsonString,
      new TypeToken<ArrayList<Hashtable<String, Object>>>() {}.getType());

    assertEquals(expectedOutput, responses.toString());
}

在这里，使用setObjectToNumberStrategy()方法使我们能够设置策略，如ToNumberPolicy.LONG_OR_DOUBLE，以便Gson在处理数值时指导其行为。最后，我们使用assertEquals()方法验证转换过程。

此外，Gson中的ToNumberPolicy枚举支持处理数值的各种策略。除了我们在示例中使用的ToNumberPolicy.LONG_OR_DOUBLE之外，还有其他策略：

• ToNumberPolicy.DOUBLE_ONLY: 反序列化时将所有数值转换为double
• ToNumberPolicy.LONG_ONLY: 反序列化时将所有数值转换为long
• ToNumberPolicy.DEFAULT: 保持Gson的默认行为，将整数表示为浮点数

5. 总结

在这篇文章中，我们讨论了在Gson中遇到的问题：在序列化过程中，整数自动转换为浮点数。为了解决这个问题，我们使用了setObjectToNumberStrategy()方法。

如往常一样，本文的所有完整代码示例可在GitHub上找到此处。