SpringCloud工作笔记076--- CheckStyle插件提高java代码质量
技术交流QQ群【JAVA,.NET,BigData,AI】:170933152
这个是eclipse中的,在idea中也有这个插件,需要的时候去看看装上吧。 国外的客户一般比较严谨,这些工作,甚至自己公司
做的一些代码check工具都会对代码,进行检查。
CheckStyle是SourceForge下的一个项目,提供了一个帮助JAVA开发人员遵守某些编码规范的工具。它能够自动化代码规范检查过程,从而使得开发人员从这项重要但是枯燥的任务中解脱出来。
CheckStyle检验的主要内容
·Javadoc注释
·命名约定
·标题
·Import语句
·体积大小
·空白
·修饰符
·块
·代码问题
·类设计
·混合检查(包活一些有用的比如非必须的System.out和printstackTrace)
从上面可以看出,CheckStyle提供了大部分功能都是对于代码规范的检查,而没有提供象PMD和Jalopy那么多的增强代码质量和修改代码的功能。但是,对于团队开发,尤其是强调代码规范的公司来说,它的功能已经足够强大。
Checkstyle插件可以集成到Eclipse IDE中去,能确保Java代码遵循标准代码样式。
一、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插件
http://sourceforge.net/projects/eclipse-cs/
下载后,把里面的两个文件夹plugins和 features下面的文件分别拷贝到eclipse目录下面对应的plugins和features目录
2.如果你就这样直接启动eclipse可能会出现ClassNotFoundExceptions 等错误(一般不会出现此类错误),所以必须在启动eclipse的时候加上一个参数 -clean. 这样eclipse就可以更新它当前安装的许多插件信息
比如你得eclipse在d盘,那么就是 d:\eclipse\eclipse.exe -clean
二、CheckStyle 使用
安装成功后,选中工程,右键选择checkstyle->check code with checkstyle,检查错误即可
三、Checkstyle的结果输出
检查后会发现代码中出现很多放大镜图标,如下图所示,这就是Checkstyle的输出,具体含义如下:
1 Type is missing a javadoc commentClass
缺少类型说明
2 “{” should be on the previous line
“{” 应该位于前一行。解决方法:把“{”放到上一行去
3 Methos is missing a javadoc comment
方法前面缺少javadoc注释。解决方法:添加javadoc注释,类似这样:
/**
* set default mock parameter.(方法说明)
* @param additionalParameters parameter additional(参数名称)
* @return data manager(返回值说明)
* @throws Exception if has error(异常说明)
*/
4 Expected @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“}”
应该与下条语句位于同一行。解决方法:把“}”放到下一行的前面
10 Unused @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” 字符。
14 Redundant “Public” modifier
冗余的“public” 修饰符 。解决方法:去掉“public”修饰符
15 Final modifier out of order with the JSL suggestion
Final modifier的顺序错误
16 Avoid using the “.*” form of import
import格式避免使用“.*”。解决方法:可以先不添加import,再需要用到时直接“ctrl + o”导入即可。
17 Redundant import from the same package
从同一个包中Import内容,多余,删掉即可
18 Unused import-java.util.list
Import进来的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方法,并加上对应的方法javadoc注释、参数注释。并在返回值和参数类型前添加final。并把调用了这个变量的地方改成通过方法访问
35 'X' hides a field.
public class Foo
{
private int bar;
public Foo(int bar)
{
this.bar = bar;
}
public final int getBar()
{
return bar;
}
}
全局private int bar;和局部public Foo(int bar)的bar变量名字重复。
解决方法:把方法里面的参数名称改变下就可以了public Foo(int newBar)
{
this.bar = newBar;
}。
36 Got an exception - Unexpected character 0xfffd in identifier
这是因为CheckStyle不能识别制定的编码格式。
网上参考解决方法:
1、Eclipse中可以配置,在Other-->checker中可以指定
2、可以修改checkstyle配置文件:
<module name="Checker">
<property name="severity" value="warning"/>
<property name="charset" value="UTF-8"/>
<module name="TreeWalker">
如果是UTF-8的话,就添加加粗斜体的那条语句,就可以了。
37 Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag *whatever*.
网上参考解决方法:选中CheckSytle的JavaDoc --> Method JavaDoc --> logLoadErrors。如果是CheckStyle自己加载时出错的,打个Log就可以了,不要整出Errors吓人。
还有一处也可能包出同样的错误。Coding Problems --> Redundant Throws --> logLoadErrors选中即可
38 Expected @param tag for 'dataManager'.
缺少dataManager参数的注释 解决方法:在注释中添加@param dataManager DataManager
39 Parameter X should be final.
public class Foo
{
private int bar;
public Foo(int bar)
{
this.bar = bar;
}
public final int getBar()
{
return bar;
}
}
解释:public Foo(int bar)的局部变量,被认为是不可改变的,检查需要加上final关键字定义public Foo(final int bar)此错误,可以忽略不检查。
40 Redundant 'X' modifier.
public interface CacheHRTreeService extends Manager {
/**
* Organization Tree
* @param orgDto
* @return
* @throws Exception
*/
public void setOrganization(OrganizationDTO orgDto) throws Exception;
/**
* Organization Tree
* @return
* @throws Exception
*/
public OrganizationDTO getOrganization() throws Exception;
......
}
解释:多余的字段。public OrganizationDTO getOrganization() throws Exception;此时public为多余的字段,因为interface定义的时候,就是public的。
需要检查。
41 Class X should be declared as final.
解释:对于单例设计模式,要求返回唯一的类对象。但是HRFactory和ContextFactory为优化的两个类,不需求检查。
其他的单例类,依然需要进行检查。
42 Method 'addChildrenId' is not designed for extension - needs to be abstract, final or empty.
解释:通过父类继承的,此类有点特殊可以忽略此类。
43 Variable 'id' must be private and have accessor methods.
解释:BaseHRDTO类,为父类,属性给子类继承,比较特殊。但是其他的类,声名需要加上范围'private'关键字。需要检查。
44 Array brackets at illegal position.
解释:代码写法,习惯不一样。需要检查,仅仅提示
结果输出解释参考:http://www.cnblogs.com/bluesky4485/archive/2011/11/30/2269198.html
SpringCloud工作笔记076--- CheckStyle插件提高java代码质量相关推荐
- 提高 Java 代码质量
高质量代码中往往缺陷更少!确保高的 Java 代码质量有两个步骤:尽早并经常地编写各个层次的测试用例,以及持续的监测质量状况.那么我们又该如何实践呢?本专题汇集了大量来自代码质量专家们的专业经验.最佳 ...
- Eclipse中使用Checkstyle,checkstyle插件检查java代码的自定义配置文件:
摘要:近来项目组在搞代码检查,所以领导让把checkstyle这个插件搞明白,现在我把我们写的自定义的checkstyle.xml文件记录一下,以便大家可以一起使用: 一:要使用checkstyle插 ...
- SpringCloud工作笔记052---各种数据库在java中的连接配置_以及连接驱动
JAVA技术交流QQ群:170933152 # Properties file with JDBC-related settings. ########## # HSQLDB # ########## ...
- 如何提高Java代码的可重用性?
提高java代码可重用性有哪些方法措施,以下就讲解了三种关于提高java代码可重用性的措施,一起来了解一下吧~ 改写类的实例方法 通过类继承实现代码重用不是精确的代码重用技术,因此它并不是最理想的代码 ...
- java 代码解析工具_改善 Java 代码质量的工具与方法
原标题:改善 Java 代码质量的工具与方法 我们可能见过上面的有关代码质量的图片,究竟如何衡量一段代码好坏? 代码质量是什么?为什么它很重要? 作家通过他的著作来讲述了一个清晰的.令人信服的故事.他 ...
- java检测工具_常用Java代码质量检测评估工具
常用Java代码质量检测评估工具 1. PMD from http://pmd.sourceforge.net/ PMD能够扫描Java 源代码,查找类似以下的潜在问题: 可能的bug--try/ca ...
- 提高Objective-C代码质量心机一:简化写法
提高OC代码质量的小心机 一.OC特性 OC 为 C 语言添加了面向对象特性,是其超集; OC 使用动态绑定的消息结构,也就是,在运行时才会检查对象类型; 接收一条消息后,究竟应执行何种代码,由运行期 ...
- 从 FingBugs的错误来看JAVA代码质量
从 FingBugs的错误来看JAVA代码质量(一)http://scholers.iteye.com/blog/1107452 从 FingBugs的错误来看JAVA代码质量(二)http://sc ...
- ReSharper智能插件,ReSharper分析代码质量
ReSharper智能插件,ReSharper分析代码质量 ReSharper 是 Visual Studio 的智能插件.它配备了一组丰富的功能,包括智能编码辅助.即时错误突出显示和快速纠错.ReS ...
最新文章
- 环球博览|中国六代机有望5年内问世
- python软件安装步骤-一篇非常棒的安装Python及爬虫入门博文!
- 在C#中创建DataTable
- 基于卷积神经网络的手写数字识别、python实现
- Android极光推送
- 【.NET】XML文件的创建,修改,删除
- java生成缩略图,接收图片,按指定宽高或按比例生成缩略图
- matlab工具箱使用50hz低通滤波器设计 和FFT 变化截取50hz工频信号幅值
- java visibility_浅析Android中的visibility属性
- 如何在水晶报表9中实现选择打印机打印?
- Selenium+Python自动化测试学习问题总结笔记
- spring源码系列(一)sring源码编译 spring源码下载 spring源码阅读
- 最热BMS可直接下载!!
- 在html css中加粗显示,HTML和CSS实现字体加粗的方法有哪些
- maxscale实现MySQL负载均衡
- 阿里云轻量级应用服务器如何使用?
- Linux进程和轻量级进程(LWP)
- 微信+WeTest:小程序云端测试系统上线
- 硬件知识:U盘插入电脑没反应相关解决办法整理
- Unity 拖动UI物体(干货)