Java及Android编码规范.docx

Java&Android编码规范
目录
前言 4
1 代码布局 5
基本格式 5
对齐 6
空行空格 7
断行 9
2 注释 12
实现注释 12
文档注释 17
3 命名规则 20
4 声明 24
5 表达式与语句 25
6 类和接口 29
7 Android 31
前言
编写本规范的目的是为了进一步规范JAVA软件编程风格,提高软件源程序的可读性、可靠性和可重用性,确保在开发成员或开发团队之间的工作可以顺利交接,不必花很大的力气便能理解已编写的代码,以便继续维护和改进以前的工作,提高软件源程序的质量和可维护性,减少软件维护成本。
本规范的内容包括:代码布局、注释、命名规则、声名、表达式与语句、类与接口等。
本规范分成规则性和建议性两种:对于规则性规范,要求所有软件开发人员严格执行;对于建议性规范,开发人员可以根据实际情况选择执行。
自本规范实施之日起,以后新编写的和修改的代码均应执行本规范。
本规范用到的术语解释如下:
规则:编程时必须遵守的规则。
建议:编程时必须加以考虑的原则。
说明:对相应规则的必要的解释。
正例:对此规则或建议给出的修正后的例子。
反例:对此规则或建议给出的反面的例子。

代码布局
代码布局的目的是显示出程序良好的逻辑结构,提高程序的准确性、连续性、可读性、可维护性。更重要的是,统一的代码布局和编程风格,有助于提高整个项目的开发质量,提高开发效率,降低开发成本。同时,对于普通程序员来说,养成良好的编程,提高编程效率。因此,统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题,而且涉及到产品质量,涉及到个人编程能力的提高,必须要引起重视。
基本格式
【规则1-1-1】源代码文件(.java)的布局顺序是:包、import语句、类。
正例:
.sunsharp;
;
import .*;
public class ClassName
{
}
【规则1-1-2】遵循统一的布局顺序来书写import语句,不同类别的import语句之间用空行分隔。
说明:package语句其后可跟import语句,而且与package间隔一个空行。import包的排列顺序为java开头的包在最前面,接下来是引自外部的包,再接下来是应用程序自身的包,即import 中标准的包名要在本地的包名之前,而且按照字母顺序排列。
正例:
.sunsharp;
import ; //java自身的包
;
..*; //第三方的包
.mon.*; //程序自身的包
【规则1-1-3】if、else、else if、for、while、do,switch等语句独占一行,执行语句不得紧跟其后。不论执行语句有多少都要加{}。
说明:这样可以防止书写失误,也易于阅读。
正例:
if(varible1 < varible2)
{
varible1 = varible2;
}
反例:
下面的代码执行语句紧跟if的条件之后,而且没有加{},违反规则。
if (varible1 < varible2) varible1 = varible2;
〖建议1-1-1〗源程序中关系较为紧密的代码应尽可能相邻。
说明:这样便于程序阅读和查找。
正例:
length = 10;
width = 5; // 矩形的长与宽关系较密切,放在一起。
strCaption = “Test”;
反例:
length = 10;
strCaption = “Test”;
width = 5;
对齐
【规则1-2-1】一般禁止使用制表符,必须使用空格进行缩排。缩进为4个空格。
说明:对于利用Eclipse等编程工具的,可以设置TAB键为4个空格代替。消除不同编辑器对制表符处理的差异。
【规则1-2-2】程序的分界符‘{’和‘}’应独占一行,‘}’同时与引用它们的语句左对齐。{ }之内的代码块使用缩进规则对齐。
说明:这样使代码便于阅读,并且方便注释。
do… while语句可以例外,while条件可与} 在同一行。
正例:
voidfunction(intvar)
{
while (condition)
{
doSomething(); // 与{ }缩进4格
} //与引用它们的模块左对齐
}
反例:
voidfunction(intvar