JAVA编程语言编码规范.doc

《JAVA编程语言编码规范.doc》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、JAVA编程语言的代码惯例1、介绍1．1为什么要有代码惯例代码惯例之所以重要有以下几点原因：软件寿命价值的80%是维护。几乎没有软件在整个使用过程中都有由原作者维护。代码惯例增加了软件包的可读性，使工程师们能更快、更完整地理解新软件。如果你想把你的原始代码变成产品，你需要确认它是否和你生产的其它产品一样有好的包装。1．2确认这个文件在SUN公司的JAVA语言说明书中反映了JAVA语言编码标准。这方面规定主要来自PeterKing,PatrickNaughton,JonniKanerva,andScottHommel.关于这个文档的改写、修改或再分配的问题，请看版权公告。对于这个文档的建议请发贴

2、自alans@eng.sun.com2------文件名这一节列举了常用的文件后缀与名称。2．1文件后缀JAVA使用以下后缀：文件种类后缀JAVAsource.javaJAVAbytecode.class2．2普通文档名称通常用的文档名称文档名称使用GNUmakefilemakefile最恰当的名字。我们使用gnumake制造我们的软件。Readme概括特定目录内容的文档的最恰当名称。3.文件的组织结构一个文件应当由多个被分隔的段组成，并由空行和可选择注释来识别。超过2000行的文件由于冗长而应当避免。Java程序的正确格式可参看第19页的范例“Java源文件范例”。3．1Java源文件每一个

3、Java源文件包含一个单一的公共类或界面。当私有类或界面与一个公共类发生联系时，你可以将它们以一个公共类放入同一个源文件。公共类应当是文件中的第一类或界面。Java源文件有如下次序：·起始注释（参看第4页“起始注释”）·组件和导入语句·类和界面声明（参看第4页“类和界面声明”）3．1．1起始注释所有源文件应当以C格式注释开始，并列出类名，版本信息，时间和版权说明：/**类名**版本信息**时间**版权说明*/3．1．2组件和导入语句对于大部分Java源文件而言，第一个无注释行是组件语句。之后，紧跟着是导入语句。举例如下：组件java.awt;导入java.awt.peer.CanvasPeer

4、注释：对于唯一的组件名，第一部分总是小写的ASCII码格式的文本文件，并且是最高级别的域名之一。目前可用com,edu,gov,mil,net或ISO3166标准（1981）中规定的用于识别国家的英文两个字母的模式。3．1．3类和界面声明下表按出现的先后顺序描述了一个类或界面说明的各部分。参见第19页“java源文件范例”中一个包含注释的示例。类/界面声明的各部分注释1类/界面文档注释(/**…*/)参看第9页“文挡注释”中注释的具体内容2类或界面语句3类/界面补充注释（/*…*/），如果必要的话这一注释应包含任一类宽或界面宽度的信息，它不适合于类/界面文档注释。4类（静态的）变量首先是公共类

5、变量，其次是保护类，然后是组件级（无访问修改权），最后是私有类。5实例变量首先是公共类，其次是保护类，然后是组建级（无访问修改权），最后是私有类。6构成7过程这些过程应当以功能而非作用域和可访问性来分组。举例说明，一个私有类变量过程可在两个公共实例过程中。其目的是使读和理解代码更为容易。4、缩进格式四个空格作为一个缩进单位。确切的缩进格式结构（空格符与制表符）未被规范。表格的设置必须在每8个空格后（而非4个）。4．1行的长度由于难于被大多数终端和工具进行处理，应当避免一行超过80个字符。注释：在文档中所列举的范例其行的长度应稍短些，一般不超过70个字符。4．2绕回行当表达式一行无法写完时，使用

6、以下一般规则进行中断：·在逗号后中断。·在一个运算符前中断。·优先选择高级中断指令。·新行起始表达式的位置应与旧行表达式的位置对齐。·如果上述规则导致代码混乱或编码时顶到了右边界，以8个空格代替。以下是几个中断程序的调用范例：someMethod(longExpression1,longExpression2,longExpression3,longExpression4,longExpression5);var=someMethod1(longExpression1,someMethod2(longExpression2,longExpression3);以下是两个关于中断算术表达式的例子。

7、第一个例子由于中断发生在插入表达式以外，因而选择了高级中断指令。longName1=longName2*(longName3+longName4–longName5)+4*longname6;//PREFERlongName1=longName2*(longName3+longName4longName5)+4*longname6;//AVOID以下是两个关于缩进程序的说明。第一个例子是常规情况。