Google Java编程规范:标识符规则与驼峰式命名

需积分: 48 64 下载量 54 浏览量 更新于2024-08-09 收藏 834KB PDF 举报
"这是关于Java编程规范的教程,主要涵盖了文件基础、源文件结构、命名规则、编程实践和Javadoc等多个方面。教程强调了通用的标识符规则,并指出不应使用特定的前缀或后缀,如name_,mName等。同时,规范了代码格式,包括大括号的使用、列限制、自动换行以及空白字符的处理。" 在Java编程规范中,对所有标识符都通用的规则是至关重要的。标识符只能包含ASCII字母和数字,符合正则表达式`\w+`,这意味着它们由字母、数字或下划线组成。教程中提到,像Google在其他编程语言中采用的一些特殊前缀或后缀,如name_、mName和s_name等,在Java编程风格中并不推荐使用。 文件基础部分,规范指出了文件应使用UTF-8编码,避免特殊字符的不当使用,并且在源文件中,许可证或版权信息应该放在开头。package和import语句的使用也有明确的要求,例如import语句不应使用通配符,且顺序和间距应保持一致。 在类声明和成员顺序上,每个源文件只能有一个顶级类声明,而类成员应按照一定的顺序排列,如常量、静态变量、实例变量、构造函数、方法等。格式方面,大括号的使用是强制性的,即使在可选的情况下也应使用,块的缩进应为2个空格,每行只写一条语句,列限制建议不超过80或100个字符。自动换行时,至少增加4个空格的缩进。 命名规则是规范中的核心部分,包括包名、类名、方法名、常量名、字段名、参数名、局部变量名和类型变量名。它们应遵循驼峰式命名法,如包名全小写,类名首字母大写,方法名和变量名首字母小写等。此外,还强调了使用@Override注解的重要性,捕获的异常不应被忽视,静态成员应通过类而不是实例来访问,finalizers通常应避免使用。 Javadoc是文档注解的重要组成部分,其格式和使用有明确指导,如摘要片段的编写,何时需要添加Javadoc,以及对于自明方法和重载方法的例外情况。这个教程提供了全面的Java编程规范,旨在提高代码的可读性和一致性。