您的位置 首页 java

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

在阅读《阿里巴巴Java开发手册》时,发现有一条关于二方库依赖中接口返回值不允许使用枚举类型的规约,具体内容如下:

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

在谈论为什么之前先来科普下什么是二方库, 二方库 也称作二方包,一般指公司内部发布到中央仓库,可供公司内部其他应用依赖的库(jar 包)。

那么 一方库 便是本工程内部子项目模块依赖的库; 三方库 为公司之外的开源库,比如像 fastjson、easyexcel 这种。

下面我们就通过一个例子来看下为什么阿里巴巴不允许返回枚举类型或者包含枚举类型的 POJO 对象。

比如星巴克提供了 0.0.1 版本的二方库,定义了一个 Starbucks 类,里面包含了枚举类型的 SizeEnum,里面分别是中杯、大杯、特大杯。

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

定义了一个服务类,实现了根据 id 获取星巴克的方法:

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

然后,星巴克的门店引入 0.0.1 这个版本 jar 包,然后卖的好好的:

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

有一天,老罗说要那个中等大小的中杯拿铁,但是服务员说那是大杯,经过一番争论,罗老师很是生气。

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

于是星巴克升级到了 0.0.2 版本二方库,在枚举类 SizeEnum 中新增了小杯,升级后的枚举类如下:

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

同时服务类的接口方法也做了相应修改:

为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

由于星巴克的门店比较多,有的还不知道这个新加的需求,因此返回结果中出现了 SHORT ,但是 0.0.1 版本的二方库中没有小杯啊,所以就出问题了,也就是 序列化 失败。

通过这个例子,我相信大家对枚举类型作为返回结果有了一定的理解,下面引用孤尽大佬在知乎的回答:

由于升级原因,导致双方的枚举类不尽相同,在接口解析,类反序列化时出现异常。

Java 中出现的任何元素,在 Gosling 的角度都会有背后的思考和逻辑(尽管并非绝对完美,但 Java 的顶层 抽象 已经是天才级了),比如:接口、抽象类、注解、和本文提到的枚举。枚举有好处,类型安全,清晰直接,还可以使用等号来判断,也可以用在 switch 中。它的劣势也是明显的,就是不要扩展。可是为什么在返回值和参数进行了区分呢,如果不兼容,那么两个都有问题,怎么允许参数可以有枚举。当时的考虑,如果参数也不能用,那么枚举几乎无用武之地了。参数输出,毕竟是本地决定的,你本地有的,传送过去,向前兼容是不会有问题的。但如果是接口返回,就比较恶心了,因为解析回来的这个 枚举值 ,可能本地还没有,这时就会抛出序列化异常。

比如:你的本地枚举类,有一个天气 Enum :SUNNY, RAINY, CLOUDY,如果根据天气计算心情的方法:guess(WeatcherEnum xx),传入这三个值都是可以的。返回值: Weather guess(参数),那么对方运算后,返回一个 SNOWY,本地枚举里没有这个值,傻眼了。

对了,在这里说一下,我目前是在职Java开发,如果你现在正在学习Java,了解Java,渴望成为一名合格的Java开发工程师,在入门学习Java的过程当中缺乏基础入门的视频教程,可以关注并私信我:01。获取。我这里有最新的Java基础全套视频教程。

文章来源:智云一二三科技

文章标题:为什么阿里巴巴Java开发手册中强制要求接口返回值不允许使用枚举

文章地址:https://www.zhihuclub.com/192805.shtml

关于作者: 智云科技

热门文章

网站地图