在阅读《阿里巴巴Java开发手册》时,发现有一条关于二方库依赖中接口返回值不允许使用枚举类型的规约,具体内容如下:
在谈论为什么之前先来科普下什么是二方库,二方库也称作二方包,一般指公司内部发布到中央仓库,可供公司内部其他应用依赖的库。
那么一方库便是本工程内部子项目模块依赖的库;三方库为公司之外的开源库,比如像fastjson、easyexcel这种。
下面我们就通过一个例子来看下为什么阿里巴巴不允许返回枚举类型或者包含枚举类型的POJO对象。
比如星巴克提供了0.0.1版本的二方库,定义了一个Starbucks类,里面包含了枚举类型的SizeEnum,里面分别是中杯、大杯、特大杯。
定义了一个服务类,实现了根据id获取星巴克的方法:
然后,星巴克的门店引入0.0.1这个版本jar包,然后卖的好好的:
有一天,老罗说要那个中等大小的中杯拿铁,但是服务员说那是大杯,经过一番争论,罗老师很是生气。
于是星巴克升级到了0.0.2版本二方库,在枚举类SizeEnum中新增了小杯,升级后的枚举类如下:
同时服务类的接口方法也做了相应修改:
由于星巴克的门店比较多,有的还不知道这个新加的需求,因此返回结果中出现了SHORT,但是0.0.1版本的二方库中没有小杯啊,所以就出问题了,也就是序列化失败。
通过这个例子,我相信大家对枚举类型作为返回结果有了一定的理解,下面引用孤尽大佬在知乎的回答:
由于升级原因,导致双方的枚举类不尽相同,在接口解析,类反序列化时出现异常。Java中出现的任何元素,在Gosling的角度都会有背后的思考和逻辑,比如:接口、抽象类、注解、和本文提到的枚举。枚举有好处,类型安全,清晰直接,还可以使用等号来判断,也可以用在switch中。它的劣势也是明显的,就是不要扩展。可是为什么在返回值和参数进行了区分呢,如果不兼容,那么两个都有问题,怎么允许参数可以有枚举。当时的考虑,如果参数也不能用,那么枚举几乎无用武之地了。参数输出,毕竟是本地决定的,你本地有的,传送过去,向前兼容是不会有问题的。但如果是接口返回,就比较恶心了,因为解析回来的这个枚举值,可能本地还没有,这时就会抛出序列化异常。比如:你的本地枚举类,有一个天气Enum:SUNNY,RAINY,CLOUDY,如果根据天气计算心情的方法:guess(WeatcherEnumxx),传入这三个值都是可以的。返回值:Weatherguess(参数),那么对方运算后,返回一个SNOWY,本地枚举里没有这个值,傻眼了。
对了,在这里说一下,我目前是在职Java开发,如果你现在正在学习Java,了解Java,渴望成为一名合格的Java开发工程师,在入门学习Java的过程当中缺乏基础入门的视频教程,可以关注并私信我:0获取。我这里有最新的Java基础全套视频教程。
文章为作者独立观点,不代表 股票程序化软件自动交易接口观点