阿里巴巴编程规范-(二) 常量定义

原创

无知的小狼

工作日志

2020/07/01 22:54

阅读数 303

【强制】不允许任何魔法值（即未经预先定义的常量）直接出现在代码中。反例： (二) 常量定义 //本例中同学 A 定义了缓存的 key，然后缓存提取的同学 B 使用了 Id#taobao 来提取，少了下划线，导致故障。 String key = "Id#taobao_" + tradeId; cache.put(key, value);
【强制】在 long 或者Long 赋值时，数值后使用大写的 L，不能是小写的 l，小写容易跟数字混淆，造成误解。说明：Long a = 2l; 写的是数字的 21，还是Long 型的 2。
【推荐】不要使用一个常量类维护所有常量，要按常量功能进行归类，分开维护。说明：大而全的常量类，杂乱无章，使用查找功能才能定位到修改的常量，不利于理解，也不利于维护。正例：缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 ConfigConsts 下。
【推荐】常量的复用层次有五层：跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。 1）跨应用共享常量：放置在二方库中，通常是 client.jar 中的 constant 目录下。 2）应用内共享常量：放置在一方库中，通常是子模块中的 constant 目录下。反例：易懂变量也要统一定义成应用内共享常量，两位工程师在两个类中分别定义了“YES”的变量：类 A 中：public static final String YES = "yes"; 类 B 中：public static final String YES = "y"; A.YES.equals(B.YES)，预期是 true，但实际返回为 false，导致线上问题。 3）子工程内部共享常量：即在当前子工程的 constant 目录下。 4）包内共享常量：即在当前包下单独的 constant 目录下。 5）类内共享常量：直接在类内部 private static final 定义。
【推荐】如果变量值仅在一个固定范围内变化用 enum 类型来定义。说明：如果存在名称之外的延伸属性应使用 enum 类型，下面正例中的数字就是延伸信息，表示一年中的第几个季节。正例： public enum SeasonEnum { SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4); private int seq; SeasonEnum(int seq) { this.seq = seq; } public int getSeq() { return seq; } }

h4cd 2023-09-21 13:19

竟然不把虚拟线程战绩写出来

troika 2023-09-24 18:32

应该学鲶鱼，润就完事了。

Luke-Skywalker-Xu 2023-09-30 19:37

我用了几天发现有bug，我像openjdk提交了issue等修复了继续用

Luke-Skywalker-Xu 2023-09-30 20:05

已经开发了很多插件

羊百万 2023-09-25 09:57

“中文文档哪里重要了，不要乱说，vue一直都是先出英文文档，开源框架很难的，有时候找找自己原因，这么多年了技术涨没涨，有没有认真学英语？”🤪

Yokesily 2023-09-24 18:34

悲哀

阳光满地 2023-10-01 01:58

呵呵

Luke-Skywalker-Xu 2023-09-30 20:00

开源软件的志愿者的招募的新闻吧，很少有途径招募。比如说QQ群之类的几乎不可能，gitee上面也不可能。只能在这边了。是一个活跃的开源项目希望有更多新人加入。

Xiao_f 2023-09-24 23:16

访问github算违法，那么中国科技不得倒退20年? "自主创新"怎么办?

Luke-Skywalker-Xu 2023-09-30 19:48

综合新闻

xiaoqibabby 2023-10-01 11:14

是我理解错了吗，这不是不需要承担售后代价的售卖吗

iman123 2023-09-20 12:34

已更新，从这一版本开始，gu已经删除，native-image已经内置了，see https://github.com/oracle/graal/issues/6855

天堂比不过家乡啦 2023-09-20 11:00

大概率事件，每个windos和苹果系统都有底层后门，移动端也是一样。安卓和linux 稍微好点不排除

思北谢Special 2023-09-22 11:20

PHP总体算一门很灵活的语言，不同于Java的呆板，对于灵活的语言，越是高手代码越精炼，越是菜鸟代码越杂乱，因为给了你足够多的灵活性，你可以胡来，灵活性排序，Java <<<< Python < PHP ~= Js < Perl < Ruby <<<< Haskell，Java这种呆板语言，很适合一个大规模团队整体协作，比如阿里这种团队，里面菜鸟高手混杂，最终高手被拉到和菜鸟一个水平，因为没有灵活性，没有发货的余地，到处都是类套类，一层层套下去，无限冗余的来完成一个PHP只需要一两个人就可以完成的项目，极大的提升了就业率，所以越庞大的团队越喜欢Java，混在里面，写一辈子，也没人看得出水平高低， PHP就不同了，一个菜鸟的PHP代码，立刻会被老鸟看出来，被踢出去，到Java里安静的混日子，动弹还在的时候，有人发了过一个java代码，涉及到两次排序，竟然是先用Java的Sort排完，然后循环来一个冒泡排序，但凡写过PHP和JS都知道，usort、sort回调函数可以一次完成多重排序，Java的呆板禁锢了思维