12. 使用 FindBugs™ 进行缺陷数据挖掘

FindBugs 具备对缺陷数据库执行复杂查询、并跨所研究代码的多个版本追踪警告的能力，这使你能够完成诸如以下的操作：查看某个缺陷是何时首次引入的、只检查自上一个发布版本以来新增的警告，或者绘制代码中无限递归循环数量随时间变化的图表。

所有这些技术都依赖于 FindBugs 用于存储警告的 XML 格式。这些 XML 文件通常只包含某一次特定分析运行所产生的警告，但也可以存储对一系列软件构建版本或代码版本进行分析的结果。

任何 FindBugs XML 缺陷数据库都包含一个版本名称和时间戳。FindBugs 会尝试依据被分析文件的时间戳来计算该时间戳（例如，此时间戳应为类文件生成的时间，而非分析的时间）。每个缺陷数据库还包含一个版本名称。版本名称和时间戳都可以通过 setBugDatabaseInfo 命令（第 1.7 节，"setBugDatabaseInfo"）手动设置。

多版本缺陷数据库会为被分析代码的每个版本分配一个序号。这些序号就是从 0 开始依次递增的整数（例如，包含 4 个代码版本的缺陷数据库将包含版本 0..3）。缺陷数据库还会记录每个版本的名称和时间戳。filterBugs 命令允许你通过序号、名称或时间戳来引用某个版本。

你可以取一组（或一对）单版本缺陷数据库，并由它们创建一个多版本缺陷数据库，也可以将一个多版本缺陷数据库与一系列后续的单版本缺陷数据库合并。

其中一些命令可以作为 ant 任务来调用。有关如何调用这些命令以及它们接受哪些属性和参数的具体说明，请见下文。所有示例都假定 findbugs.lib 的 refid 已被正确设置。下面是设置它的一种方式：


   <!-- findbugs task definition -->
   <property name="findbugs.home" value="/your/path/to/findbugs" />
   <path id="findbugs.lib">
      <fileset dir="${findbugs.home}/lib">
         <include name="findbugs-ant.jar"/>
      </fileset>
   </path>

1. 命令

所有用于 FindBugs 数据挖掘的工具都可以从命令行调用，其中一些较为实用的工具也可以在 ant 构建文件中调用。

简要来说，命令行工具如下：

unionBugs

合并对不相交的类分别进行分析所得的结果

computeBugHistory

将多个版本的已分析代码中的缺陷警告合并为一个多版本缺陷数据库。既可以用来向已有的多版本数据库中添加更多版本，也可以由一系列单版本缺陷警告数据库创建一个多版本数据库。

setBugDatabaseInfo

设置 XML 缺陷数据库中的信息，如版本名称或时间戳

listBugDatabaseInfo

列出一组 XML 缺陷数据库的信息，如版本名称和时间戳

filterBugs

从缺陷数据库中选取一个子集

mineBugHistory

生成一个表格，列出多版本缺陷数据库中每个版本的警告数量

defectDensity

列出缺陷密度（每 1000 NCSS 的警告数）的相关信息，包括整个项目以及每个类和包

convertXmlToText

将 XML 格式的缺陷警告转换为每条缺陷一行的文本格式，或转换为 HTML

1.1. unionBugs

例如，如果你分别分析了应用程序中使用的每个 jar 文件，可以使用该命令将各自生成的 XML 缺陷警告文件合并为一个包含所有警告的文件。

请不要使用该命令来合并对同一文件不同版本的分析结果；请改用 computeBugHistory。

在命令行中指定 XML 文件。结果将输出到标准输出。

1.2. computeBugHistory

使用该命令可以生成一个缺陷数据库，其中包含你正在分析的软件的不同构建或版本的信息。历史记录取自输入的第一个文件；其后的文件应为单版本缺陷数据库（如果其中包含历史记录，那些文件中的历史记录将被忽略）。

默认情况下，输出将写入标准输出。

此功能也可以从 Ant 中访问。首先在构建文件中为 computeBugHistory 创建一个 taskdef：


<taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
    <classpath refid="findbugs.lib" />
</taskdef>

