Long类型参数传到前端精度丢失的解决方案

时间:2022-08-05 13:26:59
    由于公司数据库表的id是利用雪花算法生成的,所以实体类里面定义的数据类型为Long。但是这个数据传到前端时,发生了精度丢失的现象。本文记录了从java后端的角度如何解决这个精度丢失的问题,便于自己后续查阅。

一、问题的描述

    前端通过ajax请求后端接口,返回json数据,然后将数据渲染到一个表格中。突然发现表格中id这一列出现了精度丢失的现象,这精度丢失是由前端引起的。

二、问题的解决

(1)提出方案
    在后端代码中将Long类型改为String类型即可,但是由于采用的SpringMVC框架,可简单的做到统一处理。在输出到页面的Json转换器里面做统一处理,对象序列化成json时,将Long类型变成String类型就可以了。
(2)查询资料
    由于公司里面用的是FastJson的消息转换器,因此我们只需要扩展下FastJsonHttpMessageConverter这个类。
    由于我们需要在fastJson在将对象序列化成Json时做处理,因此先了解下FastJson的SerializeFilter接口。该接口有好多子接口,不同类型的子接口的作用是不同的,具体如下:
SerializeFilter是通过编程扩展的方式定制序列化。fastjson支持6种SerializeFilter,用于不同场景的定制序列化。具体如下:

PropertyPreFilter 根据PropertyName判断是否序列化
PropertyFilter 根据PropertyName和PropertyValue来判断是否序列化
NameFilter 修改Key,如果需要修改Key,process返回值则可
ValueFilter 修改Value
BeforeFilter 序列化时在最前添加内容
AfterFilter 序列化时在最后添加内容
x
 
1
SerializeFilter是通过编程扩展的方式定制序列化。fastjson支持6种SerializeFilter,用于不同场景的定制序列化。具体如下:
2

3
PropertyPreFilter 根据PropertyName判断是否序列化
4
PropertyFilter 根据PropertyName和PropertyValue来判断是否序列化
5
NameFilter 修改Key,如果需要修改Key,process返回值则可
6
ValueFilter 修改Value
7
BeforeFilter 序列化时在最前添加内容
8
AfterFilter 序列化时在最后添加内容
(3)实战代码
    • <1>自定义序列化Filter
    由于我们需要在对象序列化成json的阶段,把Long类型的Value变成String类型,因此先写一个ValueFilter的实现类。在这实现类里面,我们把数据类型为Long的数据的Value给修改成String类型。具体代码如下:
package com.kangxiinfo.wechat.common.fastjson;
import com.alibaba.fastjson.serializer.ValueFilter; /**
* Long类型变成String类型——json序列化Filter
* @author ZENG.XIAO.YAN
* @time 2018-11-08 14:50:19
* @version v1.0
*/
public class LongToStringSerializeFilter implements ValueFilter { @Override
public Object process(Object object, String name, Object value) {
if (value != null) {
// 当value不为null时,如果value是Long类型的就改成String
if (value instanceof Long) {
return value.toString();
}
}
return value;
} }
 
1
package com.kangxiinfo.wechat.common.fastjson;
2
import com.alibaba.fastjson.serializer.ValueFilter;
3

4
/**
5
 * Long类型变成String类型——json序列化Filter
6
 * @author ZENG.XIAO.YAN
7
 * @time   2018-11-08 14:50:19
8
 * @version  v1.0
9
 */
10
public class LongToStringSerializeFilter implements ValueFilter {
11

12
    @Override
13
    public Object process(Object object, String name, Object value) {
14
        if (value != null) {
15
            // 当value不为null时,如果value是Long类型的就改成String
16
            if (value instanceof Long) {
17
                return value.toString();
18
            }
19
        }
20
        return value;
21
    }
22
    
23
}

    • <2>自定义JsonHttpMessageConverter
    直接继承FastJsonHttpMessageConverter这个类,然后重写writeInternal这个方法。在writeInternal方法里面进行对象序列成json串时,传入我们上面自定义的序列化Filter。具体代码如下:
package com.kangxiinfo.wechat.common.fastjson;
import java.io.IOException;
import java.io.OutputStream;
import java.nio.charset.Charset;
import org.springframework.http.HttpOutputMessage;
import org.springframework.http.converter.HttpMessageNotWritableException;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter; public class CustomFastJsonHttpMessageConverter extends FastJsonHttpMessageConverter {
public final static Charset UTF8 = Charset.forName("UTF-8");
private Charset charset = UTF8;
private SerializerFeature[] features = new SerializerFeature[0];
/** 自定义的filter */
private LongToStringSerializeFilter longToStringSerializeFilter = new LongToStringSerializeFilter(); public CustomFastJsonHttpMessageConverter() {
super();
} @Override
protected boolean supports(Class<?> clazz) {
return true;
} public Charset getCharset() {
return this.charset;
} public void setCharset(Charset charset) {
this.charset = charset;
} public SerializerFeature[] getFeatures() {
return features;
} public void setFeatures(SerializerFeature... features) {
this.features = features;
} // 重写这个方法
@Override
protected void writeInternal(Object obj, HttpOutputMessage outputMessage)
throws IOException, HttpMessageNotWritableException {
OutputStream out = outputMessage.getBody();
// 转json时 加入自定义的Filter
String text = JSON.toJSONString(obj, longToStringSerializeFilter, features);
byte[] bytes = text.getBytes(charset);
out.write(bytes);
}
}
 
1
package com.kangxiinfo.wechat.common.fastjson;
2
import java.io.IOException;
3
import java.io.OutputStream;
4
import java.nio.charset.Charset;
5
import org.springframework.http.HttpOutputMessage;
6
import org.springframework.http.converter.HttpMessageNotWritableException;
7
import com.alibaba.fastjson.JSON;
8
import com.alibaba.fastjson.serializer.SerializerFeature;
9
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;
10

11
public class CustomFastJsonHttpMessageConverter extends FastJsonHttpMessageConverter {
12
    public final static Charset UTF8 = Charset.forName("UTF-8");
13
    private Charset charset = UTF8;
14
    private SerializerFeature[] features = new SerializerFeature[0];
15
    /** 自定义的filter */
16
    private LongToStringSerializeFilter longToStringSerializeFilter = new LongToStringSerializeFilter();
17

18
    public CustomFastJsonHttpMessageConverter() {
19
        super();
20
    }
21

22
    @Override
23
    protected boolean supports(Class<?> clazz) {
24
        return true;
25
    }
26

27
    public Charset getCharset() {
28
        return this.charset;
29
    }
30

31
    public void setCharset(Charset charset) {
32
        this.charset = charset;
33
    }
34

35
    public SerializerFeature[] getFeatures() {
36
        return features;
37
    }
38

39
    public void setFeatures(SerializerFeature... features) {
40
        this.features = features;
41
    }
42

43
    
44
    // 重写这个方法
45
    @Override
46
    protected void writeInternal(Object obj, HttpOutputMessage outputMessage)
47
            throws IOException, HttpMessageNotWritableException {
48
        OutputStream out = outputMessage.getBody();
49
        // 转json时 加入自定义的Filter
50
        String text = JSON.toJSONString(obj, longToStringSerializeFilter, features);
51
        byte[] bytes = text.getBytes(charset);
52
        out.write(bytes);
53
    }
54
}
55

    • <3>在SpringMVC配置文件中配置使用我们自定义的Json转换器
    配置的具体代码如下:
     <mvc:annotation-driven>
<mvc:message-converters register-defaults="false">
<!-- 注册我们扩展了的fastjson转换器 -->
<bean class="com.kangxiinfo.wechat.common.fastjson.CustomFastJsonHttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=UTF-8</value>
<value>application/json;charset=UTF-8</value>
<value>text/plain;charset=UTF-8</value>
<value>application/x-www-form-urlencoded;charset=UTF-8</value>
</list>
</property>
<property name="features">
<list>
<value>WriteMapNullValue</value>
<value>WriteNullListAsEmpty</value>
<value>WriteNullStringAsEmpty</value>
<value>WriteNullNumberAsZero</value>
</list>
</property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>
 
1
     <mvc:annotation-driven>
2
        <mvc:message-converters register-defaults="false">
3
            <!-- 注册我们扩展了的fastjson转换器 -->
4
            <bean class="com.kangxiinfo.wechat.common.fastjson.CustomFastJsonHttpMessageConverter">
5
                <property name="supportedMediaTypes">
6
                    <list>
7
                        <value>text/html;charset=UTF-8</value>
8
                        <value>application/json;charset=UTF-8</value>
9
                        <value>text/plain;charset=UTF-8</value>
10
                        <value>application/x-www-form-urlencoded;charset=UTF-8</value>                        
11
                    </list>
12
                </property>
13
                <property name="features">
14
                    <list>
15
                        <value>WriteMapNullValue</value>
16
                        <value>WriteNullListAsEmpty</value>
17
                        <value>WriteNullStringAsEmpty</value>
18
                        <value>WriteNullNumberAsZero</value>
19
                    </list>
20
                </property>
21
            </bean>
22
        </mvc:message-converters>
23
    </mvc:annotation-driven>

三、小结

(1)Long类型数据传到前端精度丢失时,可以将Long类型转成String类型再输出到前端就不会丢失精度
(2)可以通过扩展SpringMVC的消息转换器,全局处理这种Long类型数据精度丢失的问题