Long 類型數(shù)據(jù)回傳給前端，從17位開(kāi)始居然都是0？
作者：志哥聊技術(shù)
在實(shí)際的項(xiàng)目開(kāi)發(fā)中，很多服務(wù)都是純微服務(wù)開(kāi)發(fā)，利用采用 dubbo 遠(yuǎn)程調(diào)用，沒(méi)有用到SpringMVC?，在這種情況下，使用JsonUtil工具類實(shí)現(xiàn)對(duì)象序列化，可能是一個(gè)不錯(cuò)的選擇。
01、問(wèn)題描述
最近在改造業(yè)務(wù)系統(tǒng)的時(shí)候，發(fā)現(xiàn)了一個(gè)巨坑，前端 JS 在獲取后端 Long 型參數(shù)時(shí)，出現(xiàn)精度丟失！
起初，用 postman 模擬接口請(qǐng)求，都很正常，但是用瀏覽器請(qǐng)求的時(shí)候，就出現(xiàn)問(wèn)題了！
- 問(wèn)題復(fù)現(xiàn)
@RequestMapping("/queryUser")
public List<User> queryUser(){
List<User> resultList = new ArrayList<>();
User user = new User();
//賦予一個(gè)long型用戶ID
user.setId(123456789012345678L);
resultList.add(user);
return resultList;
}打開(kāi)瀏覽器請(qǐng)求接口，結(jié)果如下！
圖片
用 postman 模擬接口請(qǐng)求，結(jié)果如下！
圖片
剛開(kāi)始的時(shí)候，還真沒(méi)發(fā)現(xiàn)這個(gè)坑，結(jié)果當(dāng)進(jìn)行測(cè)試的時(shí)候，才發(fā)現(xiàn)前端傳給后端的ID，與數(shù)據(jù)庫(kù)中存的ID不一致，才發(fā)現(xiàn) JavaScript 還有這個(gè)天坑！
由于 JavaScript 中 Number 類型的自身原因，并不能完全表示 Long 型的數(shù)字，在 Long 長(zhǎng)度大于17位時(shí)會(huì)出現(xiàn)精度丟失的問(wèn)題。
當(dāng)我們把上面的用戶 ID 改成 19 位的時(shí)候，我們?cè)賮?lái)看看瀏覽器請(qǐng)求返回的結(jié)果。
//設(shè)置用戶ID，位數(shù)為19位
user.setId(1234567890123456789l);瀏覽器請(qǐng)求結(jié)果！
圖片
當(dāng)返回的結(jié)果超過(guò)17位的時(shí)候，后面的全部變成0！
02、解決辦法
遇到這種情況，應(yīng)該怎么辦呢？
- 第一種辦法：在后臺(tái)把 long 型改為 String 類型，但是工程量有點(diǎn)大，只要涉及到的地方都需要改
- 第二種辦法：使用工具進(jìn)行轉(zhuǎn)化把 long 型改為String類型，這種方法可以實(shí)現(xiàn)全局轉(zhuǎn)化（推薦）
- 第三種辦法：前端進(jìn)行處理（目前沒(méi)有很好的辦法，不推薦）
因?yàn)轫?xiàng)目涉及到的代碼非常多，所以不可能把 long 型改為 String 類型，而且使用 Long 類型的方法非常多，改起來(lái)風(fēng)險(xiǎn)非常大，所以不推薦使用！
最理想的方法，就是使用aop代理攔截所有的方法，對(duì)返回參數(shù)進(jìn)行統(tǒng)一處理，使用工具進(jìn)行轉(zhuǎn)化，過(guò)程如下！
2.1、Jackson 工具序列化對(duì)象
我們可以使用Jackson工具包來(lái)實(shí)現(xiàn)對(duì)象序列化。
- 首先在 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>- 編寫(xiě)一個(gè)轉(zhuǎn)化工具類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 {
// 對(duì)象的所有字段全部列入
objectMapper.setSerializationInclusion(JsonInclude.Include.ALWAYS);
// 取消默認(rèn)轉(zhuǎn)換timestamps形式
objectMapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, false);
// 忽略空bean轉(zhuǎn)json的錯(cuò)誤
objectMapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false);
//設(shè)置為東八區(qū)
objectMapper.setTimeZone(TimeZone.getTimeZone("GMT+8"));
// 統(tǒng)一日期格式
objectMapper.setDateFormat(new SimpleDateFormat(DATE_FORMAT));
// 反序列化時(shí),忽略在json字符串中存在, 但在java對(duì)象中不存在對(duì)應(yīng)屬性的情況, 防止錯(cuò)誤
objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
// 序列換成json時(shí),將所有的long變成string
objectMapper.registerModule(new SimpleModule().addSerializer(Long.class, ToStringSerializer.instance).addSerializer(Long.TYPE, ToStringSerializer.instance));
}
/**
* 對(duì)象序列化成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字符串反序列化成對(duì)象
* @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字符串反序列化成對(duì)象(數(shù)組)
* @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;
}
}
}- 緊接著，編寫(xiě)一個(gè)實(shí)體類Person，用于測(cè)試
@Data
public class Person implements Serializable {
private static final long serialVersionUID = 1L;
private Integer id;
//Long型參數(shù)
private Long uid;
private String name;
private String address;
private String mobile;
private Date createTime;
}- 最后，我們編寫(xiě)一個(gè)測(cè)試類測(cè)試一下效果
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));
}輸出結(jié)果如下：
圖片
其中最關(guān)鍵一行代碼，是注冊(cè)了這個(gè)轉(zhuǎn)換類，從而實(shí)現(xiàn)將所有的 long 變成 string。
// 序列換成json時(shí),將所有的long變成string
SimpleModule simpleModule = new SimpleModule();
simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
objectMapper.registerModule(simpleModule);如果想對(duì)某個(gè)日期進(jìn)行格式化，可以全局設(shè)置。
//全局統(tǒng)一日期格式
objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));也可以，單獨(dú)對(duì)某個(gè)屬性進(jìn)行設(shè)置，例如對(duì)createTime屬性格式化為yyyy-MM-dd，只需要加上如下注解即可。
@JsonFormat(pattern="yyyy-MM-dd", timeznotallow="GMT+8")
private Date createTime;工具轉(zhuǎn)化類寫(xiě)好之后，就非常簡(jiǎn)單了，只需要對(duì) aop 攔截的方法返回的參數(shù)，進(jìn)行序列化就可以自動(dòng)實(shí)現(xiàn)將所有的 long 變成 string。
2.2、SpringMVC 配置
如果是 SpringMVC 項(xiàng)目，操作也很簡(jiǎn)單。
- 自定義一個(gè)實(shí)現(xiàn)類，繼承自O(shè)bjectMapper
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">
<constructor-arg index="0" value="utf-8" />
<property name="supportedMediaTypes">
<list>
<value>application/json;charset=UTF-8</value>
<value>text/plain;charset=UTF-8</value>
</list>
</property>
</bean>
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<property name="objectMapper">
<bean class="com.example.util.CustomObjectMapper">
<property name="dateFormat">
<-對(duì)日期進(jìn)行統(tǒng)一轉(zhuǎn)化->
<bean class="java.text.SimpleDateFormat">
<constructor-arg type="java.lang.String" value="yyyy-MM-dd HH:mm:ss" />
</bean>
</property>
</bean>
</property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>2.3、SpringBoot 配置
如果是 SpringBoot 項(xiàng)目，操作也類似。
- 編寫(xiě)一個(gè)WebConfig配置類，并實(shí)現(xiàn)自WebMvcConfigurer，重寫(xiě)configureMessageConverters方法
/**
* WebMvc配置
*/
@Configuration
@Slf4j
@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
/**
*添加消息轉(zhuǎn)化類
* @param list
*/
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> list) {
MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
ObjectMapper objectMapper = jsonConverter.getObjectMapper();
//序列換成json時(shí),將所有的long變成string
SimpleModule simpleModule = new SimpleModule();
simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
objectMapper.registerModule(simpleModule);
list.add(jsonConverter);
}
}03、總結(jié)
在實(shí)際的項(xiàng)目開(kāi)發(fā)中，很多服務(wù)都是純微服務(wù)開(kāi)發(fā)，利用采用 dubbo 遠(yuǎn)程調(diào)用，沒(méi)有用到SpringMVC，在這種情況下，使用JsonUtil工具類實(shí)現(xiàn)對(duì)象序列化，可能是一個(gè)不錯(cuò)的選擇。
責(zé)任編輯：武曉燕
來(lái)源：
潘志的研發(fā)筆記