此 ant 任务的属性列于下表。要指定输入文件，请将其作为子元素嵌套在 <datafile> 元素中。例如：


<computeBugHistory home="${findbugs.home}" ...>
    <datafile name="analyze1.xml"/>
    <datafile name="analyze2.xml"/>
</computeBugHistory>

表 12.1．computeBugHistory 命令的选项

命令行选项	Ant 属性	含义
-output <file>	output="<file>"	将输出保存到指定的文件（该文件也可以是输入文件）
-overrideRevisionNames[:truth]	overrideRevisionNames="[true\	false]"	用根据文件名计算出的名称覆盖每个版本的修订版本名
-noPackageMoves[:truth]	noPackageMoves="[true\	false]"	如果某个类已移动到其他包，则将该类中的警告视为不同的警告
-preciseMatch[:truth]	preciseMatch="[true\	false]"	要求缺陷模式精确匹配
-precisePriorityMatch[:truth]	precisePriorityMatch="[true\	false]"	仅当优先级完全一致时，才将两条警告视为同一条
-quiet[:truth]	quiet="[true\	false]"	除非出现错误，否则不向标准输出生成任何输出
-withMessages[:truth]	withMessages="[true\	false]"	在 XML 输出中包含描述各条警告的可读消息

1.3．filterBugs

此命令用于从 FindBugs XML 警告文件中选取一部分警告，并将所选的这部分警告写入新的 FindBugs 警告文件。

该命令接受一系列选项，以及在命令行上给出零个、一个或两个 FindBugs XML 缺陷文件的文件名。

如果没有提供文件名，该命令将从标准输入读取并写入标准输出；如果提供了一个文件名，它将从该文件读取并写入标准输出；如果提供了两个文件名，它将从第一个文件读取，并将输出写入第二个文件名。

此功能也可以从 Ant 中使用。首先在构建文件中为 filterBugs 创建一个 taskdef：


<taskdef name="filterBugs" classname="edu.umd.cs.findbugs.anttask.FilterBugsTask">
    <classpath refid="findbugs.lib" />
</taskdef>

此 Ant 任务的属性列于下表。要指定输入文件，既可以使用 input 属性，也可以在 Ant 调用中嵌套一个 <datafile> 元素。例如：


<filterBugs home="${findbugs.home}" ...>
    <datafile name="analyze.xml"/>
</filterBugs>

表 12.2. filterBugs 命令的选项

命令行选项	Ant 属性	含义
	input="<file>"	使用该文件作为输入
	output="<file>"	将结果输出到文件
-not	not="[true\	false]"	反转（所有）用于过滤的开关
-withSource[:truth]	withSource="[true\	false]"	仅显示其源码可用的开关所对应的警告
-exclude <filter file>	exclude="<filter file>"	排除与给定过滤器匹配的缺陷
-include <filter file>	include="<filter file>"	仅保留与给定过滤器匹配的缺陷
-annotation <text>	annotation="<text>"	仅允许人工注释中包含该文本的警告
-after <when>	after="<when>"	仅允许首次出现于该版本之后的警告
-before <when>	before="<when>"	仅允许首次出现于该版本之前的警告
-first <when>	first="<when>"	仅允许首次出现于该版本的警告
-last <when>	last="<when>"	仅允许最后出现于该版本的警告
-fixed <when>	fixed="<when>"	仅允许上一个版本中最后出现（即已修复）的警告（会覆盖 `-last`）
-present <when>	present="<when>"	仅允许存在于该版本中的警告
-absent <when>	absent="<when>"	仅允许不存在于该版本中的警告
-active[:truth]	active="[true\	false]"	仅允许在最新序列号中仍然有效的警告
-introducedByChange[:truth]	introducedByChange="[true\	false]"	仅允许由已有类的变更所引入的警告
-removedByChange[:truth]	removedByChange="[true\	false]"	仅允许由仍然存在的类的变更所移除的警告
-newCode[:truth]	newCode="[true\	false]"	仅允许由新增类所引入的警告
-removedCode[:truth]	removedCode="[true\	false]"	仅允许由类被删除而移除的警告
-priority <level>	priority="<level>"	仅允许优先级不低于该值的警告
-maxRank <rank>	rank="[1..20]"	仅允许等级不高于该值的警告
-class <pattern>	class="<class>"	仅允许主要类名与该模式匹配的缺陷
-bugPattern <pattern>	bugPattern="<pattern>"	仅允许类型与该模式匹配的缺陷
-category <category>	category="<category>"	仅允许类别以该字符串开头的警告
-designation <designation>	designation="<designation>"	仅允许具有该指定标记的警告（例如，-designation SHOULD_FIX）
-withMessages[:truth]	withMessages="[true\	false]"	生成的 XML 应包含文本消息

