zoukankan      html  css  js  c++  java
  • 读阿里巴巴泰山版《java开发手册》总结(1)

    写在前面

    某天上网冲浪时,看见阿里巴巴发布了最新的java开发手册。好奇之下下载来了看了看。觉得收获很大,特此在这里记录一下自己觉得有用的点。
    java开发手册链接:https://developer.aliyun.com/topic/java2020

    代码规范篇

    命名风格

    • 1.[强制]所有编程相关的命名严禁使用拼音和英文混合,更不允许直接使用中文.
    • 2.[强制]类名使用UpperCamelCase风格,除某些特殊情况.
    • 3.[强制]方法名、参数名、成员变量、局部变量统一使用lowerCamelCase风格.
    • 4.[强制]常量命名全部大写,单词间用下划线隔开,力求语义表达完整清楚,不要嫌名字长.
    • 5.[强制]抽象类命名使用 Abstract 或 Base 开头;异常类命名使用Exception 结尾;测试类命名以它要测试的类的名称开始,以 Test 结尾。
    • 6.[强制]类型与中括号紧挨相连来表示数组。如int[] arrayDemo;
    • 7.[强制]包名统一使用小写,点分隔符之间有且仅有一个自然语义的英语单词。包名统一使用单数形式,但是类名如果有复数含义,类名可以使用复数形式.
    • 8.[强制]避免在子父类的成员变量之间、或者不同代码块的局部变量之间采用完全相同的命名,使可读性降低.
    • 9.[强制]杜绝完全不规范的缩写,避免望文不知义。
    • 10.[强制]接口类中的方法和属性不要加任何修饰符号(public 也不要加),并加上有效的javadoc注释.

    常量定义

    • 1.[强制]不允许任何魔法值(即未经预先定义的常量)直接出现在代码中。
    • 2.[强制]在 long 或者 Long 赋值时,数值后使用大写的 L,不能是小写的 l,小写容易跟数字混淆,造成误解.
    • 3.[强制]不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。

    代码格式

    • 1.[强制]如果是大括号内为空,则简洁地写成{}即可,大括号中间无需换行和空格;如果是非
      空代码块则:
      1) 左大括号前不换行。
      2) 左大括号后换行。
      3) 右大括号前换行。
      4) 右大括号后还有 else 等代码则不换行;表示终止的右大括号后必须换行。
    • 2.[强制]左小括号和右边相邻字符之间不出现空格;右小括号和左边相邻字符之间也不出现空格;而左大括号前需要加空格。如反例:if(空格a==b空格)
    • 3.[强制]if/for/while/switch/do 等保留字与括号之间都必须加空格。
    • 4.[强制]任何二目、三目运算符的左右两边都需要加一个空格。
    • 5.[强制]采用四个空格缩进。
    • 6.[强制]注释的双斜线与注释内容之间有且仅有一个空格。
    • 7.[强制]单行字符数限制不超过 120 个,超出需要换行,换行时遵循如下原则:
      1)第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进,参考示例。
      2)运算符与下文一起换行。
      3)方法调用的点符号与下文一起换行。
      4)方法调用中的多个参数需要换行时,在逗号后进行。
      5)在括号前不要换行
    • 8.[强制]方法参数在定义和传入时,多个参数逗号后边必须加空格。
    • 9.[推荐]不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。

    总结

    暂时先看了这些,等接着看会继续更新的。

  • 相关阅读:
    程序员修炼之道阅读笔记1
    构建之法阅读笔记6
    构建之法阅读笔记5
    构建之法阅读笔记4
    构建之法阅读笔记3
    构建之法阅读笔记2
    关于搜狗输入法的评价
    找水王
    用户场景
    个人工作总结
  • 原文地址:https://www.cnblogs.com/wushenjiang/p/12785864.html
Copyright © 2011-2022 走看看