阿里巴巴代码规范(二)

1.阿里巴巴代码规范 (常量定义)
A.不允许使用魔法值
不允许用未被定义的常量 直接出现在代码中
B.long与Long初始赋值时 使用大写的L 不能是小写的l 小写容易跟数字1混淆
C.不要使用一个常量类维护所有常量 按常量功能进行归类 分开维护 太多的常量的话不得不使用查询才能定位 不利于维护 缓存相关常量放在类CacheConsts下;系统配置相关常量放在类ConfigConsts下
D.常量的复用层次有五层 跨应用共享常量 应用内共享常量 子工程内共享常量 包内共享常量 类内共享常量
1).跨应用共享常量:放置在二方库中,通常是cilect.jar的constant目录中
2).应用内共享常量:放置在一方库中,通常是modules中的constant目录中
3).子工程内部共享常量:即在当前子工程的constant目录下
4).包内共享常量:即在当前包下单独的constant目录下
5).类内共享常量:直接在类内部private static final 定义
E.如果变量值仅在一个范围内变化,且带有名称之外的延伸属性,定义为枚举类
2.阿里巴巴代码规范(代码格式)
A.大括号的使用约定 如果是大括号里为空 则简洁的写成{}即可,不需要换行;如果是非空代码块则:
1).左大括号前不换行
2).左大括号后换行
3).右大括号前换行
4).右大括号后还有else等代码则不换行 表示终止的右大括号后必须换行
B.左小括号和字符之间不出现空格,同样,右小括号和字符之间也不出现空格
C.if/for/while/switch/do 等保留字与括号之间都必须加空格
D.任何二目,三目运算符的左右两边都需要加一个空格

E.采用4个空格缩进 禁止使用tab字符
F.注释的双斜线与注释内容之间有且仅有一个空格
G.单行字符数限制不超过120个,超出需要换行,换行时遵循如下原则:
1).第二行相对第一行缩进4个空格,从第三行开始,不再继续缩进
2).运算符与下文一起换行
3).方法调用的点符号与下文一起换行
4).方法调用时,多个参数需要换行时,在逗号后进行

5).在括号前不要换行

H.方法参数在定义和传入时,多个参数逗号后边必须加空格

I.IDE的text file encoding 统一设置为UTF-8;IDEA中文件的换行符使用Unix格式 不要使用windows格式

J.没有必要增加若干空格来使某一行的字符与上一行对应位置的字符对齐 

K.方法体内的执行语句组,变量的定义语句组 不同的业务逻辑之间或者不同的语义之间插入一个空行 相同业务逻辑和语义之间不需要插入空行

 

posted @ 2019-10-09 10:58  橘柑之味  阅读(922)  评论(0编辑  收藏  举报