1.4. mineBugHistory

此命令生成一个表格，其中包含多版本缺陷数据库各个版本中警告数量的统计。

该功能也可以通过 ant 访问。首先在构建文件中为 mineBugHistory 创建一个 taskdef：


<taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
    <classpath refid="findbugs.lib" />
</taskdef>

此 ant 任务的属性列于下表。要指定输入文件，可以使用 input 属性，也可以在 ant 调用中嵌套一个 <datafile> 元素。例如：


<mineBugHistory home="${findbugs.home}" ...>
    <datafile name="analyze.xml"/>
</mineBugHistory>

表 12.3.　mineBugHistory 命令的选项

命令行选项	Ant 属性	含义
	input="<file>"	使用该文件作为输入
	output="<file>"	将输出写入到文件
-formatDates	formatDates="[true\	false]"	以文本形式呈现日期
-noTabs	noTabs="[true\	false]"	用空格组代替制表符来分隔各列（见下文）
-summary	summary="[true\	false]"	输出最近十条记录中变更的简要摘要

在使用固定宽度字体的 shell 中，-noTabs 的输出会更易于阅读。由于数字列采用右对齐，第一列的值之前可能会出现空格。该选项还会使 -formatDates 以更紧凑的格式渲染日期，其中不包含空白字符。

该表格是一个以制表符分隔的表格（除非使用了 -noTabs），包含以下各列：

表 12.4.　mineBugHistory 输出中的列

标题	含义
seq	序号（从 0 开始的连续整数）
version	版本名称
time	发布时间戳
classes	分析的类数量
NCSS	非注释源语句数
added	上一个版本中已存在的类所产生的新警告数量
newCode	上一个版本中不存在的类所产生的警告数量
fixed	在当前版本中仍然存在的类中已消除的警告数量
removed	上一个版本中、但在当前版本中已不存在的类所含的警告数量
retained	在上一个版本和当前版本中都存在的警告数量
dead	早期版本中存在、但在当前版本及紧邻的上一个版本中均不存在的警告
active	当前版本中存在的警告总数

1.5. defectDensity

此命令列出整个项目以及每个类和包的缺陷密度（每 1000 NCSS 的警告数）信息。调用时可以在命令行上不指定任何文件（此时它从标准输入读取），也可以在命令行上指定一个文件。

它会生成一个包含以下列的表格，其中整个项目占一行，每个包含至少 4 个警告的包或类各占一行。

表 12.5. defectDensity 输出中的列

标题	含义
kind	project（项目）、package（包）或 class（类）
name	项目、包或类的名称
density	每 1000 行 NCSS 产生的警告数
bugs	警告数量
NCSS	计算得出的 NCSS 数量

1.6. convertXmlToText

此命令将 XML 格式的警告集合转换为每条警告一行的文本格式，也可以转换为 HTML。

该功能也可以通过 ant 访问。首先在构建文件中为 convertXmlToText 创建一个 taskdef：


<taskdef name="convertXmlToText" classname="edu.umd.cs.findbugs.anttask.ConvertXmlToTextTask">
    <classpath refid="findbugs.lib" />
</taskdef>

此 Ant 任务的属性列于下表中。

表 12.6. convertXmlToText 命令的选项

命令行选项	Ant 属性	含义
	input="<filename>"	使用该文件作为输入
	output="<filename>"	将结果输出到文件
-longBugCodes	longBugCodes="[true\	false]"	使用完整的缺陷模式代码，而不是两字母缩写
	format="text"	生成纯文本输出，每行一个缺陷（命令行的默认方式）
