-
Java
代码检查规范指导书
审
核
:
批
准
:
日
期
:
日
期
:
实施日期
2010
< br>年
05
月
24
< br>日
版
本
号
A-0
密
级
内部
Copyright ?
2010
福富软件
版权所有
Java
代码检查规范——问题收集
文件编号:
修改履历
版本号
A-0
日期
2010-5-24
作者
吴兆彬
新作成
修订要点
Copyright ? 2010
福富软件
版权所有
Page
2
of
17
Java
代码检查规范——问题收集
文件编号:
目录
1
2
3
4
5
6
引言
.
..................................................
..................................................
...........................................
5
应用范围
..................................................
..................................................
....................................
5
角色职责
..................................................
..................................................
....................................
5
输入
.
..................................................
..................................................
...........................................
5
输出
.
..................................................
..................................................
...........................................
6
作业流程
..................................................
..................................................
....................................
6
6.1
C
HECK
S
TYLE
安装与使用
.......
..................................................
................................................
7
6.1.1
CheckStyle
插件安装
..
..................................................
...............................................
7
6.1.1.1
“在线更新”安装方式
.................
..................................................
.........................................
7
6.1.1.2
“手动下载”安装方式
.................
..................................................
.........................................
8
6.1.2
CheckStyle
的配置与使用
..................................................
.........................................
9
6.1.2.1
6.1.2.2
6.1.2.3
导入:规则文件
.
< br>............................................... .................................................. .................
9
启用:项目检查
.
< br>............................................... .................................................. ............... 10
查看:结果视图
.
< br>............................................... .................................................. ............... 10
6.2
E
CLIPSE
C
ODE
S
TYLE
的配置
.
< br>............................................... .................................................
10
6.2.1.1
“代码模版”的配置
.......
..................................................
..................................................
... 10
6.2.1.2
“
代码格式化”的配置
......
..................................................
..................................................
.. 11
6.2.1.3
“代码清理”的配置
.......
..................................................
..................................................
... 11
6.3
7
代码修正
.......................................
..................................................
.................................... 11
问题反馈(
FAQ
)
< br> .............................................. .................................................. .....................
12
1)
2)
3)
4)
5)
为什么第一句话需要以标点符号结束?
..........
..................................................
..................
12
“”}”
应该在同一行”的提示信息?
.......................................
...............................................
12
“
一个
局部常数,最好定义为全局常数”的提示信息?
.................
...................................
13
“
条件
逻辑语句应该被移除”的提示信息?
......................
..................................................
13
“
变量
应该声明为
PRIVATE
”的提示信息?
.
........................
.................................................
13
Copyright ?
2010
福富软件
版权所有
Page
3
of
17
Java
代码检查规范——问题收集
文件编号:
6)
7)
8)
9)
“
工具
类不应该存在
PRIVATE
或者默认构造函数”的提示信息?
.....................................
14
“
参数
超过
7
个”的提示信息?
.
................................
..................................................
.........
14
“
类级的常量必须与模式
”
< br>^[A-Z][A-Z0-9]*(_[A-Z0-
9]+)*$$”
相匹配”
的提示信息?
15
“
避免在语句中出现嵌套的赋值语句”的提示信息?
........................................... .............
15
Copyright ? 2010
福富软件
版权所有
Page
4
of
17
Java
代码检查规范——问题收集
文件编号:
1
引言
在编码规范推进过程中,陆续收
到很多开发人员提交上来的疑问,这里逐一
统一做了一个整理和收集,
< br>做成能够为开发人员提供指导意见的工作流程,
以提
供大
家互相参考和借鉴,
共通把电信信息化部的编码风格做到一致,
为编码质量
的提高奠定基础。
p>
收集上来的问题,主要包括:在插件安装上的困难;在
CheckS
tyle
提示信
息上的疑问点;使用
E
clipse Code Style
中的自动修复功能的问题;期望实现
的改进建议;
2
应用范围
本指导书适用于编码阶段,可以进行代码的自查和修订,也可以适用于代码
走查阶段。
在纠正代码规范性的基础上,
更利于开发
人员从业务层面进行走查的
效果。
3
角色职责
角色
开发人员
走查人员
/QA
4
输入
1)
《
Ja
va
代码检查规范》
;
2)
《
Eclipse Code
Style
设置》
;
3)
代码检查配置文件;
(
2010
年大部检查标准
_
)
4)
代码修复工具;
(
2010
年大部检查标准
_
、
20
10
年大部
检查标准
_formatt
er
.xml
、
2010
年大部检查标准
_Clean
)
5)
开发人员的代码;
Copyright ? 2010
福富软件
版权所有
Page
5
of
17
职责
对代码进行自查,以及代码的修正;
对代码进行规范性检查;
Java
代码检查规范——问题收集
文件编号:
5
输出
1)
检查结果报表(图、表)
;
2)
代码走查情况;
6
作业流程
1)
检查
人员在开发环境(
Eclipse
)中进行插件的安装,可以选
择手动下载
安装方式,也可以选择在线更新方式;
2)
安装完
CheckStyle
之后,需要进行
CheckStyle<
/p>
的配置;这里请选择
导入规则配置文件《
2010
年大部检查标准
_
》
;
3)
在项目工程上,设置激活
CheckStyle
检
查;
4)
激活并编译项目工程后,打开
CheckStyle
检查结果视
图,来查看检查
结果;
5)
检查人员将检查报告发送给开发人员,由开发人员进行修复;
6)
开发人员导入修复规则:
“代码模板配置文件”
《
2010
年大部检查标准
_
》
、<
/p>
“代码格式化配置文件”
《
2010
p>
年大部检查标准
_formatter
.x
ml
》和“代码清理配置文件”
《
20
10
年大部检查标准
_Clean
》
。
7)
开发人员执行
< br>CleanUp
操作,完成自动修复代码操作;
8)
对于无法自动化修复的代码,开发人员进行手动修复;
Copyright ? 2010
福富软件
版权所有
Page
6
of
17
Java
代码检查规范——问题收集
文件编号:
6.1
CheckStyle
安装与使用
6.1.1
CheckStyle
插件安装
p>
根据大家的使用习惯,可以选择“在线更新”或者“手动下载”方式,进行
< br>CheckStyle
的插件安装。
6.1.1.1
“在线更新”安装方式
1.
Eclipse
3.4
以上版本的安装方式
步骤
Eclipse3.4
Eclipse3.5
New
1<
/p>
、在
Eclipse
中,点
?
选
择
< br>“
Software
?
p>
选
择
“
Insta
ll
Updates...
”
Software...
”
击“
Help
”菜单;
入
:
?
p>
“
Name
”
设<
/p>
置
为
:
2
、点击“
Add...
”按
< br>?
输
eclipse-
cs
;
钮,在弹出框中输入
t/update/
;
?
“
Loc
ation
”
设
置
为
:
/upda
输入相关信息;<
/p>
te/
;
择
“
Eclipse
Checkstyle
Plug-in
3
、
选择合适的版本进
?
选
5.1.0.2
”
行安装
4
、
安装完成后,重新
?
启动
Eclipse
;
2.
Eclipse
3.3
以下版本的安装方式
步骤
说明
1
、在
Eclipse
中,点击“
Help
”菜
?<
/p>
选
择
“
Software
Updates
->
Find
and
Install
”
单;
?
选择“
Search for new
features
”
2
、
新建一个
“
New
Remote Site...
”
?
输入名称“
eclipse-
cs
”
?
输
入
URL
地
址
“
/update/
”
?
3
、选择合适的版本进行安装
4
、
安装完成后,
重
新启动
Eclipse
;
?
Copyright ? 2010
福富软件
版权所有
Page
7
of
17
Java
代码检查规范——问题收集
文件编号:
6.1.1.2
“手动下载”安装方式
1.
方式一:
(如果是低版本的
Eclipse
,请将
dropins
修改为
links
目录)
步骤
1
、访问
URL
地址进行下载;
说明
?
<
/p>
下
载
地
址
:
/project/
p?group_id
=80344&package_id=107587
?
<
/p>
解
压
目
录
:
$${Eclipse
安
装
目
录
}/dropins/ec
lipse-cs/eclipse
?
将
“
$${Eclipse
安
装
目
录
}/drop
ins/eclipse-cs/eclipse
”目录下的
“
”文件删除
?
将
“
p>
$${Eclipse
安
装
< br>目
录
}/dropins/eclipse-cs/ec
lipse/features
”目
录下的
jar
文件解压缩到所在目录的子文
件夹中:
?
“
< br>ion_5.
”文件,
解
压
缩
到
2
、解压安装包
3
、整理安装文件
< br>“
ion_5.
1.0.2
”目
录
?
“<
/p>
ecs_5.1.0.20100
”
p>
文
件
,
解
压
缩
到
“
ecs_5.1.0.20100
2232103
”
目录
4
、重启
Eclipse
2.
方式二:
(如果是低版本的
Eclipse
,请将
dropins
替换为
links
目录;
)
步骤
1
、访问
URL
地址进行下载;
说明
?
下
载
p>
地
址
:
/proj
ect/
?
Copyright ? 2010
福富软件
版权所有
Page
8
of
17