UMP Android编码规范-精品文档资料整理.doc

《UMP Android编码规范-精品文档资料整理.doc》由会员分享，可在线阅读，更多相关《UMP Android编码规范-精品文档资料整理.doc（29页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Java&Android编码规范Android编码规范1 代码布局代码布局的目的是显示出程序良好的逻辑结构，提高程序的准确性、连续性、可读性、可维护性。更重要的是，统一的代码布局和编程风格，有助于提高整个项目的开发质量，提高开发效率，降低开发成本。同时，对于普通程序员来说，养成良好的编程习惯有助于提高自己的编程水平，提高编程效率。因此，统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题，而且涉及到产品质量，涉及到个人编程能力的提高，必须要引起重视。1.1 基本格式正例:packagecom.sunsharp; importjava.awt.peer.CanvasPeer;

2、import java.io.*;public class ClassName说明：package语句其后可跟import语句，而且与package间隔一个空行。import包的排列顺序为java开头的包在最前面，接下来是引自外部的包，再接下来是应用程序自身的包，即import 中标准的包名要在本地的包名之前，而且按照字母顺序排列。正例:packagecom.sunsharp; import java.util.ArrayList;/java自身的包importjava.util.List;importorg.apache.http.*;/第三方的包mon.*;/程序自身的包说明：这样可以防止

3、书写失误，也易于阅读。正例：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-2-1】一般禁止使

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

5、ething();【规则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 常量声明区域之后l 方法声明之前l 方法内的局

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

7、则1-3-2】一元操作符如“+”、“-”、“!”、“”、（类型）等前后不加空格。“”“.”这类操作符前后不加空格。正例：!valuevalue+countnumberi = 5;box.getWidth();【规则1-3-3】多元运算符和它们的操作数之间至少需要一个空格。说明：空格的多少根据上下文调整。正例：value = oldValue;total + value;number += 2;【规则1-3-4】方法名之后不要留空格。说明：方法名后紧跟左括号(。【规则1-3-5】(向后紧跟，)、,、;向前紧跟，紧跟处不留空格。,之后要留空格。;不是行结束符号时其后要留空格。正例：例子中的凵代表空

8、格。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:处理语句break;case SPAN_OFF:处理语句break;default: 处

9、理语句break;建议5-1避免在“if”条件中赋值。说明：Java编译器对boolean型变量在if条件语句中的赋值时合法的，对整型变量的赋值是不合法的。建议5-2带值的返回语句不需要用括号（）。说明：除非有时不得不用括号使返回结构更加明显。正例：return;return myDisk.size();return (size ? size : defaultSize); /用括号使返回结构更加明显。建议5-3循环嵌套次数不大于3次。建议5-4do while语句和while语句仅使用一个条件。说明：保持程序简洁。如果需要判断的条件较多，建议用临时布尔变量先计算是否满足条件。正例：Boolean bCondition;do .bCondition = (tApiPortNo.bStateAcpActivity != PASSIVE)| (tApiPortNo.bStateLacpActivity != PASSIVE)& (abLacpEnablediPortNo)& (abPortEenablediPortNo) while (bCondition);建议5-5在多重循环中，如果有可能，应当将最长的循环放在最内层，最短的循环放在最外层，以减少CPU跨切循环层的次数。正例：for (iCol = 0; iCol 5; iCol+)for (iRow = 0; i