Google Java编程规范:标识符与MATLAB程序
需积分: 50 127 浏览量
更新于2024-08-06
收藏 835KB PDF 举报
"这是关于Google Java编程规范的中文版,涵盖了标识符类型的规则,以及与之相关的编程实践和注释标准。这份文档详细规定了源文件的基础要素,如文件名、编码、特殊字符处理,以及源文件结构。在标识符类型规则方面,规范详细阐述了包名、类名、方法名、常量名、字段名、参数名、局部变量名和类型变量名的命名约定。此外,还强调了代码格式,包括大括号的使用、块的缩进、列限制和自动换行的处理。编程实践中,提倡使用@Override注解,避免忽视捕获的异常,不推荐使用静态 finalize 方法,并提供了关于Javadoc的格式和使用指导。"
在Java编程中,标识符的规则至关重要,因为它们定义了代码的可读性和一致性。根据Google的Java编程规范,以下是一些关键的标识符规则:
1. **包名**:包名通常是小写字母组成的,遵循反向域名的规则,例如`com.example.myproject`。
2. **类名**:类名应使用驼峰式命名,每个单词首字母大写,如`MyClassName`。顶级类声明在一个文件中只能有一个。
3. **方法名**:方法名也采用驼峰式命名,但首字母小写,如`myMethodName`。
4. **常量名**:常量名应全大写,单词间用下划线分隔,例如`MY_CONSTANT`。
5. **非常量字段名、参数名和局部变量名**:这些通常采用小驼峰式命名,首字母小写,后续单词首字母大写,如`variableName`。
6. **类型变量名**:类型变量通常使用单个大写字母,或者在单个大写字母后加上描述性的后缀,如`T`或`MyTypeT`。
7. **命名约定**:所有标识符都应清晰、具有描述性,避免使用缩写和保留字。
在格式方面,Google建议:
- 使用UTF-8编码。
- 文件中不应有额外的空白字符。
- 避免使用import通配符。
- 大括号总是成对出现,即使在可省略的情况下。
- 非空块采用K&R风格,空块可以简化。
- 块缩进使用2个空格,每行一个语句。
- 列限制建议不超过80或100个字符,超过时可适当自动换行。
- 注释和异常处理都有明确的指导原则,注解应该有意义,Javadoc用于提供API文档。
这些规则不仅提高了代码的可读性,也有助于团队间的合作,确保代码风格一致,降低维护难度。遵循这样的规范,可以提高代码质量,使得项目更容易维护和扩展。
2010-11-24 上传
2021-09-05 上传
点击了解资源详情
点击了解资源详情
2021-06-01 上传
2021-05-29 上传
2021-06-01 上传
郝ren
- 粉丝: 57
- 资源: 4049
最新资源
- 平尾装配工作平台运输支撑系统设计与应用
- MAX-MIN Ant System:用MATLAB解决旅行商问题
- Flutter状态管理新秀:sealed_flutter_bloc包整合seal_unions
- Pong²开源游戏:双人对战图形化的经典竞技体验
- jQuery spriteAnimator插件:创建精灵动画的利器
- 广播媒体对象传输方法与设备的技术分析
- MATLAB HDF5数据提取工具:深层结构化数据处理
- 适用于arm64的Valgrind交叉编译包发布
- 基于canvas和Java后端的小程序“飞翔的小鸟”完整示例
- 全面升级STM32F7 Discovery LCD BSP驱动程序
- React Router v4 入门教程与示例代码解析
- 下载OpenCV各版本安装包,全面覆盖2.4至4.5
- 手写笔画分割技术的新突破:智能分割方法与装置
- 基于Koplowitz & Bruckstein算法的MATLAB周长估计方法
- Modbus4j-3.0.3版本免费下载指南
- PoqetPresenter:Sharp Zaurus上的开源OpenOffice演示查看器