-html[:stylesheet]	format="html:<stylesheet>"	使用指定的样式表生成输出（见下文），若未指定则使用 default.xsl

对于 -html/format 选项，你可以指定 plain.xsl、default.xsl、fancy.xsl、fancy-hist.xsl 或者你自己的 XSL 样式表。尽管该选项名为 -html，你也可以指定生成 html 以外内容的样式表。当应用 FindBugs 自带（已列于上文）以外的样式表时，-html/format 选项应带上该样式表的路径或 URL。

1.7. setBugDatabaseInfo

此命令用于在指定的警告集合中设置元信息。它接受以下选项：

此功能也可以通过 ant 访问。首先在你的构建文件中为 setBugDatabaseInfo 创建一个 taskdef：


<taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
    <classpath refid="findbugs.lib" />
</taskdef>

该 Ant 任务的属性列于下表。要指定输入文件，可以使用 input 属性，也可以在 Ant 调用中嵌套一个 <datafile> 元素。例如：


<setBugDatabaseInfo home="${findbugs.home}" ...>
    <datafile name="analyze.xml"/>
</setBugDatabaseInfo>

表 12.7. setBugDatabaseInfo 选项

命令行选项	Ant 属性	含义
	input="<file>"	使用该文件作为输入
	output="<file>"	将输出写入该文件
-name <name>	name="<name>"	设置（最后一个）修订版的名称
-timestamp <when>	timestamp="<when>"	设置（最后一个）修订版的时间戳
-source <directory>	source="<directory>"	将指定目录添加到源码搜索路径
-findSource <directory>	findSource="<directory>"	查找并添加指定目录内包含的所有相关源码目录
-suppress <filter file>	suppress="<filter file>"	抑制该文件所匹配的警告（会替换先前的抑制设置）
-withMessages	withMessages="[true\	false]"	将文本消息添加到 XML 中
-resetSource	resetSource="[true\	false]"	移除所有源码搜索路径

1.8. listBugDatabaseInfo

该命令在命令行中接受一个或多个 XML 缺陷数据库文件名。如果未提供任何文件名，则从标准输入读取，并且不会生成表头。

该命令只有一个选项：-formatDates，用于以文本形式呈现日期。

输出为一张表格，每个缺陷数据库占一行，包含以下列：

表 12.8. listBugDatabaseInfo 的列

列名	含义
version	版本名称
time	发布时间戳
classes	已分析的类数量
NCSS	已分析的非注释源语句数（Non Commenting Source Statements）
total	所有类型的警告总数
high	所有类型的高优先级警告总数
medium	所有类型的中等/普通优先级警告总数
low	所有类型的低优先级警告总数
filename	数据库文件名

2. 示例

2.1. 使用提供的 shell 脚本挖掘历史数据

以下所有示例中的命令都在一个包含 jdk1.6.0-b12、jdk1.6.0-b13、……、jdk1.6.0-b60 等子目录的目录中执行。

你可以使用以下命令：

computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates

生成以下输出：

seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	4	0	0	0	0	4
1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	4	0	4
2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	0	0	2	0	2	0	2
3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	0	0	1	0	1	2	1
4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	0	0	1	3	1
5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	0	0	1	3	1
6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1	3	1
7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	0	0	1	3	1
8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1	3	1
9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	0	0	1	3	1
10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	0	0	0	0	1	3	1
11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1	3	1
12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	0	0	0	0	1	3	1
13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1	3	1
14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1	3	1
15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	0	0	0	0	1	3	1
16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	0	0	0	0	1	3	1
17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1	3	2
18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	0	0	0	2	3	2
19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	2	3	2
20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	0	0	0	2	3	2
21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	0	0	0	0	2	3	2
22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	0	1	0	0	2	3	3
23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	0	2	0	0	3	3	5
24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	5	3	5
25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	0	0	0	0	5	3	5
26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	0	0	0	0	5	3	5
27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	5	3	5
28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	0	0	1	0	4	3	4
29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	0	0	0	0	4	4	4
30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	0	0	1	0	3	4	3
31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	3	5	3
32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	0	0	0	0	3	5	3
33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	1	0	0	0	3	5	4
34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	0	0	0	0	4	5	4
35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	0	0	4	5	4
36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	0	0	1	0	3	5	3
37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	3	6	3
38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	0	0	0	0	3	6	3
39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	0	0	0	0	3	6	3
40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	3	6	3
41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	0	0	0	3	6	3
42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	0	0	0	0	3	6	3
43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	3	6	3

