java编程风格规范

《java编程风格规范》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、Java编程风格规范目录目录1一、前言31术语说明32规范说明3二、源文件基础41文件名42文件编码：UTF-843特殊字符4三、源文件结构61许可证或版本信息62package语句63import语句64类声明7四、格式81大括号82块缩进：4个空格103一行一个语句104列限制：160字符105自动换行116空白127用小括号来限定组：推荐148具体结构15五、命名约定191对所有标识符都通用的规则192标识符类型的规则193驼峰式命名法(CamelCase)21六、编程实践231@Override：能用则用232捕获的异常：

2、不能忽视233静态成员：使用类经行调用234Finalizers：禁用245源文件和方法：代码行数限制246其它：建议24七、Javadoc251格式252摘要片段253哪里需要使用Javadoc26八、参考27一．前言这份文档是Java编程风格规范的完整定义。当且仅当一个Java源文件符合此文档中的规则，我们才认为它符合Java编程风格。与其它的编程风格规范一样，这里所讨论的不仅仅是编码格式美不美观的问题，同时也讨论一些约定及编码标准。然而，这份文档主要侧重于我们所普遍遵循的规则，对于那些不是明确强制要求的，我们尽量避免提供意见

3、。1.1术语说明在本文档中，除非另有说明：1.术语class可表示一个普通类，枚举类，接口或是annotation类型(@interface)2.术语comment只用来指代实现的注释(implementationcomments)，我们不使用“documentationcomments”一词，而是用Javadoc。其他的术语说明会偶尔在后面的文档出现。1.2规范说明本文档中的示例代码遵循Java编程风格，但并不意味着这是展现这些代码的唯一方式。对于可以有不同风格编写的会给予说明，但大家达成共识的格式和官方默认建议使用的格式，务必

4、遵守。二．源文件基础2.1文件名源文件以其最顶层的类名来命名，大小写敏感，文件扩展名为.java。即如果类是public的，最顶层的类应该是public。2.2文件编码：UTF-8源文件编码格式为UTF-8。2.3特殊字符2.3.1空白字符除了行结束符序列，ASCII水平空格字符(0x20，即空格)是源文件中唯一允许出现的空白字符，这意味着：所有其它字符串中的空白字符都要进行转义。2.3.2特殊转义序列对于具有特殊转义序列的任何字符(b,t,,f,r,“,‘及)，我们使用它的转义序列，而不是相应的八进制(比如

5、12)或Unicode(比如u000a)转义。2.3.3非ASCII字符对于剩余的非ASCII字符，是使用实际的Unicode字符(比如∞)，还是使用等价的Unicode转义符(比如u221e)，取决于哪个能让代码更易于阅读和理解。建议:在使用Unicode转义符或是一些实际的Unicode字符时，建议做些注释给出解释，这有助于别人阅读和理解。示例：StringunitAbbrev="μs";

6、赞，即使没有注释也非常清晰StringunitAbbrev="u03bcs";//"μs"

7、允许，但没有理由要这样做Stringun

8、itAbbrev="u03bcs";//Greeklettermu,"s"

9、允许，但这样做显得笨拙还容易出错StringunitAbbrev="u03bcs";

10、很糟，读者根本看不出这是什么建议:永远不要由于害怕某些程序可能无法正确处理非ASCII字符而让你的代码可读性变差。当程序无法正确处理非ASCII字符时，它自然无法正确运行，你就会去fix这些问题的了。(言下之意就是大胆去用非ASCII字符，如果真的有需要的话)三．源文件结构一个源文件包含(按顺序地)：1.许可证或版权信息(如有需要)2.package语句3.impor

11、t语句4.一个顶级类(只有一个)以上每个部分之间用一个空行隔开。3.1许可证或版权信息如果一个文件包含许可证或版权信息，那么它应当被放在文件最前面。3.2package语句package语句不换行，列限制(4.4节)并不适用于package语句。(即package语句写在一行里)3.3import语句3.3.1import不要使用通配符即，不要出现类似这样的import语句：importjava.util.*;3.3.2不要换行import语句不换行，列限制(4.4节)并不适用于import语句。(每个import语句独立成行)3

12、.3.3顺序和间距import语句可分为以下几组，按照这个顺序，每组由一个空行分隔：1.所有的静态导入独立成组(不建议使用静态导入)2.javaimports3.javaximports4.第三方的包。每个顶级包为一组，字典序。例如：com,jun