json序列化时Long类型转换为String类型

将java对象序列化为json对象返回数据给前端时，js处理Long类型数据时会丢失精度，为了解决这种问题，往往给前端返回的Long类型数据要序列化为String类型，前面文章介绍过在springboot中的配置方式 json对象中对Long类型和String类型相互转换。如果接口没有走springboot配置而与其他系统通过进行交互，这时候就需要在json序列化工具内做相应的处理，依照惯例还是分别通过fastjson、gson、jackson三个常用的json序列化工具进行代码演示。

1. fastjson中可以在属性上添加注解 @JSONField(serializeUsing = ToStringSerializer.class) 实现Long类型转换为String类型：

@JSONField(serializeUsing = ToStringSerializer.class)
private Long id;

添加上面的注解后再使用fastjson进行序列化时就会把long类型转换为String类型。例如：

import com.alibaba.fastjson.annotation.JSONField;
import com.alibaba.fastjson.serializer.ToStringSerializer;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class DemoVo {

    @JSONField(serializeUsing = ToStringSerializer.class)
    private Long id;
    private String name;
}

测试序列化输出：

import com.alibaba.fastjson.JSONObject;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
public class JsonTest {

    public static void main(String[] args) {
        DemoVo data = DemoVo.builder().id(Long.MAX_VALUE).name("长整型序列化").build();
        String json = JSONObject.toJSONString(data);
        System.out.println(json);
    }
}

输出内容：

{"id":"9223372036854775807","name":"长整型序列化"}

fastjson也可以在序列化时指定序列化类型，这样就避免在所有字段上添加注解了。删除上面的实体类字段上的注解，改成下面这种方式一样可以实现相同的效果：

import com.alibaba.fastjson.JSONObject;
import com.alibaba.fastjson.serializer.SerializeConfig;
import com.alibaba.fastjson.serializer.ToStringSerializer;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
public class JsonTest {

    public static void main(String[] args) {
        DemoVo data = DemoVo.builder().id(Long.MAX_VALUE).name("长整型序列化").build();

        final SerializeConfig config = new SerializeConfig();
        config.put(Long.class, ToStringSerializer.instance);
        String json = JSONObject.toJSONString(data, config);
        System.out.println(json);
    }
}

2. jackson与fastjson类似，可以通过在属性上添加注解实现Long类型转换为String类型：

@JsonSerialize(using = ToStringSerializer.class)
private Long id;

使用jackson进行序列化测试：

import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
@Builder
public class DemoVo {

    @JsonSerialize(using = ToStringSerializer.class)
    private Long id;
    private String name;
}

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
public class JsonTest {

    public static void main(String[] args) throws JsonProcessingException {
        DemoVo data = DemoVo.builder().id(Long.MAX_VALUE).name("长整型序列化").build();

        ObjectMapper mapper = new ObjectMapper();
        String json = mapper.writeValueAsString(data);
        System.out.println(json);
    }
}

测试输出：

{"id":"9223372036854775807","name":"长整型序列化"}

jackson中还可以在序列化工具上面添加相关配置实现Long类型序列化为String，这样就不用在每一个字段上都添加相关配置。将上面实体类中的注解删除，改成下面这种方式进行测试：

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
public class JsonTest {

    public static void main(String[] args) throws JsonProcessingException {
        DemoVo data = DemoVo.builder().id(Long.MAX_VALUE).name("长整型序列化").build();

        ObjectMapper mapper = new ObjectMapper();
        // 指定字段序列化类型
        SimpleModule module = new SimpleModule();
        module.addSerializer(Long.class, ToStringSerializer.instance);
        mapper.registerModule(module);

        String json = mapper.writeValueAsString(data);
        System.out.println(json);
    }
}

3. gson与上面的两个工具对比，没有提供在字段上添加注解的方式实现序列化时类型转换，它可以通过在实例上添加相关的配置实现相同的功能。

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;

import java.io.IOException;

/**
 * @author: xingo
 * @createDate: 2023/11/30
 */
public class JsonTest {

    public static void main(String[] args) {
        DemoVo data = DemoVo.builder().id(Long.MAX_VALUE).name("长整型序列化").build();

        Gson gson = new GsonBuilder()
                .registerTypeAdapter(Long.class, new TypeAdapter<Long>() {
                    @Override
                    public void write(JsonWriter writer, Long l) throws IOException {
                        if(l != null) {
                            writer.value(String.valueOf(l));
                        } else {
                            writer.nullValue();
                        }
                    }

                    @Override
                    public Long read(JsonReader reader) throws IOException {
                        return reader.nextLong();
                    }
                })
                .create();

        String json = gson.toJson(data);
        System.out.println(json);
    }
}

输出内容：

{"id":"9223372036854775807","name":"长整型序列化"}

以上总结的几种处理方案可以在项目中灵活选择，如果要影响范围小，就选择在需要处理的字段上面添加注解的方式；如果在项目中所有用到的地方都想使用，就通过在工具类上面做相关的配置全局生效。