我们也可以不生成中间的 db.xml 文件，直接使用如下命令生成该信息：

computeBugHistory  jdk1.6.0-b*/jre/lib/rt.xml | filterBugs -bugPattern IL_ db.xml | mineBugHistory -formatDates

然后，我们可以利用这些信息绘制一张图表，显示 FindBugs 在 Sun JDK1.6.0 各个构建版本中发现的无限递归循环数量。蓝色区域表示该构建版本中存在的无限递归循环数量；其上方的红色区域表示曾在先前某个版本中存在、但在当前版本中已不存在的无限递归循环数量（因此，红色与蓝色区域的合并高度保证不会下降，并且每当引入一个新的无限递归循环缺陷时就会上升）。红色区域的高度按每个版本的 fixed、removed 和 dead 三个值之和计算。第 13 和第 14 个构建版本中的数量下降，发生在 Sun 收到关于 FindBugs 在 JDK 中所发现缺陷的通知之后。

给定包含所有 jdk1.6.0 构建版本结果的 db.xml 文件，下面的命令将显示高优先级和中优先级正确性警告的历史记录：

filterBugs -priority M -category C db.xml | mineBugHistory -formatDates

生成表格：

seq	version	time	classes	NCSS	added	newCode	fixed	removed	retained	dead	active
0	jdk1.6.0-b12	"Thu Nov 11 09:07:20 EST 2004"	13128	811569	0	1075	0	0	0	0	1075
1	jdk1.6.0-b13	"Thu Nov 18 06:02:06 EST 2004"	13128	811570	0	0	0	0	1075	0	1075
2	jdk1.6.0-b14	"Thu Dec 02 06:12:26 EST 2004"	13145	811786	3	0	6	0	1069	0	1072
3	jdk1.6.0-b15	"Thu Dec 09 06:07:04 EST 2004"	13174	811693	2	1	3	0	1069	6	1072
4	jdk1.6.0-b16	"Thu Dec 16 06:21:28 EST 2004"	13175	811715	0	0	1	0	1071	9	1071
5	jdk1.6.0-b17	"Thu Dec 23 06:27:22 EST 2004"	13176	811974	0	0	1	0	1070	10	1070
6	jdk1.6.0-b19	"Thu Jan 13 06:41:16 EST 2005"	13176	812011	0	0	0	0	1070	11	1070
7	jdk1.6.0-b21	"Thu Jan 27 05:57:52 EST 2005"	13177	812173	0	0	1	0	1069	11	1069
8	jdk1.6.0-b23	"Thu Feb 10 05:44:36 EST 2005"	13179	812188	0	0	0	0	1069	12	1069
9	jdk1.6.0-b26	"Thu Mar 03 06:04:02 EST 2005"	13199	811770	0	0	2	1	1066	12	1066
10	jdk1.6.0-b27	"Thu Mar 10 04:48:38 EST 2005"	13189	812440	1	0	1	1	1064	15	1065
11	jdk1.6.0-b28	"Thu Mar 17 02:54:22 EST 2005"	13185	812056	0	0	0	0	1065	17	1065
12	jdk1.6.0-b29	"Thu Mar 24 03:09:20 EST 2005"	13117	809468	3	0	8	26	1031	17	1034
13	jdk1.6.0-b30	"Thu Mar 31 02:53:32 EST 2005"	13118	809501	0	0	0	0	1034	51	1034
14	jdk1.6.0-b31	"Thu Apr 07 03:00:14 EDT 2005"	13117	809572	0	0	0	0	1034	51	1034
15	jdk1.6.0-b32	"Thu Apr 14 02:56:56 EDT 2005"	13169	811096	1	1	0	1	1033	51	1035
16	jdk1.6.0-b33	"Thu Apr 21 02:46:22 EDT 2005"	13187	811942	3	0	2	1	1032	52	1035
17	jdk1.6.0-b34	"Thu Apr 28 02:49:00 EDT 2005"	13195	813488	0	1	0	0	1035	55	1036
18	jdk1.6.0-b35	"Thu May 05 02:49:04 EDT 2005"	13457	829837	0	36	2	0	1034	55	1070
19	jdk1.6.0-b36	"Thu May 12 02:59:46 EDT 2005"	13462	831278	0	0	0	0	1070	57	1070
20	jdk1.6.0-b37	"Thu May 19 02:55:08 EDT 2005"	13464	831971	0	1	1	0	1069	57	1070
21	jdk1.6.0-b38	"Thu May 26 03:08:16 EDT 2005"	13564	836565	1	7	2	6	1062	58	1070
22	jdk1.6.0-b39	"Fri Jun 03 03:10:48 EDT 2005"	13856	849992	6	39	5	0	1065	66	1110
23	jdk1.6.0-b40	"Thu Jun 09 03:30:28 EDT 2005"	15972	959619	7	147	11	0	1099	71	1253
24	jdk1.6.0-b41	"Thu Jun 16 03:19:22 EDT 2005"	15972	959619	0	0	0	0	1253	82	1253
25	jdk1.6.0-b42	"Fri Jun 24 03:38:54 EDT 2005"	15966	958581	3	0	1	2	1250	82	1253
26	jdk1.6.0-b43	"Thu Jul 14 03:09:34 EDT 2005"	16041	960544	5	11	15	8	1230	85	1246
27	jdk1.6.0-b44	"Thu Jul 21 03:05:54 EDT 2005"	16041	960547	0	0	0	0	1246	108	1246
28	jdk1.6.0-b45	"Thu Jul 28 03:26:10 EDT 2005"	16037	960606	19	0	2	0	1244	108	1263
29	jdk1.6.0-b46	"Thu Aug 04 03:02:48 EDT 2005"	15936	951355	13	1	1	32	1230	110	1244
30	jdk1.6.0-b47	"Thu Aug 11 03:18:56 EDT 2005"	15964	952387	163	8	7	20	1217	143	1388
31	jdk1.6.0-b48	"Thu Aug 18 08:10:40 EDT 2005"	15970	953421	0	0	0	0	1388	170	1388
32	jdk1.6.0-b49	"Thu Aug 25 03:24:38 EDT 2005"	16048	958940	1	11	1	0	1387	170	1399
33	jdk1.6.0-b50	"Thu Sep 01 01:52:40 EDT 2005"	16287	974937	19	27	16	7	1376	171	1422
34	jdk1.6.0-b51	"Thu Sep 08 01:55:36 EDT 2005"	16362	979377	1	15	3	0	1419	194	1435
35	jdk1.6.0-b52	"Thu Sep 15 02:04:08 EDT 2005"	16477	979399	0	0	1	1	1433	197	1433
36	jdk1.6.0-b53	"Thu Sep 22 02:00:28 EDT 2005"	16019	957900	13	12	16	20	1397	199	1422
37	jdk1.6.0-b54	"Thu Sep 29 01:54:34 EDT 2005"	16019	957900	0	0	0	0	1422	235	1422
38	jdk1.6.0-b55	"Thu Oct 06 01:54:14 EDT 2005"	16051	959014	1	4	7	0	1415	235	1420
39	jdk1.6.0-b56	"Thu Oct 13 01:54:12 EDT 2005"	16211	970835	6	8	37	0	1383	242	1397
40	jdk1.6.0-b57	"Thu Oct 20 01:55:26 EDT 2005"	16279	971627	0	0	0	0	1397	279	1397
41	jdk1.6.0-b58	"Thu Oct 27 01:56:30 EDT 2005"	16283	971945	0	1	1	0	1396	279	1397
42	jdk1.6.0-b59	"Thu Nov 03 01:56:58 EST 2005"	16232	972193	6	0	5	0	1392	280	1398
43	jdk1.6.0-b60	"Thu Nov 10 01:54:18 EST 2005"	16235	972346	0	0	0	0	1398	285	1398
44	jdk1.6.0-b61	"Thu Nov 17 01:58:42 EST 2005"	16202	971134	2	0	4	0	1394	285	1396

