编码规约之常量定义

目录

一、强制

1.不允许使用魔法值直接出现在代码中

2.Long或long赋值时使用大写L 

二、推荐

1.不要使用一个常量类维护所有常量

 2.分层次放置变量

3.变量值仅在一个固定范围内变化用 enum 类型来定义


一、强制

1.不允许使用魔法值直接出现在代码

不允许任何魔法值(即未经预先定义的常量)直接出现在代码中,详解请见另一篇文章编码规约之使用Enum枚举类替代魔法值

反例:  String key = "Id#taobao_" + tradeId;

cache.put(key, value);

2.Longlong赋值时使用大写L 

在 long 或者 Long 赋值时,数值后使用大写的 L,不能是小写的 l,小写容易跟数字 1 混淆,造成误解。

反例:  Long a = 2l; 写的是数字的 21,还是 Long 型的 2?

二、推荐

1.不要使用一个常量类维护所有常量

不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。

说明:大而全的常量类,杂乱无章,使用查找功能才能定位到修改的常量,不利于理解和维护。

正例:缓存相关常量放在类 CacheConsts 下;系统配置相关常量放在类 ConfigConsts 下。

 2.分层次放置变量

常量的复用层次有四层:应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。

1) 应用内共享常量:通常是子模块中的 constant 目录下

反例:易懂变量也要统一定义成应用内共享常量,两位攻城师在两个类中分别定义了表示 “是”的变量:

类A中:public static final String YES = "yes"; 

类B中:public static final String YES = "y";

A.YES.equals(B.YES),预期是 true,但实际返回为 false,导致线上问题。

2) 子工程内部共享常量:即在当前子工程的 constant 目录下

3) 包内共享常量:即在当前包下单独的 constant 目录下

4) 类内共享常量:直接在类内部 private static final 定义

3.变量值仅在一个固定范围内变化enum 类型来定义

说明:如果存在名称之外的延伸属性应使用 enum 类型,下面正例中的数字就是延伸信息,表示一年中的第几个季节。

    public enum SeasonEnum {
        SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);

        private int seq;

        SeasonEnum(int seq){
            this.seq = seq;
        }
    }

 

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值