Java及Android编码规范(补足六个汉字).docx
文本预览下载声明
PAGE
PAGE 1/ NUMPAGES 31
REF 标准号 \* MERGEFORMAT 错误！未找到引用源。
JavaAndroid编码规范
PAGE 2/ NUMPAGES 31
PAGE I
目 录
TOC \o 1-3 \h \z 前言 PAGEREF _Toc184088996 \h 4
1 代码布局 PAGEREF _Toc184088997 \h 5
1.1 基本格式 PAGEREF _Toc184088998 \h 5
1.2 对齐 PAGEREF _Toc184088999 \h 6
1.3 空行空格 PAGEREF _Toc184089000 \h 7
1.4 断行 PAGEREF _Toc184089001 \h 9
2 注释 PAGEREF _Toc184089002 \h 12
2.1 实现注释 PAGEREF _Toc184089003 \h 12
2.2 文档注释 PAGEREF _Toc184089004 \h 17
3 命名规则 PAGEREF _Toc184089005 \h 20
4 声明 PAGEREF _Toc184089006 \h 24
5 表达式与语句 PAGEREF _Toc184089007 \h 25
6 类和接口 PAGEREF _Toc184089008 \h 29
7 Android PAGEREF _Toc184089009 \h 31
前 言
编写本规范的目的是为了进一步规范JAVA软件编程风格，提高软件源程序的可读性、可靠性和可重用性，确保在开发成员或开发团队之间的工作可以顺利交接，不必花很大的力气便能理解已编写的代码，以便继续维护和改进以前的工作，提高软件源程序的质量和可维护性，减少软件维护成本。
本规范的内容包括：代码布局、注释、命名规则、声名、表达式与语句、类与接口等。
本规范分成规则性和建议性两种：对于规则性规范，要求所有软件开发人员严格执行；对于建议性规范，开发人员可以根据实际情况选择执行。
自本规范实施之日起，以后新编写的和修改的代码均应执行本规范。
本规范用到的术语解释如下：
规则：编程时必须遵守的规则。
建议：编程时必须加以考虑的原则。
说明：对相应规则的必要的解释。
正例：对此规则或建议给出的修正后的例子。
反例：对此规则或建议给出的反面的例子。
PAGE 29/ NUMPAGES 31
代码布局
代码布局的目的是显示出程序良好的逻辑结构，提高程序的准确性、连续性、可读性、可维护性。更重要的是，统一的代码布局和编程风格，有助于提高整个项目的开发质量，提高开发效率，降低开发成本。同时，对于普通程序员来说，养成良好的编程习惯有助于提高自己的编程水平，提高编程效率。因此，统一的、良好的程序布局和编程风格不仅仅是个人主观美学上的或是形式上的问题，而且涉及到产品质量，涉及到个人编程能力的提高，必须要引起重视。
基本格式
【规则1-1-1】源代码文件（.java）的布局顺序是：包、import语句、类。
正例:
packagecom.sunsharp;
importjava.awt.peer.CanvasPeer;
import java.io.*;
public class ClassName
{
}
【规则1-1-2】遵循统一的布局顺序来书写import语句，不同类别的import语句之间用空行分隔。
说明：package语句其后可跟import语句，而且与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等语句独占一行，执行语句不得紧跟其后。不论执行语句有多少都要加{}。
说明：这样可以防止书写失误，也易于阅读。
正例：
if(varible1 varible2)
{
varible1 = varible2;
}
反例：
下面的代码执行语句紧跟if的条件之后，而且没有加{}，违反规则。
if (varible1 varible2) varible1 = varible2;
〖建议1-1-1〗源程序中关系较为紧密的代码应尽可能相邻
显示全部