2.2. 增量式历史维护

如果 db.xml 中包含对构建 b12 到 b60 运行 FindBugs 的结果，我们可以使用以下命令更新 db.xml，将 b61 的分析结果纳入其中：

computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml

3. Ant 示例

下面是一个完整的 ant 脚本示例，既包含运行 FindBugs，也包含在之后运行一整套数据挖掘工具：


<project name="analyze_asm_util" default="findbugs">
   <!-- findbugs task definition -->
   <property name="findbugs.home" value="/Users/ben/Documents/workspace/findbugs/findbugs" />
   <property name="jvmargs" value="-server -Xss1m -Xmx800m -Duser.language=en -Duser.region=EN -Dfindbugs.home=${findbugs.home}" />

    <path id="findbugs.lib">
      <fileset dir="${findbugs.home}/lib">
         <include name="findbugs-ant.jar"/>
      </fileset>
   </path>

   <taskdef name="findbugs" classname="edu.umd.cs.findbugs.anttask.FindBugsTask">
      <classpath refid="findbugs.lib" />
   </taskdef>

   <taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask">
      <classpath refid="findbugs.lib" />
   </taskdef>

   <taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask">
      <classpath refid="findbugs.lib" />
   </taskdef>

   <taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask">
      <classpath refid="findbugs.lib" />
   </taskdef>

   <!-- findbugs task definition -->
   <target name="findbugs">
      <antcall target="analyze" />
      <antcall target="mine" />
   </target>

   <!-- analyze task -->
   <target name="analyze">
      <!-- run findbugs against asm-util -->
      <findbugs home="${findbugs.home}"
                output="xml:withMessages"
                timeout="90000000"
                reportLevel="experimental"
                workHard="true"
                effort="max"
                adjustExperimental="true"
                jvmargs="${jvmargs}"
                failOnError="true"
                outputFile="out.xml"
                projectName="Findbugs"
                debug="false">
         <class location="asm-util-3.0.jar" />
      </findbugs>
   </target>

   <target name="mine">

      <!-- Set info to the latest analysis -->
      <setBugDatabaseInfo home="${findbugs.home}"
                            withMessages="true"
                            name="asm-util-3.0.jar"
                            input="out.xml"
                            output="out-rel.xml"/>

      <!-- Checking if history file already exists (out-hist.xml) -->
      <condition property="mining.historyfile.available">
         <available file="out-hist.xml"/>
      </condition>
      <condition property="mining.historyfile.notavailable">
         <not>
            <available file="out-hist.xml"/>
         </not>
      </condition>

      <!-- this target is executed if the history file do not exist (first run) -->
      <antcall target="history-init">
        <param name="data.file" value="out-rel.xml" />
        <param name="hist.file" value="out-hist.xml" />
      </antcall>
      <!-- else this one is executed -->
      <antcall target="history">
        <param name="data.file"         value="out-rel.xml" />
        <param name="hist.file"         value="out-hist.xml" />
        <param name="hist.summary.file" value="out-hist.txt" />
      </antcall>
   </target>

   <!-- Initializing history file -->
   <target name="history-init" if="mining.historyfile.notavailable">
      <copy file="${data.file}" tofile="${hist.file}" />
   </target>

   <!-- Computing bug history -->
   <target name="history" if="mining.historyfile.available">
      <!-- Merging ${data.file} into ${hist.file} -->
      <computeBugHistory home="${findbugs.home}"
                           withMessages="true"
                           output="${hist.file}">
            <dataFile name="${hist.file}"/>
            <dataFile name="${data.file}"/>
      </computeBugHistory>

      <!-- Compute history into ${hist.summary.file} -->
      <mineBugHistory home="${findbugs.home}"
                        formatDates="true"
                      noTabs="true"
                        input="${hist.file}"
                        output="${hist.summary.file}"/>
   </target>

</project>