文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

为什么阿里巴巴Java开发手册中强制要求超大整数禁止使用Long类型返回?

2024-12-24 15:30

关注

本文转载自微信公众号「武培轩」,作者武培轩 。转载本文请联系武培轩公众号。

 在阅读《阿里巴巴Java开发手册》时,发现有一条关于前后端超大整数返回的规约,具体内容如下:

这个问题在之前和前端联调的时候发生过,发现根据脚本 id 去审批的时候,状态没有变化,后来和前端沟通后,才知道这是 JavaScript 的一个坑,下面来复现下这个错误:

错误演示

创建一个 Spring Boot 项目,然后在新建一个接口,可以返回 DbScript 对象,其中 id 是由 mybatis-plus 的 IdWorker.getId(基于 Snowflake 算法)生成的 19 位 long 类型的数值。

  1. @RestController 
  2. @RequestMapping("/dbScrip"
  3. public class DbScriptController { 
  4.     Logger logger = LoggerFactory.getLogger(DbScriptController.class); 
  5.  
  6.     @RequestMapping("/info"
  7.     public DbScript getDbScript() { 
  8.         DbScript dbScript = new DbScript(); 
  9.         // 赋予一个大整数 long 型脚本 id 
  10.         long id = IdWorker.getId(); 
  11.         dbScript.setId(id); 
  12.         logger.info("id:{}", id); 
  13.         return dbScript; 
  14.     } 

接着启动服务,在浏览器上访问该接口,结果如下所示:

通过日志可以看到后端传给前端的 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 进行定制,具体代码如下所示:

  1. public class JacksonConfiguration { 
  2.  
  3.     @Bean 
  4.     public Jackson2ObjectMapperBuilderCustomizer jackson2ObjectMapperBuilderCustomizer() { 
  5.         return jacksonObjectMapperBuilder -> jacksonObjectMapperBuilder 
  6.                 .serializerByType(Long.class, ToStringSerializer.instance) 
  7.                 .serializerByType(Long.TYPE, ToStringSerializer.instance); 
  8.     } 

通过定义 Jackson2ObjectMapperBuilderCustomizer,对 Jackson2ObjectMapperBuilder 对象进行定制,对 Long 型数据进行了定制,使用ToStringSerializer来进行序列化。

第三种方法

第三种方法就需要多一个属性,比如使用String dbScripId,用来代替之前的 id。

总结

本文针对《阿里巴巴Java开发手册》中的对于需要使用超大整数的场景,服务端一律使用 String 字符串类型返回,禁止使用Long 类型出发,提出了几种解决方法,大家可以根据自己的需求去选择方法,有其他解决方法的也欢迎留言讨论。

 

来源:武培轩内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