基于alibaba java 开发手册开发规约2:编程规约-命名规约(2)

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/qq_35165632/article/details/83548994

16.【强制】BC_MM_16:不允许任何魔法值(即未经预先定义的常量出现在代码中)。例:String key = "key_"+aaa;

17.【强制】BC_MM_17:long或者Long初始赋值时,使用大写的L,不能是小写的l。小写l容易跟数字1混淆,造成误解。

18.【强制】BC_MM_18:不要使用一个常量类维护所有的常量,要按照常量功能进行归类,分开维护。

19.【强制】BC_MM_19:常量的复用层次有5层;跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。

      1)跨应用共享常量:放置在二方库中,通常是在client.jar中的constant目录下。

      2)应用内共享常量:放置在一方库中,啊通常是在子模块中的constant目录下。

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

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

      5)类内共享常量:直接在类内部以 private static final 的方式定义。

20.【推荐】BC_MM_20:如果变量值仅在一个范围内变化,则用 enum类型来定义。

21.【强制】BC_MM_21:大括号的使用约定。如果大括号内为空,则简洁的写成{}即可,不需要换行:如果非空代码块,:则:

     1)左大括号前不换行。

     2)左大括号后不换行。

     3)右大括号前换行。

     4)右大括号后还有else 等代码则不换行:表示终止的右大括号后必须换行。

22.【强制】BC_MM_22:左小括号和字符间不出现空格;同样,右小括号和字符间也不出现空格。

23.【强制】BC_MM_23:if/for/while/switch/do 等保留字与括号之间必须加空格。

24.【强制】BC_MM_24:任何二目、三目、运算符的左右两边都需要加一个空格。

25.【强制】BC_MM_25:注释的双斜线与注释内容之间仅有一个空格。

26.【强制】BC_MM_26:单行字符数不超过120个,超过则需要换行,换行时遵循如下原则:

    1)第二行相对第一行缩进 4个空格,从第三行开始,不再持续缩进。

    2)运算符与下文一起换行。

    3)方法调用的点符号与下文一起换行。

    4)方法调用中的多个参数需要换行时,在逗号后进行。

    5)在括号前不要换行,见返例。

27.【强制】BC_MM_27:方法参数在定义和传入时,多个参数都好后边必须加空格。

28.【强制】BC_MM_28:IDE的text file encoding 设置为UTF-8;IDE中文件的换行符使用UNIX,不要使用windows格式。

29.【推荐】BC_MM_29:没有必要增加若干空格来使某一行的字符与上一行对应位置的字符对齐。

30.【推荐】BC_MM_30:不同逻辑、不同语义/不同业务的代码之间插入一个空行分割开来,以提供可读性。

猜你喜欢

转载自blog.csdn.net/qq_35165632/article/details/83548994