没有合适的资源?快使用搜索试试~ 我知道了~
前言31.1.术语说明 31.2.指南说明 32.源文件基础 32.1.文件名 32.2.文件编码:UTF-8 42.3.特殊字符 43.源文件结构 53.1.
资源详情
资源评论
资源推荐
Java 编程风格指南
简体中文版 V1.0.0.1
作者:谷歌(Google 团队)
版本:1.0.0.1
翻译:Hawstein
排版:零度博客(www.xcode.me)
更多编码规范请参阅零度博客:www.xcode.me
第 1 页 /共 22 页
文档目录
文档目录 ............................................................................................................................................................. 1
1. 前言 ............................................................................................................................................................. 3
1.1. 术语说明 ..................................................................................................................................... 3
1.2. 指南说明 ..................................................................................................................................... 3
2. 源文件基础 ................................................................................................................................................. 3
2.1. 文件名 ......................................................................................................................................... 3
2.2. 文件编码:UTF-8 ....................................................................................................................... 4
2.3. 特殊字符 ..................................................................................................................................... 4
3. 源文件结构 ................................................................................................................................................. 5
3.1. 许可证或版权信息 ..................................................................................................................... 5
3.2. package 语句 .............................................................................................................................. 5
3.3. import 语句 ................................................................................................................................ 5
3.4. 类声明 ......................................................................................................................................... 6
4. 格式 ............................................................................................................................................................. 6
4.1. 大括号 ......................................................................................................................................... 7
4.2. 块缩进:2 个空格 ...................................................................................................................... 8
更多编码规范请参阅零度博客:www.xcode.me
第 2 页 /共 22 页
4.3. 一行一个语句 ............................................................................................................................. 8
4.4. 列限制:80 或 100 ..................................................................................................................... 8
4.5. 自动换行 ..................................................................................................................................... 8
4.6. 空白 ............................................................................................................................................. 9
4.7. 用小括号来限定组:推荐 ....................................................................................................... 11
4.8. 具体结构 ................................................................................................................................... 11
5. 命名约定 ................................................................................................................................................... 15
5.1. 对所有标识符都通用的规则 ................................................................................................... 15
5.2. 标识符类型的规则 ................................................................................................................... 15
5.3. 驼峰式命名法(CamelCase) ..................................................................................................... 17
6. 编程实践 ................................................................................................................................................... 18
6.1. @Override:能用则用 ............................................................................................................. 18
6.2. 捕获的异常:不能忽视 ........................................................................................................... 18
6.3. 静态成员:使用类进行调用 ................................................................................................... 19
6.4. Finalizers: 禁用 ................................................................................................................... 19
7. Javadoc....................................................................................................................................................... 20
7.1. 格式 ........................................................................................................................................... 20
7.2. 摘要片段 ................................................................................................................................... 20
更多编码规范请参阅零度博客:www.xcode.me
第 3 页 /共 22 页
7.3. 哪里需要使用 Javadoc ............................................................................................................ 21
8. 后记 ........................................................................................................................................................... 22
1. 前言
这份文档是 Google Java 编程风格规范的完整定义。当且仅当一个 Java 源文件符合此文档中的规则, 我们
才认为它符合 Google 的 Java 编程风格。
与其它的编程风格指南一样,这里所讨论的不仅仅是编码格式美不美观的问题, 同时也讨论一些约定及编
码标准。然而,这份文档主要侧重于我们所普遍遵循的规则, 对于那些不是明确强制要求的,我们尽量避
免提供意见。
1.1. 术语说明
在本文档中,除非另有说明:
1. 术语 class 可表示一个普通类,枚举类,接口或是 annotation 类型(@interface)
2. 术语 comment 只用来指代实现的注释(implementation comments),我们不使用“documentation comments”
一词,而是用 Javadoc。
其他的术语说明会偶尔在后面的文档出现。
1.2. 指南说明
本文档中的示例代码并不作为规范。也就是说,虽然示例代码是遵循 Google 编程风格,但并不意味着这是
展现这些代码的唯一方式。 示例中的格式选择不应该被强制定为规则。
2. 源文件基础
2.1. 文件名
源文件以其最顶层的类名来命名,大小写敏感,文件扩展名为.java。
剩余22页未读,继续阅读
杏花朵朵
- 粉丝: 18
- 资源: 333
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论0