Google Java编程规范:标识符规则与驼峰式命名
需积分: 48 170 浏览量
更新于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编程规范,旨在提高代码的可读性和一致性。
588 浏览量
190 浏览量
2023-08-08 上传
2022-05-15 上传
点击了解资源详情
点击了解资源详情
点击了解资源详情
点击了解资源详情
啊宇哥哥
- 粉丝: 35
- 资源: 3862
最新资源
- vominhtri1991qn:我的GitHub个人资料的配置文件
- 2008最值得阅读的营销培训教材《口碑营销》
- 量子计算机仿真器
- learn-react-day-by-day:每天学习reactJs
- openvox-sms-app:Openvox-sms 演示
- Status-Page:开源状态页软件
- 高质量C#源码.rar
- CardGameLinkedList:在春假期间要做的简单项目。 两名玩家获得每套衣服的同等数量的卡牌,并且每位玩家将卡牌放置在桌上。 当玩家拥有匹配的卡牌时,他们将从牌桌上拿走所有卡牌。 游戏结束10回合后结束,或者一名玩家拥有了所有卡牌[需要增加更多回合]
- rt-thread-code-stm32f407-rt-spark.rar星火号 STM32F407是开发板
- 组织发展新人成长总动员
- git22:测试笔记本
- todolist自己版本02.zip
- 电子功用-基于嵌套混响室的材料电磁脉冲屏蔽效能测试系统及其测试方法
- notifications-test-app:Web应用程序以测试通知服务
- ANP
- ToolBot:bot Discord ToolBot的代码源