对于静态分析工具,我经常使用CPD,PMD,FindBugs和Checkstyle。
CPD是PMD“复制/粘贴检测器”工具。我使用PMD一会儿之前,我注意到了“查找重复的代码”链接上的PMD的网页。
我想指出的是,这些工具有时可以扩展到其“开箱即用”的规则集之外。不仅仅是因为它们是开源的,所以您可以重写它们。这些工具中的一些工具带有允许扩展它们的应用程序或“挂钩”。例如,PMD附带了“设计器”工具,使您可以创建新规则。另外,Checkstyle具有DescendantToken检查,该检查具有允许进行大量自定义的属性。
我将这些工具与基于Ant的build集成在一起。您可以点击链接查看我的评论配置。
除了简单地集成到构建中之外,我还发现以其他几种方式将工具配置为“集成”有帮助。即,报告生成和警告抑制的一致性。我想在讨论中添加这些方面(可能还应该带有“
static-
analysis”标签):人们如何配置这些工具以创建“统一”解决方案?(我在这里单独询问了这个问题)
首先,对于警告报告,我转换输出,以使每个警告具有简单的格式:
/absolute-path/filename:line-number:column-number: warning(tool-name): message
这通常称为“ Emacs格式”,但是即使您没有使用Emacs,它也是用于均化报告的一种合理格式。例如:
/project/src/com/example/Foo.java:425:9: warning(Checkstyle):Missing a Javadoc comment.
我的警告格式转换是通过Ant脚本和Ant
filterchains完成的。
我要做的第二个“集成”是为了抑制警告。默认情况下,每个工具都支持注释或注释(或两者),您可以在代码中放置注释或注释,以使要忽略的警告静音。但是,这些各种警告抑制请求的外观不一致,看上去有些愚蠢。禁止显示警告时,就是禁止显示警告,所以为什么不总是写“
SuppressWarning?”?
例如,PMD的默认配置禁止
NOPMD在注释中带有字符串“ ”
的代码行上生成警告。另外,PMD支持Java的
@SuppressWarnings注释。我将PMD配置为使用包含“
SuppressWarning(PMD.”的注释,而不是
NOPMD使PMD抑制看起来相似。我填写使用注释样式抑制时违反的特定规则:
// SuppressWarnings(PMD.PreserveStackTrace) justification: (false positive) exceptions are chained
只有“
SuppressWarnings(PMD.”部分对注释很重要,但是与PMD对
@SuppressWarning注释的支持一致,该注释确实通过名称识别了违反规则的情况:
@SuppressWarnings("PMD.CompareObjectsWithEquals") // justification: identity comparision intended
同样,Checkstyle禁止在注释对之间生成警告(不提供注释支持)。默认情况下,用于打开和关闭Checkstyle的注释分别包含字符串
CHECKSTYLE:OFF和
CHECKSTYLE:ON。更改此配置(使用Checkstyle的“
SuppressionCommentFilter”)以使用字符串“
BEGIN SuppressWarnings(CheckStyle.”和“
ENDSuppressWarnings(CheckStyle.”,使控件看起来更像PMD:
// BEGIN SuppressWarnings(Checkstyle.HiddenField) justification: "Effective Java," 2nd ed., Bloch, Item 2// END SuppressWarnings(Checkstyle.HiddenField)
对于Checkstyle注释,特殊的检查违例(
HiddenField) 很 重要,因为每个检查都有自己的“
BEGIN/END”注释对。
FindBugs还支持带
@SuppressWarnings注释的警告生成抑制,因此不需要其他配置即可实现与其他工具的某种程度的一致性。不幸的是,Findbugs必须支持自定义
@SuppressWarnings注释,因为内置Java
@SuppressWarnings注释的
SOURCE保留策略不够强大,无法将注释保留在FindBugs需要它的类文件中。我完全限定FindBugs警告抑制,以避免与Java
@SuppressWarnings注释冲突:
@edu.umd.cs.findbugs.annotations.SuppressWarnings("UWF_FIELD_NOT_INITIALIZED_IN_CONSTRUCTOR")
这些技术使各个工具看起来相当一致。注意,每个警告抑制都包含字符串“
SuppressWarnings”,可以轻松地运行简单的搜索来查找整个代码库中所有工具的所有实例。
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)