编码规范

 

一、代码格式：

1.缩进：程序块要采用缩进风格编写，缩进只使用TAB键，不能使用空格键（编辑器中请将TAB设置为4格）；方法体的开始、类的定义、以及if、for、do、while、switch、case语句中的代码都要采用缩进方式；

 

      2.对齐：程序块的分界符左大括号"{" 和右大括号"}"都另起一行，应各独占一行并且位于同一列，同时与引用它们的语句左对齐；对齐只使用TAB键，不使用空格键；不允许把多个短语句写在一行中，即一行只写一条语句；if、for、do、while、case、switch、default等语句自占一行。

 

      3.换行：一行的长度超过80个字符需要换行，换行规则如下：

 

在一个逗号后面断开；

 

在一个操作符前面断开；

 

长表达式要在低优先级操作符处划分新行；

 

新行缩进2个TAB。

 

4.间隔：类、方法及相对独立的程序块之间、变量说明之后必须加空行；关键字之后要留空格， 象if、for、while  等关键字之后应留一个空格再跟左括号"（"， 以突出关键字；方法名与其左括号"（"之间不要留空格, 以与关键字区别；二元操作符如   " ="、" +="  " >="、" <="、" +"、" *"、" %"、" &&"、" ||"、" <<" ," ^" 等的前后应当加空格；一元操作符如" !"、" ~"、" ++"、" --"等前后不加空格；xiang"［ ］"、" ." 这类操作符前后不加空格；for语句中的表达式应该被空格分开；强制转型后应该跟一个空格。

 

 

二、命名规范：

1.基本规则:使用可以准确说明变量、字段、类、接口、包等完整的英文描述符；采用大小写混合，提高名字的可读性；采用该领域的术语；尽量少用缩写，但如果一定要使用，当使用公共缩写和习惯缩写等；避免使用相似或者仅在大小写上有区别的名字。

2.包命名：包名一律小写, 少用缩写和长名；采用以下规则：

                                  [基本包].[项目名].[模块名].[子模块名]...

不得将类直接定义在基本包下，所有项目中的类、接口等都应当定义在各自的项目和模块包中。

3.类或接口命名：类或接口名是个一名词，采用大小写混合的方式，每个单词的首字母大写。尽量使你的类名简洁而富于描述。使用完整单词，避免用缩写词(除非该缩写词被更广泛使用，像URL，HTML)。

4.变量命名: 采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；变量名不应以下划线或美元符号开头；尽量避免单个字符的变量名，除非是一次性的临时变量。临时变量通常被取名为i，j，k，m和n，它们一般用于整型；c，d，e，它们一般用于字符型；不采用匈牙利命名法则，对不易清楚识别出该变量类型的变量应使用类型名或类型名缩写作其后缀；组件或部件变量使用其类型名或类型名缩写作其后缀；集合类型变量，例如数组和矢量，应采用复数命名或使用表示该集合的名词做后缀。

5.常量命名：全部采用大写，单词间用下划线隔开。

6．方法命名：方法名是一个动词，采用大小写混合的方式，第一个单词的首字母小写，其后单词的首字母大写；取值类可使用get前缀，设值类可使用set前缀，判断类可使用is(has)前缀。