Java及Android编码规范.docx

《Java及Android编码规范.docx》由会员分享，可在线阅读，更多相关《Java及Android编码规范.docx（31页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Java&Android编码规范目 录前言41代码布局51.1基本格式51.2对齐61.3空行空格71.4断行92注释122.1实现注释122.2文档注释173命名规则204声明245表达式与语句256类和接口297Android31前 言编写本规范的目的是为了进一步规范JAVA软件编程风格，提高软件源程序的可读性、可靠性和可重用性，确保在开发成员或开发团队之间的工作可以顺利交接，不必花很大的力气便能理解已编写的代码，以便继续维护和改进以前的工作，提高软件源程序的质量和可维护性，减少软件维护成本。本规范的内容包括：代码布局、注释、命名规则、声名、表达式与语句、类与接口等。本规范分成规则性和建议

2、性两种：对于规则性规范，要求所有软件开发人员严格执行；对于建议性规范，开发人员可以根据实际情况选择执行。自本规范实施之日起，以后新编写的和修改的代码均应执行本规范。本规范用到的术语解释如下：规则：编程时必须遵守的规则。建议：编程时必须加以考虑的原则。说明：对相应规则的必要的解释。正例：对此规则或建议给出的修正后的例子。反例：对此规则或建议给出的反面的例子。1 代码布局代码布局的目的是显示出程序良好的逻辑结构，提高程序的准确性、连续性、可读性、可维护性。更重要的是，统一的代码布局和编程风格，有助于提高整个项目的开发质量，提高开发效率，降低开发成本。同时，对于普通程序员来说，养成良好的编程习惯有助

3、于提高自己的编程水平，提高编程效率。因此，统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题，而且涉及到产品质量，涉及到个人编程能力的提高，必须要引起重视。1.1 基本格式【规则1-1-1】源代码文件（.java）的布局顺序是：包、import语句、类。正例:packagecom.sunsharp; importjava.awt.peer.CanvasPeer;import java.io.*;public class ClassName【规则1-1-2】遵循统一的布局顺序来书写import语句，不同类别的import语句之间用空行分隔。说明：package语句其后可跟i

4、mport语句，而且与package间隔一个空行。import包的排列顺序为java开头的包在最前面，接下来是引自外部的包，再接下来是应用程序自身的包，即import 中标准的包名要在本地的包名之前，而且按照字母顺序排列。正例:packagecom.sunsharp; import java.util.ArrayList;/java自身的包importjava.util.List;importorg.apache.http.*;/第三方的包mon.*;/程序自身的包【规则1-1-3】if、else、else if、for、while、do,switch等语句独占一行，执行语句不得紧跟其后。不论

5、执行语句有多少都要加。说明：这样可以防止书写失误，也易于阅读。正例：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;

6、1.2 对齐【规则1-2-1】一般禁止使用制表符，必须使用空格进行缩排。缩进为4个空格。说明：对于利用Eclipse等编程工具的，可以设置TAB键为4个空格代替。消除不同编辑器对制表符处理的差异。【规则1-2-2】程序的分界符和应独占一行，同时与引用它们的语句左对齐。 之内的代码块使用缩进规则对齐。说明：这样使代码便于阅读，并且方便注释。do while语句可以例外，while条件可与 在同一行。正例：voidfunction(intvar) while (condition)doSomething();/ 与 缩进4格/与引用它们的模块左对齐反例：voidfunction(intvar)wh

7、ile (condition)doSomething();【规则1-2-3】多维的数组如果在定义时初始化，按照数组的矩阵结构分行书写。正例：int number= 1,1, 1, 2, 4, 8, 3, 9, 27, 4, 16, 64 ;【建议1-2-1】相关的赋值语句等号对齐。正例：width = 50;length = 20;height= 40;1.3 空行空格【规则1-3-1】不同逻辑程序块之间要使用空行分隔。说明：空行起着分隔程序段落的作用。适当的空行可以使程序的布局更加清晰。下列情况应该总是使用空行：l 一个源文件的两个片段(section)之间l 类声明和接口声明之间l 常量声

8、明区域之后l 方法声明之前l 方法内的局部变量和方法的第一条语句之间l 一个方法内的两个逻辑段之间，用以提高可读性正例：voiddoSomething()Connection con = null; /数据库连接booleanreturnParameter = false; /返回 /空一行/if代码的注释if (reconsign = null)return false;反例：voiddoSomething() Connection con = null; /数据库连接 booleanreturnParameter = false; /返回/if代码的注释 if (reconsign = n

9、ull) return false;【规则1-3-2】一元操作符如“+”、“-”、“!”、“”、（类型）等前后不加空格。“”“.”这类操作符前后不加空格。正例：!valuevalue+countnumberi = 5;box.getWidth();【规则1-3-3】多元运算符和它们的操作数之间至少需要一个空格。说明：空格的多少根据上下文调整。正例：value = oldValue;total + value;number += 2;【规则1-3-4】方法名之后不要留空格。说明：方法名后紧跟左括号(。【规则1-3-5】(向后紧跟，)、,、;向前紧跟，紧跟处不留空格。,之后要留空格。;不是行结束符号时其后要留空格。正例：例子中的凵代表空格。for(i凵=凵0;凵i凵=”或“= -EPSINON) & (fResult= EPSINON)反例：if (fResult = 0.0) /隐含错误的比较其中EPSINON是允许的误差（即精度）。【规则5-5】在switch语句中，每一个case分支必须使用break结尾，最后一个分支必须是default分支。说明：避免漏掉break语句造成程序错误。有时编程逻辑需要，可以几个case语句共用一个语句块，对这种情况必须加注释进行说明。正例：switch (iMessage)case SPAN_ON:处