JAVA编程语言编码标准.doc

JAVA编程语言的代码惯例介绍1为什么要有代码惯例代码惯例之所以重要有以下几点原因:软件寿命价值的80%是维护。几乎没有软件在整个使用过程中都有由原作者维护。代码惯例增加了软件包的可读性,使工程师们能更快、更完整地理解新软件。如果你想把你的原始代码变成产品,你需要确认它是否和你生产的其它产品一样有好的包装。2确认这个文件在SUN公司的JAVA语言说明书中反映了JAVA语言编码标准。这方面规定主要来自PeterKing,PatrickNaughton,JonniKanerva,、修改或再分配的问题,请看版权公告。对于这个文档的建议请发贴自2------文件名这一节列举了常用的文件后缀与名称。:。我们使用gnumake制造我们的软件。Readme概括特定目录内容的文档的最恰当名称。,并由空行和可选择注释来识别。超过2000行的文件由于冗长而应当避免。Java程序的正确格式可参看第19页的范例“Java源文件范例”。。当私有类或界面与一个公共类发生联系时,你可以将它们以一个公共类放入同一个源文件。公共类应当是文件中的第一类或界面。Java源文件有如下次序:·起始注释(参看第4页“起始注释”)·组件和导入语句·类和界面声明(参看第4页“类和界面声明”),并列出类名,版本信息,时间和版权说明:/**类名**版本信息**时间**版权说明*/,第一个无注释行是组件语句。之后,紧跟着是导入语句。举例如下:;:对于唯一的组件名,第一部分总是小写的ASCII码格式的文本文件,并且是最高级别的域名之一。,edu,gov,或ISO3166标准(1981)中规定的用于识别国家的英文两个字母的模式。。参见第19页“java源文件范例”中一个包含注释的示例。类/界面声明的各部分注释1类/界面文档注释(/**…*/)参看第9页“文挡注释”中注释的具体内容2类或界面语句3类/界面补充注释(/*…*/),如果必要的话这一注释应包含任一类宽或界面宽度的信息,它不适合于类/界面文档注释。4类(静态的)变量首先是公共类变量,其次是保护类,然后是组件级(无访问修改权),最后是私有类。5实例变量首先是公共类,其次是保护类,然后是组建级(无访问修改权),最后是私有类。6构成7过程这些过程应当以功能而非作用域和可访问性来分组。举例说明,一个私有类变量过程可在两个公共实例过程中。其目的是使读和理解代码更为容易。缩进格式四个空格作为一个缩进单位。确切的缩进格式结构(空格符与制表符)未被规范。表格的设置必须在每8个空格后(而非4个)。,应当避免一行超过80个字符。注释:在文档中所列举的范例其行的长度应稍短些,一般不超过70个字符。,使用以下一般规则进行中断:·在逗号后中断。·在一个运算符前中断。·优先选择高级中断指令。·新行起始表达式的位置应与旧行表达式的位置对齐。·如果上述规则导致代码混乱或编码时顶到了右边界,以8个空格代替。以下是几个中断程序的调用范例:someMethod(longExpression1,longExpression2,longExpression3,longExpression4,longExpression5);var=someMethod1(longExpression1,someMethod2(longExpression2,longExpression3);以下是两个关于中断算术表达式的例子。第一个例子由于中断发生在插入表达式以外,因而选择了高级中断指令。longName1=longName2*(longName3+longName4–longName5)+4*longname6;//PREFERlongName1=longName2*(longName3+longName4longName5)+4*longname6;//AVOID以下是两个关于缩进程序的说明。第一个例子是常规情况。第二个例子如果采用常规缩进方式,第二和第三行在换行时必然顶至最右,取而代之应空