Java小白踩坑录 - 如何设计不用后期升级的客户端API?

简介: Java小白踩坑录 - 如何设计不用后期升级的客户端API?

image.png

最近小王比较烦,因甲方大爷的需求变更,提供给国企软件中引用的一个 jar 中的常量发生了变化,他们更新了 jar 包,但甲方将新 jar 包替换掉旧的 jar 包,现在系统出现执行异常!该国企限令必须尽快找到问题并解决掉!

为了防止信息泄露,我们模拟一下这个场景

publicclassBinaryCompatibilityTest {
publicstaticvoidmain(String[] args) {
System.out.println(DefineConstants.FIRST+" "+DefineConstants.SECOND+" "+DefineConstants.THIRD);
 }
}

其中 DefineConstants 来自甲方对乙方的引用

importcom.test.constants.Words;
publicclassDefineConstants {
privateDefineConstants() { }; // UninstantiablepublicstaticfinalStringFIRST=Words.FIRST;
publicstaticfinalStringSECOND=Words.SECOND;
publicstaticfinalStringTHIRD=Words.THIRD;
}

其中,Words 是引用的公用 jar 包。

image.png

类实现如下

packagecom.test.constants;
publicclassWords {
privateWords() {
 }; // UninstantiablepublicstaticfinalStringFIRST="the";
publicstaticfinalStringSECOND=null;
publicstaticfinalStringTHIRD="set";
}

原先打印结果为:

the null set

现在乙方小王修改了 jar 包后,代码变成了 package com.test.constants;

publicclassWords {
privateWords() {
 }; // UninstantiablepublicstaticfinalStringFIRST="physics";
publicstaticfinalStringSECOND="chemistry";
publicstaticfinalStringTHIRD="biology";
}

他将重新打包后的 jar 包传给甲方,让甲方在 tomcat 上替换原来的 jar 包,结果运行后打印的结果却为:

the chemistry set

小白百思不得其解。

反复确认了 jar 包是否正确,都是最新的 jar 包。

项目经理万般无奈之下,只好请出半退隐的技术大神扫地僧,并答应扫地僧 1w/d 的辛苦费。

老司机了解了情况后,很快就找到了原因,通过 jd-gui 反编译了代码给小白看:image.png替换了 jar 包后,DefineConstants 并没有被重新编译,导致 FIRST 和 THIRD 的结果没有发生改变,但因 SECOND 本身为 null,在编译期常量表达式(compile-time constant expression) [JLS15.28] 的精确定义中找到。它的定义太长了,就不在这里写出来了,但是理解这个程序的行为的关键是 null 不是一个编译期常量表达式。运行时就会执行新的结果:chemistry

解决办法是

1.需要重新编译 DefineConstants 后,替换到新的 class

2.重新编译整个项目的打包文件,提供新的包文件替换旧的打包文件

第一个方案

优点: 线上改动小,影响小,速度快

缺点:只能解决当前问题,如果项目中还有别的地方引用这个变量,将还会出错。

第二个方案

优点:从根本上解决问题

缺点:线上影响稍微大一些。

小白可是个勤奋好学的家伙,项目搞定后请扫地僧吃饭喝酒,趁扫地僧酒醉,趁机问解决这个问题的诀窍,扫地僧喝迷糊后道出了本质:

原来 Java 考虑到升级的问题,有二进制兼容性规范。。。。。。。。。

因扫地僧喝的有点多,描述的不是很清楚,小王只记住了在 JSL 规范了有明确的描述。


目录
相关文章
|
3月前
|
Java API 数据处理
Java新特性:使用Stream API重构你的数据处理
Java新特性:使用Stream API重构你的数据处理
|
3月前
|
Java 大数据 API
Java Stream API:现代集合处理与函数式编程
Java Stream API:现代集合处理与函数式编程
245 100
|
3月前
|
Java API 数据处理
Java Stream API:现代集合处理新方式
Java Stream API:现代集合处理新方式
278 101
|
3月前
|
并行计算 Java 大数据
Java Stream API:现代数据处理之道
Java Stream API:现代数据处理之道
246 101
|
4月前
|
存储 Java API
Java Stream API:现代数据处理之道
Java Stream API:现代数据处理之道
369 188
|
4月前
|
存储 Java API
Java Stream API:现代数据处理之道
Java Stream API:现代数据处理之道
281 92
|
3月前
|
安全 Java API
使用 Java 构建强大的 REST API 的四个基本技巧
本文结合探险领域案例,分享Java构建REST API的四大核心策略:统一资源命名、版本控制与自动化文档、安全防护及标准化异常处理,助力开发者打造易用、可维护、安全可靠的稳健API服务。
207 2
|
3月前
|
存储 数据可视化 Java
Java Stream API 的强大功能
Java Stream API 是 Java 8 引入的重要特性,它改变了集合数据的处理方式。通过声明式语法,开发者可以更简洁地进行过滤、映射、聚合等操作。Stream API 支持惰性求值和并行处理,提升了代码效率和可读性,是现代 Java 开发不可或缺的工具。
Java Stream API 的强大功能
|
4月前
|
安全 Java API
Java日期时间API:从Date到Java.time
本文深入解析了Java 8中引入的全新日期时间API,涵盖LocalDate、LocalTime、LocalDateTime、ZonedDateTime等核心类的使用,以及时间调整、格式化、时区处理和与旧API的互操作。通过实例对比,展示了新API在可变性、线程安全与易用性方面的显著优势,并提供迁移方案与实战技巧,助你掌握现代Java时间处理的最佳实践。
|
4月前
|
存储 NoSQL Java
Java Stream API:集合操作与并行处理
Stream API 是 Java 8 提供的集合处理工具,通过声明式编程简化数据操作。它支持链式调用、延迟执行和并行处理,能够高效实现过滤、转换、聚合等操作,提升代码可读性和性能。