踩坑吗？后端的Long型参数的大坑

1、问题描述

最近在改造内部管理系统的时候， 发现了一个巨坑，就是前端 JS 在获取后端 Long 型参数时，出现精度丢失！

起初，用 postman 模拟接口请求，都很正常，可是用浏览器请求的时候，就出现问题了！

• 问题复现

@RequestMapping("/queryUser")
public List<User> queryUser(){
    List<User> resultList = new ArrayList<>();
    User user = new User();
      //赋予一个long型用户ID
    user.setId(123456789012345678L);
    resultList.add(user);
    return resultList;
}

打开浏览器，请求接口，结果以下！

用 postman 模拟接口请求，结果以下！

刚开始的时候，还真没发现这个坑，结果当进行测试的时候，才发现前端传给后端的ID，与数据库中存的ID不一致，才发现 JavaScript 还有这个天坑！

因为 JavaScript 中 Number 类型的自身缘由，并不能彻底表示 Long 型的数字，在 Long 长度大于17位时会出现精度丢失的问题。

当咱们把上面的用户 ID 改为 19 位的时候，咱们再来看看浏览器请求返回的结果。

//设置用户ID，位数为19位user.setId(1234567890123456789l);

浏览器请求结果！

当返回的结果超过17位的时候，后面的所有变成0！

2、解决办法

遇到这种状况，应该怎么办呢？

• 第一种办法：在后台把 long 型改成String类型，可是代价有点大，只要涉及到的地方都须要改

• 第二种办法：使用工具进行转化把 long 型改成String类型，这种方法能够实现全局转化（推荐）

• 第三种办法：前端进行处理（目前没有很好的办法，不推荐）

由于项目涉及到的代码很是多，因此不可能把 long 型改成 String 类型，并且使用 Long 类型的方法很是多，改起来风险很是大，因此不推荐使用！

最理想的方法，就是使用aop代理拦截全部的方法，对返回参数进行统一处理，使用工具进行转化，过程以下！

2.一、Jackson 工具序列化对象

咱们可使用Jackson工具包来实现对象序列化。

• 首先在 maven 中添加必须的依赖

<!--jackson依赖-->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-core</artifactId>
    <version>2.9.8</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>    
    <artifactId>jackson-annotations</artifactId>    
    <version>2.9.8</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>    
    <artifactId>jackson-databind</artifactId>    
    <version>2.9.8</version>
</dependency>

• 编写一个转化工具类JsonUtil

