编码规范
目录
1. 排版规范****
l 相对独立的程序块与块之间加空行
l 关键词和操作符之间加适当的空格
l 较长的语句、表达式等要分成多行书写
l 划分出的新行要进行适应的缩进(一个Table位移4个空格),使排版整齐,语句可读
l 若函数或过程中的参数较长,则要进行适当的划分
1.1 版权信息
版权信息必须在 java 文件的开头
1.2 Package/Imports
package 行要在 import 行之前,import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。
1.3 Class头部
1.4 成员变量
1.4.1 依据变量需要作用的作用域,合理的选择protected/private和public
1.4.2 固定不变的常量使用 static final 关键字
1.5 成员函数
1.5.1 必要的函数写好注释
2 命名规范****
l 定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。
l 较短的单词可通过去掉“元音”形成缩写;
l 较长的单词可取单词的头几发符的优先级,并用括号明确表达式的操作顺序,避免使用默认优先级。
l 使用匈牙利表示法
2.1 Package 的命名
Package 的名字应该都是由一个小写单词组成。
package com.easygo.app.controller;
2.2 Class 的命名
Class 的名字必须由大写字母开头而其他字母都小写的单词组成,对于所有标识符,其中包含的所有单词都应紧靠在一起,而且大写中间单词的首字母。
public class ThisAClassName{}
2.3 Class 变量的命名
变量的名字必须用一个小写字母开头。后面的单词用大写字母开头
userName , thisAClassMethod
2.4 Static Final 变量的命名
static final 变量的名字应该都大写,并且指出完整含义。
2.5 参数的命名
参数的名字必须和变量的命名规范一致。
2.6 数组的命名
数组应该总是用下面的方式来命名:
byte[] buffer;
而不是:
byte buffer[];
3 注释规范
3.1. 注释要简单明了。
如:String userName = null; //用户名
3.2. 边写代码边注释,修改代码同时修改相应的注释,以保证注释与代码的一致性。
3.3. 在必要的地方注释,注释量要适中。注释的内容要清楚、明了,含义准确,防止注释二义性。保持注释与其描述的代码相邻,即注释的就近原则。
3.4. 对代码的注释应放在其上方相邻位置,不可放在下面。对数据结构的注释应放在其上方相邻位置,不可放在下面;对结构中的每个域的注释应放在此域的右方;同一结构中不同域的注释要对齐。
3.5. 变量、常量的注释应放在其上方相邻位置或右方。
3.6. 全局变量要有较详细的注释,包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。
3.7. 在每个函数或过程的前面要有必要的注释信息,包括:函数或过程名称;功能描述;输入、输出及返回值说明;调用关系及被调用关系说明等
3.8. javadoc 注释标签语法
@author 对类的说明 标明开发该类模块的作者
@version 对类的说明 标明该类模块的版本
@see 对类、属性、方法的说明 参考转向,也就是相关主题
@param 对方法的说明 对方法中某参数的说明
@return 对方法的说明 对方法返回值的说明
@exception 对方法的说明 对方法可能抛出的异常进行说明