没有合适的资源?快使用搜索试试~ 我知道了~
这是一个真实项目的代码编写规范,不长,简单,有一定的参考价值,但是不建议直接拿来用,谢谢!
资源推荐
资源详情
资源评论
Java 代码编程格式规范
Java 代码编程格式规范
目 录
1 前言.................................................................................................................................................5
2 适用范围.........................................................................................................................................5
3 命名规范.........................................................................................................................................5
3.1 PACKAGE 的命名.....................................................................................................................5
3.2 CLASS 的命名..........................................................................................................................5
3.3 CLASS 成员的命名..................................................................................................................6
3.4 STATIC FINAL 变量的命名.......................................................................................................6
3.5 前后台变量名称....................................................................................................................6
3.6 参数的命名............................................................................................................................6
3.7 数组的命名............................................................................................................................6
3.8 方法的参数............................................................................................................................6
3.9 缩写........................................................................................................................................7
3.10 标识符命名中应注意的问题..............................................................................................7
3.10.1 除局部循环变量外变量名禁止取单个字符 7
3.10.2 不用数字定义名字 7
3.10.3 用正确的反义词组命名 8
3.10.4 避免使用 8
4 样式.................................................................................................................................................9
4.1 JAVA 文件样式.........................................................................................................................9
4.1.1 版权信息 9
4.1.2 Package/Imports 9
4.2 CLASS 的样式.........................................................................................................................10
4.2.1 Class 的定义 10
4.2.2 Class Fields 10
4.2.3 构造函数 10
4.2.4 克隆方法 11
4.2.5 类成员变量和方法的编写顺序 11
4.2.6 main 方法 12
4.3 代码样式..............................................................................................................................12
5 注释...............................................................................................................................................12
5.1 一般情况下..........................................................................................................................12
5.2 常规注释标记说明..............................................................................................................12
5.2.1 @since 13
5.2.2 @deprecated 13
5.2.3 @see 13
5.2.4 @link 14
5.3 类和接口注释说明..............................................................................................................14
5.4 方法注释说明......................................................................................................................15
6 书写格式规范...............................................................................................................................15
第 2 页,共 37 页
Java 代码编程格式规范
6.1 代码编写规范......................................................................................................................15
6.1.1 缩进15
6.1.2 页宽16
6.1.3 空行16
6.1.4 空格的使用 17
6.1.5 {}的用法 17
6.1.6 if 等语句写法 18
6.1.7 循环、判断等语句 19
6.1.8 参数划分 20
6.1.9 一行只写一条语句 20
6.2 变量编写规范......................................................................................................................20
6.2.1 公共变量 20
6.2.2 局部变量 21
6.3 程序编写规范......................................................................................................................21
6.3.1 exit() 21
6.3.2 异常22
6.3.3 垃圾收集 22
6.3.4 *nal 类 22
6.3.5 访问类的成员变量 22
7 编程技巧.......................................................................................................................................23
7.1 一般性原则..........................................................................................................................23
7.1.1 检查所有参数输入的有效性。 23
7.1.2 检查参数输入 23
7.1.3 类名应准确描述类的功能。 23
7.1.4 避免强制返回值类型23
7.1.5 让调用点显得易懂、容易理解。 23
7.1.6 减少数据类型转换 23
7.1.7 防止程序中的垃圾代码。 24
7.1.8 减少递归调用。 24
7.1.9 使用数据流图 24
7.1.10 避免使用 BOOL 参数。 24
7.2 开发过程中的技巧..............................................................................................................25
7.2.1 byte 数组转换到 characters 25
7.2.2 Utility 类 25
7.2.3 初始化数组 25
7.2.4 枚举类型 25
7.2.5 Swing 26
7.2.6 Z-Order 问题 26
7.2.7 不必要的对象构造 27
7.2.8 synchronized 关键字 27
7.3 程序效率..............................................................................................................................27
7.3.1 注意代码的效率 27
7.3.2 提高代码效率 27
第 3 页,共 37 页
Java 代码编程格式规范
7.3.3 局部效率应为全局效率服务 28
7.3.4 循环体内工作量最小化。 28
7.3.5 仔细分析有关算法,并进行优化。 28
7.3.6 改进输入方式 28
7.3.7 提高调用不频繁的代码效率要慎重 29
7.3.8 提高空间效率 29
7.3.9 循环的位置 29
7.3.10 尽量减少循环嵌套层次。 30
7.3.11 避免循环体内含判断语句 30
7.3.12 不要一味追求紧凑的代码。 31
8 性能...............................................................................................................................................31
8.1 可移植性..............................................................................................................................32
8.1.1 换行32
8.1.2 PrintStream 32
8.2 可测性..................................................................................................................................32
8.2.1 调测32
8.2.2 调测信息串格式 33
8.2.3 在编程中注意单元测试 33
8.2.4 测试准备 33
8.2.5 测试手段 33
8.2.6 调测开关 33
8.2.7 调试与测试 34
8.2.8 调测开关的级别和类型 34
8.2.9 编写防错程序 34
9 质量保证.......................................................................................................................................35
9.1 代码质量保证优先原则......................................................................................................35
9.2 打开的文件要关闭..............................................................................................................35
9.3 一致性检查..........................................................................................................................35
9.4 SWITCH 语句必须有 DEFAULT 分支。...................................................................................35
9.5 其他质量问题......................................................................................................................35
10 代码编辑、编译、审查.............................................................................................................36
10.1 统一编译环境....................................................................................................................36
10.2 代码走读及评审................................................................................................................36
10.3 QA 代码抽查.....................................................................................................................36
10.4 软件系统目录....................................................................................................................37
第 4 页,共 37 页
Java 代码编程格式规范
1 前言
为确保系统源程序可读性,从而增强系统可维护性,java编程人员应具有
基本类似的编程风格,兹制定下述Java编程规范,以规范系统Java部分编程。
系统继承的其它资源中的源程序也应按此规范作相应修改。
2 适用范围
本文档将作为java编程人员软件开发的编程格式规范。在项目Java部分的
编码、测试及维护过程中,要求严格遵守。
3 命名规范
定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加
可读性,减少项目组中因为换人而带来的损失。
3.1 Package 的命名
Package 的名字应该都是由一个小写单词组成。示例:unipost.trans
3.2 Class 的命名
Class 的名字每个单词必须由大写字母开头而其他字母都小写的单词组成。
示例:FileMng
第 5 页,共 37 页
剩余36页未读,继续阅读
资源评论
wzh35245642
- 粉丝: 0
- 资源: 2
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
最新资源
- Google Chrome浏览器ChromeDriver驱动下载(Chrome版本:131.0.6778.205)win32
- Google Chrome浏览器ChromeDriver驱动下载(Chrome版本:131.0.6778.205)win64
- IEEE期刊和会议论文模板及投稿指南
- 水晶球圣诞树(源码),开箱即用
- 圣诞贺卡(全套网页源码),开箱即用
- Visual C++ 2015 编译 FreeType 28
- 纯CSS流星圣诞树(网页源码)
- k7_cyc4mini_test.zip
- 洞洞板LochMaster-V4.0完整版rar
- syncfusionessentialwpf-v28.1.33
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功