public class JsonUtil {
    private static final Logger log = LoggerFactory.getLogger(JsonUtil.class);
    private static ObjectMapper objectMapper = new ObjectMapper();    private static final String DATE_FORMAT = "yyyy-MM-dd HH:mm:ss";
    static {        // 对象的全部字段所有列入        objectMapper.setSerializationInclusion(JsonInclude.Include.ALWAYS);        // 取消默认转换timestamps形式        objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);        // 忽略空bean转json的错误        objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);        //设置为东八区        objectMapper.setTimeZone(TimeZone.getTimeZone("GMT+8"));        // 统一日期格式        objectMapper.setDateFormat(new SimpleDateFormat(DATE_FORMAT));        // 反序列化时,忽略在json字符串中存在, 但在java对象中不存在对应属性的状况, 防止错误        objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);        // 序列换成json时,将全部的long变成string        objectMapper.registerModule(new SimpleModule().addSerializer(Long.class, ToStringSerializer.instance).addSerializer(Long.TYPE, ToStringSerializer.instance));    }
    /**     * 对象序列化成json字符串     * @param obj     * @param <T>     * @return     */    public static <T> String objToStr(T obj) {        if (null == obj) {            return null;        }
        try {            return obj instanceof String ? (String) obj : objectMapper.writeValueAsString(obj);        } catch (Exception e) {            log.warn("objToStr error: ", e);            return null;        }    }
    /**     * json字符串反序列化成对象     * @param str     * @param clazz     * @param <T>     * @return     */    public static <T> T strToObj(String str, Class<T> clazz) {        if (StringUtils.isBlank(str) || null == clazz) {            return null;        }
        try {            return clazz.equals(String.class) ? (T) str : objectMapper.readValue(str, clazz);        } catch (Exception e) {            log.warn("strToObj error: ", e);            return null;        }    }
    /**     * json字符串反序列化成对象(数组)     * @param str     * @param typeReference     * @param <T>     * @return     */    public static <T> T strToObj(String str, TypeReference<T> typeReference) {        if (StringUtils.isBlank(str) || null == typeReference) {            return null;        }
        try {            return (T) (typeReference.getType().equals(String.class) ? str : objectMapper.readValue(str, typeReference));        } catch (Exception e) {            log.warn("strToObj error", e);            return null;        }    }}

• 紧接着，编写一个实体类Person，用于测试

@Datapublic class Person implements Serializable {
    private static final long serialVersionUID = 1L;
    private Integer id;
    //Long型参数    private Long uid;    private String name;    private String address;    private String mobile;
    private Date createTime;}

• 最后，咱们编写一个测试类测试一下效果

public static void main(String[] args) {
    Person person = new Person();
    person.setId(1);    
    person.setUid(1111L);    
    person.setName("hello");    
    person.setAddress("");    
    System.out.println(JsonUtil.objToStr(person));
}

输出结果以下：

其中最关键一行代码，是注册了这个转换类，从而实现将全部的 long 变成 string。

// 序列换成json时,将全部的long变成string
SimpleModule simpleModule = new SimpleModule();
simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
objectMapper.registerModule(simpleModule);

若是想对某个日期进行格式化，能够全局设置。

//全局统一日期格式
objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd 
HH:mm:ss"));

也能够，单独对某个属性进行设置，例如对createTime属性格式化为yyyy-MM-dd，只须要加上以下注解便可。

@JsonFormat(pattern="yyyy-MM-dd", timezone="GMT+8")
private Date createTime;

工具转化类写好以后，就很是简单了，只须要对 aop 拦截的方法返回的参数，进行序列化就能够自动实现将全部的 long 变成 string。

2.二、SpringMVC 配置

若是是 SpringMVC 项目，操做也很简单。

• 自定义一个实现类，继承自ObjectMapper

package com.example.util;
/** * 继承ObjectMapper */public class CustomObjectMapper extends ObjectMapper {
    public CustomObjectMapper() {        super();        SimpleModule simpleModule = new SimpleModule();        simpleModule.addSerializer(Long.class, ToStringSerializer.instance);        simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);        registerModule(simpleModule);    }}

• 在 SpringMVC 的配置文件中加上以下配置

<mvc:annotation-driven >
    <mvc:message-converters>      
      <bean 
class="org.springframework.http.converter.StringHttpMessageConverter">
      <constructorarg index="0" value="utf8" />            
      <property name="supportedMediaTypes">                
         <list>                  
           <value>application/json;charset=UTF-8</value>                    
           <value>text/plain;charset=UTF8</value>        
         </list>           
       </property>           
      </bean>                  
      <bean 
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">            
        <property name="objectMapper">                
           <bean class="com.example.util.CustomObjectMapper">                    
              <property name="dateFormat">
                              <-对日期进行统一转化->                       
                 <bean class="java.text.SimpleDateFormat">                            
                   <constructor-arg type="java.lang.String" 
value="yyyyMMdd HH:mm:ss" />                        
                 </bean>                    
              </property>                
           </bean>          
        </property>        
     </bean>    
   </mvc:message-converters>
</mvc:annotation-driven>

2.三、SpringBoot 配置

若是是 SpringBoot 项目，操做也相似。

• 编写一个WebConfig配置类，并实现自WebMvcConfigurer，重写configureMessageConverters方法

/** * WebMvc配置 */@Configuration@Slf4j@EnableWebMvcpublic class WebConfig implements WebMvcConfigurer {
    /**     *添加消息转化类     * @param list     */    @Override    public void configureMessageConverters(List<HttpMessageConverter<?>> list) {        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();        ObjectMapper objectMapper = jsonConverter.getObjectMapper(); //序列换成json时,将全部的long变成string        SimpleModule simpleModule = new SimpleModule();        simpleModule.addSerializer(Long.class, ToStringSerializer.instance);        simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);        objectMapper.registerModule(simpleModule);        list.add(jsonConverter);    }}

3、总结

在实际的项目开发中，不少服务都是纯微服务开发，没有用到SpringMVC，在这种状况下，使用JsonUtil工具类实现对象序列化，多是一个很是好的选择。