阿里巴巴Java开发文档2020版学习-常量定义

2.常量定义

(1)【强制】不允许任何魔法值（即未经预先定义的常量）直接出现在代码中。
反例：

//本例中同学 A 定义了缓存的 key，然后缓存提取的同学 B 使用了 Id#taobao 来提取，少了下划线，导致故障。
String key = "Id#taobao_" + tradeId;
cache.put(key, value);

(2) 【强制】在 long 或者 Long 赋值时，数值后使用大写的 L，不能是小写的 l，小写容易跟数字混淆，造成误解。
说明： Long a = 2l; 写的是数字的 21，还是 Long 型的 2。

(3)【推荐】不要使用一个常量类维护所有常量，要按常量功能进行归类，分开维护。
说明： 大而全的常量类，杂乱无章，使用查找功能才能定位到修改的常量，不利于理解，也不利于维护。
正例： 缓存相关常量放在类 CacheConsts 下；系统配置相关常量放在类 ConfigConsts 下。

(4) 【推荐】常量的复用层次有五层：跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。

跨应用共享常量：放置在二方库中，通常是 client.jar 中的 constant 目录下。
应用内共享常量：放置在一方库中，通常是子模块中的 constant 目录下。
反例： 易懂变量也要统一定义成应用内共享常量，两位工程师在两个类中分别定义了“YES”的变量：类 A 中：public static final String YES = "yes";类 B 中：public static final String YES = "y";A.YES.equals(B.YES)，预期是 true，但实际返回为 false，导致线上问题。
子工程内部共享常量：即在当前子工程的 constant 目录下。
包内共享常量：即在当前包下单独的 constant 目录下。
类内共享常量：直接在类内部 private static final 定义。

(5)【推荐】如果变量值仅在一个固定范围内变化用 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;}
}

阿里巴巴Java开发文档2020版学习-常量定义相关推荐

python飞机大战概要设计_飞机大战游戏开发文档(Android版)
飞机大战游戏开发文档 (Android版) 课程名称:飞机大战游戏课程类型:Android游戏编程精彩内容,尽在百度攻略:https://gl.baidu.com 姓名:苏均灿学号:131342 ...
【校招VIP】线上实习推推书籍详情模块 Java开发文档周最佳
[推推]主要是为校招设计的小说一更新就通知的项目,每个模块都具有亮点和难点,项目表现为手机网站应用,可嵌入小程序或APP中. 恭喜来自四川师范大学的 o0hana 同学获得本周线上实习[推推]第一 ...
【校招VIP】“推电影”第一期电影详情模块Java开发文档作业评审1
前言:关于[推电影]免费在线实习项目一.本项目是基于年轻人的喜好,更个性的电影推荐网站.筛选各分类的知名电影,并给出推荐理由和下载链接.另外,通过标签功能匹配个人喜好,实现个性化推送. 二.项目表现 ...
anychat java开发文档_AnyChat视频云平台开发指南
本帖最后由佰锐科技-刘冬明于 2017-9-13 11:59 编辑简介: AnyChat视频云平台提供线上的音视频通信.多应用接入.即时通讯.全景录像.智能排队,直播.点播等服务.为您定制个性化 ...
java 自动生成文档_[原]java开发文档的自动生成方式
对于Java注释我们主要了解三种: // 注释一行 /* ...... */ 注释若干行第三种,文档注释: /** ...... */ 注释若干行,并写入 javadoc 文档通常这种注释的多行写 ...
阿里巴巴java开发手册（2020版）
2020版链接: https://pan.baidu.com/s/1Zls_FUBKfGksU1GR3BGGGA 密码:titz 2019版链接:https://pan.baidu.com/s/1 ...
java开发文档怎么写_程序员该不该写技术文档，怎么写文档，易懂又能提升自己...
最近公司项目的调用量突然涨了一大波,很多系统都纷纷扛不住了,于是需要对系统进行优化,系统优化的第一步,便是梳理业务! 在这个过程中,经常出现了这样一些情况,发现数据库的某些字段,没有注释,也没有一定的 ...
netty java开发文档_Netty简明教学文档
写个简单点,比较小白的文档,言语比较接地气 Netty是什么? NIO的高层封装,NIO很难写,所以有了Netty,方便异步的操作 service的主要代码片段 public void run() t ...
netty java开发文档_《Netty官方文档》设置开发环境
原文链接译者:dan QQ:903585177 请注意:这个指南并不是用户指南,它是开发 Netty 本身的指南,而不是使用Netty 开发其他程序的指南. 使用64位操作系统必须使用64位操 ...
java 开发文档协作_Java 网络编程---分布式文件协同编辑器设计与实现
目录: 第一部分:Java网络编程知识 (一)简单的Http请求一般浏览网页时,使用的时Ip地址,而IP(Internet Protocol,互联网协议)目前主要是IPv4和IPv6. IP地址是一 ...

阿里巴巴Java开发文档2020版学习-常量定义

2.常量定义

阿里巴巴Java开发文档2020版学习-常量定义相关推荐

最新文章

热门文章