为什么阿里巴巴Java开发手册中强制要求超大整数禁止使用Long类型返回?
在阅读《阿里巴巴Java开发手册》时,发现有一条关于前后端超大整数返回的规约,具体内容如下:
这个问题在之前和前端联调的时候发生过,发现根据脚本 id 去审批的时候,状态没有变化,后来和前端沟通后,才知道这是 JavaScript 的一个坑,下面来复现下这个错误:
错误演示
创建一个 Spring Boot 项目,然后在新建一个接口,可以返回 DbScript 对象,其中 id
是由 mybatis-plus 的 IdWorker.getId
(基于 Snowflake 算法)生成的 19 位 long
类型的数值。
@RestController
@RequestMapping("/dbScrip")
public class DbScriptController {
Logger logger = LoggerFactory.getLogger(DbScriptController.class);
@RequestMapping("/info")
public DbScript getDbScript() {
DbScript dbScript = new DbScript();
// 赋予一个大整数 long 型脚本 id
long id = IdWorker.getId();
dbScript.setId(id);
logger.info("id:{}", id);
return dbScript;
}
}
接着启动服务,在浏览器上访问该接口,结果如下所示:
通过日志可以看到后端传给前端的 id
为 1304270071757017088
,但是前端拿到的却为 1304270071757017000
,其中发生了精度损失。
为什么会发生这样的情况呢?
通过开发手册,我们可以知道如果返回的数值超过 2 的 53 次方,就会转换成 JS 的 Number,此时有些数值就有可能发生精度损失。
解决方法
那如果遇到了这种情况,该如何解决呢?
不要慌,可以采取以下几种方法:
- 如果这个对象只在这个方法中用到了,可以将该属性直接从
Long
类型改为String
类型。 - 如果这个对象在很多地方都用到了,可以在序列化的时候,将
Long
类型转换成String
类型。 - 还可以添加一个新的
String
类型的属性,专门用来在前后端传输这种大整数。
第一种方法
第一种方法比较简单,直接将 Long id;
改为 String id;
,这种只适用于这个对象只在这个方法中使用了,比较局限。
第二种方法
第二种方法可以在属性上增加注解,如果使用的Jackson
,可以添加 @JsonFormat(shape = JsonFormat.Shape.STRING)
或者 @JsonSerialize(using = ToStringSerializer.class)
注解。
如果这种需要修改的情况比较多,那么逐个添加还是有点费事,那么还有什么好办法吗?
如果使用的是Jackson
,它有个配置参数 WRITE_NUMBERS_AS_STRINGS
,可以强制将所有数字全部转成字符串输出,使用方法很简单,只需要配置参数即可:spring.jackson.generator.write_numbers_as_strings=true
,这种方式的优点是使用方便,不需要调整代码;缺点是颗粒度太大,所有的数字都被转成字符串输出了,包括按照 timestamp
格式输出的时间也是如此。
那么还有什么方法能够只对 Long
类型进行处理转换成 String
类型呢?
Jackson
提供了这种支持,可以对 ObjectMapper
进行定制,具体代码如下所示:
public class JacksonConfiguration {
@Bean
public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() {
return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder
.serializerByType(Long.class, ToStringSerializer.instance)
.serializerByType(Long.TYPE, ToStringSerializer.instance);
}
}
通过定义 Jackson2ObjectMapperBuilderCustomizer
,对 Jackson2ObjectMapperBuilder
对象进行定制,对 Long
型数据进行了定制,使用ToStringSerializer
来进行序列化。
第三种方法
第三种方法就需要多一个属性,比如使用String dbScripId
,用来代替之前的 id
。
总结
本文针对《阿里巴巴Java开发手册》中的对于需要使用超大整数的场景,服务端一律使用 String
字符串类型返回,禁止使用Long
类型出发,提出了几种解决方法,大家可以根据自己的需求去选择方法,有其他解决方法的也欢迎留言讨论。
- Go1.8.4和Go1.9.1版本发布
- Javascript数组操作
- Tensorflow官方语音识别入门教程 | 附Google新语音指令数据集
- jQuery VS JavaScript原生API
- 居于H5的多文件、大文件、多线程上传解决方案
- 抛弃websocket,前端直接打通信道,webRTC搭建音视频聊天
- Golang学习-第三篇 认识Web框架
- Golang学习-第二篇 搭建一个简单的Go Web服务器
- 数据说话:Go语言的Switch和Map性能实测
- Dora.Interception, 为.NET Core度身打造的AOP框架[4]:演示几个典型应用
- Dora.Interception, 为.NET Core度身打造的AOP框架[3]:Interceptor的注册
- Dora.Interception, 为.NET Core度身打造的AOP框架:不一样的Interceptor定义方式
- Dora.Interception,为.NET Core度身打造的AOP框架:全新的版本
- ASP.NET Core的路由[4]:来认识一下实现路由的RouterMiddleware中间件
- java教程
- Java快速入门
- Java 开发环境配置
- Java基本语法
- Java 对象和类
- Java 基本数据类型
- Java 变量类型
- Java 修饰符
- Java 运算符
- Java 循环结构
- Java 分支结构
- Java Number类
- Java Character类
- Java String类
- Java StringBuffer和StringBuilder类
- Java 数组
- Java 日期时间
- Java 正则表达式
- Java 方法
- Java 流(Stream)、文件(File)和IO
- Java 异常处理
- Java 继承
- Java 重写(Override)与重载(Overload)
- Java 多态
- Java 抽象类
- Java 封装
- Java 接口
- Java 包(package)
- Java 数据结构
- Java 集合框架
- Java 泛型
- Java 序列化
- Java 网络编程
- Java 发送邮件
- Java 多线程编程
- Java Applet基础
- Java 文档注释
- 关于跨域以及Spring Boot的解决方案
- FFmpeg进行音频的解码和播放
- Gitbook 安装及使用
- MySQL 视图、过程、函数
- 基于Spring Boot + Dubbo的全链路日志追踪(二)
- 基于Spring Boot + Dubbo的全链路日志追踪(一)
- 使用C语言编写Python扩展包
- PlantUML基本使用(一)--时序图
- gRPC基本使用(一)--java与go之间的相互调用
- confd基本使用--Nginx配置自动化
- JVM自定义类加载器
- Java代理相关:JDK动态代理、CGLIB动态代理
- Tomcat CPU占用100%异常分析与处理
- Solr基本搭建及MySQL配置
- Tomcat, Jre 证书相关