|
软件标签: eclipse checkstyle 编程工具
checkstyle将能够为你带来在eclipse中所能够使用的样式插件,让你能够更好地进行各项编程操作,为你提供各类样式的制作带来最佳的编程效果,轻松实现所需的各类编程功能!
官方介绍
是sourceforge下的一个项目,提供了一个帮助java开发人员遵守某些编码规范的工具。它能够自动化代码规范检查过程,从而使得开发人员从这项重要,但是枯燥的任务中解脱出来。
安装方法:
下载成功后,将文件解压,会有两个文件夹features和plugins,将两文件夹下的内容分别复制到myeclipse6.0eclipse下面的features和plugins两个文件夹下,重新启动myeclipse,在window-->preferences下面可以看到checkstyle
方法一:
1.eclipse中,选择help->software updates->find and install
2.选择 search for new features to install 选择next
3.选择 new remote site
4.输入更新地址
http://eclipse-cs.sourceforge.net/update
5. 安装后重启即可
方法二:
1.下载eclipse插件
下载后,把里面的两个文件夹plugins和 features下面的文件分别拷贝到eclipse目录下面对应的plugins和features目录
2.如果你就这样直接启动eclipse 可能会出现classnotfoundexceptions 等错误,所以必须在启动eclipse的时候加上一个参数 -clean. 这样eclipse就可以更新它当前安装的许多插件信息
比如你得eclipse在d盘 那么就是 d:eclipseeclipse.exe -clean
checkstyle 使用
选中工程,右键选择checkstyle->check code with checkstyle,检查错误即可
checkstyle的结果输出
序号 ?????输出内容意义
1 type is missing a javadoc commentclass ?缺少类型说明
2“{” should be on the previous line “{” 应该位于前一行
3methos is missing a javadoc comment方法前面缺少javadoc注释
4expected @throws tag for “exception”在注释中希望有@throws的说明
5“.” is preceeded with whitespace “.” 前面不能有空格
6“.” is followed by whitespace“.” 后面不能有空格
7“=” is not preceeded with whitespace“=” 前面缺少空格
8“=” is not followed with whitespace“=” 后面缺少空格
9“}” should be on the same line“}” 应该与下条语句位于同一行
10unused @param tag for “unused”没有参数“unused”,不需注释
11variable “ca” missing javadoc变量“ca”缺少javadoc注释
12line longer than 80characters行长度超过80
13line contains a tab character行含有”tab” 字符
14redundant “public” modifier冗余的“public” modifier
15final modifier out of order with the jsl suggestionfinal modifier的顺序错误
16avoid using the “.*” form of importimport格式避免使用“.*”
17redundant import from the same package从同一个包中import内容
18unused import-java.util.listimport进来的java.util.list没有被使用
19duplicate import to line 13重复import同一个内容
20import from illegal package从非法包中 import内容
21“while” construct must use “{}”“while” 语句缺少“{}”
22variable “stest1” must be private and haveaccessor method变量“stest1”应该是private的,并且有调用它的方法
23variable “abc” must match pattern “^[a-z][a-za-z0-9]*$”变量“abc”不符合命名规则“^[a-z][a-za-z0-9]*$”
24“(” is followed by whitespace“(” 后面不能有空格 25“)” is proceeded by whitespace“)” 前面不能有空格
常见提示解释:
1type is missing a javadoc commentclass 缺少类型说明
2“{” should be on the previous line“{” 应该位于前一行。解决方法:把“{”放到上一行去
3methos is missing a javadoc comment 方法前面缺少javadoc注释。解决方法:添加javadoc注释 类似这样:
/**
* set default mock parameter.(方法说明)
* @param additionalparameters parameter additional(参数名称)
* @return data manager(返回值说明)
* @throws exception if has error(异常说明)
*/
4 expe
cted @throws tag for “exception”在注释中希望有@throws的说明
解决方法:在方法前得注释中添加这样一行:* @throws exception if has error(异常说明)
5“.” is preceeded with whitespace “.” 前面不能有空格。解决方法:把“(”前面的空格去掉
6“.” is followed by whitespace“.” 后面不能有空格。解决方法:把“)”后面的空格去掉
7“=” is not preceeded with whitespace“=” 前面缺少空格。解决方法:在“=”前面加个空格
8“=” is not followed with whitespace“=” 后面缺少空格。解决方法:在“=”后面加个空格
9“}” should be on the same line“}” 应该与下条语句位于同一行。解决方法:把“}”放到下一行的前面
10unused @param tag for “unused”没有参数“unused”,不需注释
解决方法:“* @param unused parameter additional(参数名称)” 把这行unused参数的注释去掉“
11 variable “ca” missing javadoc变量“ca”缺少javadoc注释
解决方法:在“ca“变量前添加javadoc注释:/** ca. */(注意:一定记得加上“.”)
12 line longer than 80characters行长度超过80 ?。解决方法:把它分成多行写。必要时候,可以ctrl+shift+f
13 line contains a tab character行含有”tab” 字符。快速解决方法:可以使用editplus中的format功能,把tab字符转化为空格,然后保存editplus英文版安装文件在我机子上有。需要的可以来拷贝。注册editplus,点击安装文件中注册的文件
14 redundant “public” modifier冗余的“public” modifier ? 。解决方法:冗余的“public”
15 final modifier out of order with the jsl suggestion final modifier的顺序错误
16 avoid using the “.*” form of importimport格式避免使用“.*”
17 redundant import from the same package从同一个包中import内容
18 unused import-java.util.listimport进来的java.util.list没有被使用。解决方法:去掉导入的多余的类
19 duplicate import to line 13重复import同一个内容 ? ?解决方法:去掉导入的多余的类
20 import from illegal package从非法包中 import内容
21 “while” construct must use “{}” ?“while” 语句缺少“{}”
22 variable “stest1” must be private and have accessor method变量“stest1”应该是private的,并且有调用它的方法
23 variable “abc” must match pattern “^[a-z][a-za-z0-9]*$”变量“abc”不符合命名规则“^[a-z][a-za-z0-9]*$”解决方法:把这个命名改成符合规则的命名 “abc”
24 “(” is followed by whitespace“(” 后面不能有空格 25“)”is proceeded by whitespace“)” 前面不能有空格
解决方法:把前面或者后面的空格去掉
25 first sentence should end with a period.解决方法:你的注释的第一行文字结束应该加上一个"."。
26 redundant throws: namenotfoundexception is subclass of namingexception. namenotfoundexception 是namingexception的子类重复抛出异常。
解决方法:如果抛出两个异常,一个异常类是另一个的子类,那么只需要写父类
去掉namenotfoundexception异常,对应的javadoc注释异常注释说明也需要去掉
27 parameter doctype should be final. 参数doctype应该为final类型 ?解决方法:在参数doctype前面加个final
28 line has trailing spaces. 多余的空行 ?解决方法:去掉这行空行
29 must have at least one statement. ?至少一个声明
解决方法:} catch (numberformatexception nfe) {
log.error("auto renews the agreement failed", nfe);//异常捕捉里面不能为空,在异常里面加一句话。如打印等等
30 > is not followed by whitespace.并且又有 ( is preceded with whitespace.
定义集合和枚举的时候的时候,最后一个“>”后面要有空格,“(”前面不容许有空格。解决方法:去掉泛型
31 got an exception - java.lang.runtimeexception: unable to get class information for @throws tag systemexception.原因:不合理的throws。
解决方法:要确保某些类型,如某些类、接口不被throws。把声明的异常去掉。在实现类中抛出异常
网上参考解决方法:1、这是checkstyle报的错。通常需要refreh, clean/build这个project. 如果不行,可以尝试clean all projects, restart eclipse.
2、因为编译好的类没有在checkstyle的classpath中.所以, 只要将编译好的class配置到在<checkstyle/>的classpath中就没有这个问题了.另外, 还发现checkstyle的line length好像也有点问题, 明明没有超过120个字符, 却还是报错.无奈, 我把eclipse中java > code style > formatter中的maximum line with改成了100, 然后format一下, 基本就没有问题了
32 file does not end with a newline.解决方法:删掉报错的类,新建一个同名的类,把代码全部复制过去
33 utility classes should not have a public or default constructor. 接口中的内部类中不应该有公共的或者默认的构造方法
解决方法:在内部类中,定义一个私有的构造方法,然后内部类声明为final类型。如果前面有static,那么final还必须放在static之后
34 variable functioncode must be private and have accessor methods.变量要改成private然后提供访问的方法
解决方法:给这些变量的修饰符改成private,然后提供set,get方法,并加上对应的方法
安装详细截图
|
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
|