、Java及Android编码规范 精品资料

Java&Android编码规范1/50

1目录前言41代码布局51.1基本格式51.2对齐61.3空行空格71.4断行92注释122.1实现注释122.2文档注释173命名规则204声明245表达式与语句256类和接口297Android313/50

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

31代码布局代码布局的目的是|显示出程序良好的逻辑结构，提高程序的准确性、连续性、可读性、可维护性。更重要的是，统一的代码布局和编程风格，有助于提高整个项目的开发质量，提高开发效率，降低开发成本。同时，对于普通程序员来说，养成良好的编程习惯有助于提高自己的编程水平，提高编程效率。因此，统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题，而且涉及到产品质量，涉及到个人编程能力的提高，必须要引起重视。1.1基本格式【规则1-1-1】源代码文件（.java）的布局顺序是：包、import语句、类。正例:package|com.sunsharp;importjava.awt.peer.CanvasPeer;importjava.io.*;publicclassClassName{}【规则1-1-2】遵循统一的布局顺序来书写import语句，不同类别的import语句之间用空行分隔。说明：package语句其后可跟import语句，而且与package间隔一个空行。import包的排列顺序为java开头的包在最前面，接下来是引自外部的包，再接下来是应用程序自身的包，即import中标准的包名要在本地的包名之前，而且按照字|母顺序排列。正例:packagecom.sunsharp;importjava.util.ArrayList;//java自身的包importjava.util.List;importorg.apache.http.*;//第三方的包importcom.snusharp.common.*;//程序自身的包【规则1-1-3】if、else、elseif、for、while、do,switch等语句独占一行，执行语句不得紧跟其后。不论执行语句有多少都要加{}。说明：这样可以防止书写失误，也易于阅读。正例：5|0/50

4if(varible1

5doSomething();//与{}缩进4格}//与引用它们的模块左对齐}反例：voidfunction(intvar){while(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.1|空行空格【规则1-3-1】不同逻辑程序块之间要使用空行分隔。说明：空行起着分隔程序段落的作用。适当的空行可以使程序的布局更加清晰。下列情况应该总是使用空行：l一个源文件的两个片段(section)之间l类声明和接口声明之间l常量声明区域之后50/50

6l方法声明之前l方法内的局部变量和方法的第一条语句之间l一个方法内的两个逻辑段之间，用以提高可读性正例：voiddoSomething(){Connectioncon=null;//数据库连接booleanreturnParameter=false;//|返回//空一行//if代码的注释if(reconsign==null)returnfalse;}反例：voiddoSomething(){　　　Connectioncon=null;//数据库连接booleanreturnParameter=false;//返回//if代码的注释if(reconsign==null)returnfalse;}【规则1-3-2】一元操作符如“++”、“--”、“!”、“~”、（类型）等前后不加