Index: doc/ja/manual/datamining.html |
diff --git a/doc/ja/manual/datamining.html b/doc/ja/manual/datamining.html |
index 3f0caab377f0237cbac090d27689365931d1a502..27f97a37db22d214f605050e3d79afd44f66783d 100644 |
--- a/doc/ja/manual/datamining.html |
+++ b/doc/ja/manual/datamining.html |
@@ -1,6 +1,6 @@ |
<html><head> |
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
- <title>第12章 FindBugs™ によるデータ・マイニング</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="FindBugs™ マニュアル"><link rel="up" href="index.html" title="FindBugs™ マニュアル"><link rel="prev" href="rejarForAnalysis.html" title="第11章 rejarForAnalysis の使用方法"><link rel="next" href="license.html" title="第13章 ライセンス"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">第12章 <span class="application">FindBugs</span>™ によるデータ・マイニング</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="rejarForAnalysis.html">戻る</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="license.html">次へ</a></td></tr></table><hr></div><div class="chapter" title="第12章 FindBugs™ によるデータ・マイニング"><div class="titlepage"><div><div><h2 class="title"><a name="datamining"></a>第12章 <span class="application">FindBugs</span>™ によるデータ・マイニング</h2></div></div></div><div class="toc"><p><b>目次</b></p><dl><dt><span class="sect1"><a href="datamining.html#commands">1. コマンド</a></span></dt><dt><span class="sect1"><a href="datamining.html#examples">2. 例</a></span></dt><dt><span class="sect1"><a href="datamining.html#antexample">3. Ant の例</a></span></dt></dl></div><p>バグデータベースへの高機能の問い合わせ機能、および、調査対象のコードの複数のバージョンにわたる警告の追跡記録機能を、 FindBugs は内蔵しています。これらを使って次のようなことができます。すなわち、いつバグが最初持ち込まれたかを捜し出すこと、最終リリース以後持ち込まれた警告の分析を行うこと、または、無限再起ループの数を時間軸でグラフにすることです。</p><p>これらの技術は、 FindBugs が警告の保存に使う XML 書式を使用します。これらの XML ファイルは、通常、特定の 1 分析に対する警告が入れられています。しかしそれらには、一連のソフトウェアのビルドやバージョンに対する分析結果を格納することもできます。</p><p>すべての FindBugs XML バグデータベースには、バージョン名とタイム・スタンプ が入れられています。FindBugs は分析が行われるファイルの更新時刻からタイム・スタンプを計算します (例えば、タイム・スタンプはクラスファイルの生成時刻になるようになっています。分析が行われた時刻ではありません) 。各々のバグデータベースには、バージョン名も入れられています。バージョン名とタイム・スタンプは、 <span class="command"><strong>setBugDatabaseInfo</strong></span> (<a class="xref" href="datamining.html#setBugDatabaseInfo" title="1.7. setBugDatabaseInfo">「setBugDatabaseInfo」</a>) コマンドを使用して手動で設定することもできます。</p><p>複数バージョンを格納するバグデータベースにおいては、分析されるコードの各バージョンごとにシーケンス番号が割り当てられます。これらのシーケンス番号は単に 0 から始まる連続する整数値です (例えば、 4 つのコードバージョンを格納するバグデータベースには、バージョン 0~3 が入れられます) 。バグデータベースにはまた、各バージョンの名前とタイム・スタンプがそれぞれ記録されます。<span class="command"><strong>filterBugs</strong></span> コマンドを使用すると、シーケンス番号、バージョン名またはタイム・スタンプからバージョンを参照することができます。</p><p>1 バージョンを格納するバグデータベースの集合から、 1 個の複数バージョンバグデータベースを作成することができます。また、複数バージョンバグデータベースに対して、それ以後に作成された 1 バージョンのバグデータベースを結合することができます。</p><p>これらのコマンドのいくつかは、 ant タスクとして実行することができます。コマンドの実行方法および属性・引数の詳細は、以下を参照してください。以下のすべての例においては、 <code class="literal">findbugs.lib</code> <code class="literal">refid</code> が正しく設定されていることを前提としています。設定方法の一例を次に示します :</p><pre class="programlisting"> |
+ <title>第12章 FindBugs™ によるデータ・マイニング</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="FindBugs™ マニュアル"><link rel="up" href="index.html" title="FindBugs™ マニュアル"><link rel="prev" href="rejarForAnalysis.html" title="第11章 rejarForAnalysis の使用方法"><link rel="next" href="license.html" title="第13章 ライセンス"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">第12章 <span class="application">FindBugs</span>™ によるデータ・マイニング</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="rejarForAnalysis.html">戻る</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="license.html">次へ</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="datamining"></a>第12章 <span class="application">FindBugs</span>™ によるデータ・マイニング</h1></div></div></div><div class="toc"><p><b>目次</b></p><dl class="toc"><dt><span class="sect1"><a href="datamining.html#commands">1. コマンド</a></span></dt><dt><span class="sect1"><a href="datamining.html#examples">2. 例</a></span></dt><dt><span class="sect1"><a href="datamining.html#antexample">3. Ant の例</a></span></dt></dl></div><p>バグデータベースへの高機能の問い合わせ機能、および、調査対象のコードの複数のバージョンにわたる警告の追跡記録機能を、 FindBugs は内蔵しています。これらを使って次のようなことができます。すなわち、いつバグが最初持ち込まれたかを捜し出すこと、最終リリース以後持ち込まれた警告の分析を行うこと、または、無限再起ループの数を時間軸でグラフにすることです。</p><p>これらの技術は、 FindBugs が警告の保存に使う XML 書式を使用します。これらの XML ファイルは、通常、特定の 1 分析に対する警告が入れられています。しかしそれらには、一連のソフトウェアのビルドやバージョンに対する分析結果を格納することもできます。</p><p>すべての FindBugs XML バグデータベースには、バージョン名とタイム・スタンプ が入れられています。FindBugs は分析が行われるファイルの更新時刻からタイム・スタンプを計算します (例えば、タイム・スタンプはクラスファイルの生成時刻になるようになっています。分析が行われた時刻ではありません) 。各々のバグデータベースには、バージョン名も入れられています。バージョン名とタイム・スタンプは、 <span class="command"><strong>setBugDatabaseInfo</strong></span> (<a class="xref" href="datamining.html#setBugDatabaseInfo" title="1.7. setBugDatabaseInfo">「setBugDatabaseInfo」</a>) コマンドを使用して手動で設定することもできます。</p><p>複数バージョンを格納するバグデータベースにおいては、分析されるコードの各バージョンごとにシーケンス番号が割り当てられます。これらのシーケンス番号は単に 0 から始まる連続する整数値です (例えば、 4 つのコードバージョンを格納するバグデータベースには、バージョン 0~3 が入れられます) 。バグデータベースにはまた、各バージョンの名前とタイム・スタンプがそれぞれ記録されます。<span class="command"><strong>filterBugs</strong></span> コマンドを使用すると、シーケンス番号、バージョン名またはタイム・スタンプからバージョンを参照することができます。</p><p>1 バージョンを格納するバグデータベースの集合から、 1 個の複数バージョンバグデータベースを作成することができます。また、複数バージョンバグデータベースに対して、それ以後に作成された 1 バージョンのバグデータベースを結合することができます。</p><p>これらのコマンドのいくつかは、 ant タスクとして実行することができます。コマンドの実行方法および属性・引数の詳細は、以下を参照してください。以下のすべての例においては、 <code class="literal">findbugs.lib</code> <code class="literal">refid</code> が正しく設定されていることを前提としています。設定方法の一例を次に示します :</p><pre class="programlisting"> |
<!-- findbugs タスク定義 --> |
<property name="findbugs.home" value="/your/path/to/findbugs" /> |
@@ -10,7 +10,7 @@ |
</fileset> |
</path> |
-</pre><div class="sect1" title="1. コマンド"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="commands"></a>1. コマンド</h2></div></div></div><p>FindBugs データ・マイニング ツールはすべてコマンドラインから実行することができます。また、いくつかのより有用なコマンドは、 ant ビルドファイルから実行することができます。</p><p>コマンドラインツールについて簡単に説明します :</p><div class="variablelist"><dl><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#unionBugs" title="1.1. unionBugs">unionBugs</a></strong></span></span></dt><dd><p>別のクラスに対する別個の分析結果を結合します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#computeBugHistory" title="1.2. computeBugHistory">computeBugHistory</a></strong></span></span></dt><dd><p>複数バージョンから得られた複数のバグ警告を、マージして 1 個の複数バージョンバグデータベースにします。これを使って、既存の複数バージョンバグデータベースに更にバージョンを追加したり、 1 バージョンを格納するバグデータベースの集合から 1 個の複数バージョンバグデータベースを作成したり、できます。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#setBugDatabaseInfo" title="1.7. setBugDatabaseInfo">setBugDatabaseInfo</a></strong></span></span></dt><dd><p>リビジョン名やタイム・スタンプなどの情報を XML データベースに設定します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#listBugDatabaseInfo" title="1.8. listBugDatabaseInfo">listBugDatabaseInfo</a></strong></span></span></dt><dd><p>XML データベースにあるリビジョン名やタイム・スタンプなどの情報を一覧表示します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#filterBugs" title="1.3. filterBugs">filterBugs</a></strong></span></span></dt><dd><p>バグデータベースの部分集合を選択します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#mineBugHistory" title="1.4. mineBugHistory">mineBugHistory</a></strong></span></span></dt><dd><p>複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#defectDensity" title="1.5. defectDensity">defectDensity</a></strong></span></span></dt><dd><p>プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#convertXmlToText" title="1.6. convertXmlToText">convertXmlToText</a></strong></span></span></dt><dd><p>XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換します。</p></dd></dl></div><div class="sect2" title="1.1. unionBugs"><div class="titlepage"><div><div><h3 class="title"><a name="unionBugs"></a>1.1. unionBugs</h3></div></div></div><p>分析するのにアプリケーションの jar ファイルを分割している場合、このコマンドを使用することで、別個に生成された XML バグ警告ファイルをすべての警告を含んでいる 1 つの ファイルにすることができます。</p><p>同じファイルの異なるバージョンを分析した結果を結合する場合は、このコマンドを<span class="emphasis"><em>使用しないでください</em></span>。代わりに <span class="command"><strong>computeBugHistory</strong></span> を使用してください。</p><p>XML ファイルは、コマンドラインで指定してください。結果は、標準出力に送られます。</p></div><div class="sect2" title="1.2. computeBugHistory"><div class="titlepage"><div><div><h3 class="title"><a name="computeBugHistory"></a>1.2. computeBugHistory</h3></div></div></div><p>このコマンドを使用することで、分析するソフトウェアの異なるビルドまたはバージョンの情報を含むバグデータベースを生成することができます入力として提供したファイルの 1 番目のファイルから履歴が取得されます。後に続くファイルは 1 バージョンのバグデータベースであるようにしてください (もし、履歴を持っていたとしても無視されます) 。</p><p>デフォルトでは、結果は標準出力に送られます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>computeBugHistory</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
+</pre><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="commands"></a>1. コマンド</h2></div></div></div><p>FindBugs データ・マイニング ツールはすべてコマンドラインから実行することができます。また、いくつかのより有用なコマンドは、 ant ビルドファイルから実行することができます。</p><p>コマンドラインツールについて簡単に説明します :</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#unionBugs" title="1.1. unionBugs">unionBugs</a></strong></span></span></dt><dd><p>別のクラスに対する別個の分析結果を結合します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#computeBugHistory" title="1.2. computeBugHistory">computeBugHistory</a></strong></span></span></dt><dd><p>複数バージョンから得られた複数のバグ警告を、マージして 1 個の複数バージョンバグデータベースにします。これを使って、既存の複数バージョンバグデータベースに更にバージョンを追加したり、 1 バージョンを格納するバグデータベースの集合から 1 個の複数バージョンバグデータベースを作成したり、できます。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#setBugDatabaseInfo" title="1.7. setBugDatabaseInfo">setBugDatabaseInfo</a></strong></span></span></dt><dd><p>リビジョン名やタイム・スタンプなどの情報を XML データベースに設定します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#listBugDatabaseInfo" title="1.8. listBugDatabaseInfo">listBugDatabaseInfo</a></strong></span></span></dt><dd><p>XML データベースにあるリビジョン名やタイム・スタンプなどの情報を一覧表示します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#filterBugs" title="1.3. filterBugs">filterBugs</a></strong></span></span></dt><dd><p>バグデータベースの部分集合を選択します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#mineBugHistory" title="1.4. mineBugHistory">mineBugHistory</a></strong></span></span></dt><dd><p>複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#defectDensity" title="1.5. defectDensity">defectDensity</a></strong></span></span></dt><dd><p>プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示します。</p></dd><dt><span class="term"><span class="command"><strong><a class="link" href="datamining.html#convertXmlToText" title="1.6. convertXmlToText">convertXmlToText</a></strong></span></span></dt><dd><p>XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換します。</p></dd></dl></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="unionBugs"></a>1.1. unionBugs</h3></div></div></div><p>分析するのにアプリケーションの jar ファイルを分割している場合、このコマンドを使用することで、別個に生成された XML バグ警告ファイルをすべての警告を含んでいる 1 つの ファイルにすることができます。</p><p>同じファイルの異なるバージョンを分析した結果を結合する場合は、このコマンドを<span class="emphasis"><em>使用しないでください</em></span>。代わりに <span class="command"><strong>computeBugHistory</strong></span> を使用してください。</p><p>XML ファイルは、コマンドラインで指定してください。結果は、標準出力に送られます。</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="computeBugHistory"></a>1.2. computeBugHistory</h3></div></div></div><p>このコマンドを使用することで、分析するソフトウェアの異なるビルドまたはバージョンの情報を含むバグデータベースを生成することができます入力として提供したファイルの 1 番目のファイルから履歴が取得されます。後に続くファイルは 1 バージョンのバグデータベースであるようにしてください (もし、履歴を持っていたとしても無視されます) 。</p><p>デフォルトでは、結果は標準出力に送られます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>computeBugHistory</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
<taskdef name="computeBugHistory" classname="edu.umd.cs.findbugs.anttask.ComputeBugHistoryTask"> |
<classpath refid="findbugs.lib" /> |
@@ -23,7 +23,7 @@ |
<datafile name="analyze2.xml"/> |
</computeBugHistory> |
-</pre><div class="table"><a name="computeBugHistoryTable"></a><p class="title"><b>表12.1 computeBugHistory コマンドのオプション一覧</b></p><div class="table-contents"><table summary="computeBugHistory コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">-output <file></td><td align="left">output="<file>"</td><td align="left">出力結果を保存するファイル名を指定します。 (同時に入力ファイルにもなりえます)</td></tr><tr><td align="left">-overrideRevisionNames[:truth]</td><td align="left">overrideRevisionNames="[true|false]"</td><td align="left">ファイル名から算出されるそれぞれのバージョン名を指定変更します。</td></tr><tr><td align="left">-noPackageMoves[:truth]</td><td align="left">noPackageMoves="[true|false]"</td><td align="left">パッケージを移動したクラスがある場合、当該クラスの警告は別の存在として扱われます。</td></tr><tr><td align="left">-preciseMatch[:truth]</td><td align="left">preciseMatch="[true|false]"</td><td align="left">バグパターンが正確に一致することを要求します。</td></tr><tr><td align="left">-precisePriorityMatch[:truth]</td><td align="left">precisePriorityMatch="[true|false]"</td><td align="left">優先度が正確に一致した場合のみ警告が同一であると判断されます。</td></tr><tr><td align="left">-quiet[:truth]</td><td align="left">quiet="[true|false]"</td><td align="left">エラーが発生しない限り、標準出力には何も表示されません。</td></tr><tr><td align="left">-withMessages[:truth]</td><td align="left">withMessages="[true|false]"</td><td align="left">出力 XML に人間が読むことができるバグメッセージが含まれます。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="1.3. filterBugs"><div class="titlepage"><div><div><h3 class="title"><a name="filterBugs"></a>1.3. filterBugs</h3></div></div></div><p>このコマンドを使用することで、 FindBugs XML 警告ファイルから一部分を選び出して新規 FindBugs 警告ファイルに選択された部分を書き込むことができます。</p><p>このコマンドには、オプション群に続いて 0 個から 2 個の findbugs xml バグファイルを指定することができます。</p><p>ファイル名をひとつも指定しない場合は、標準入力から読んで標準出力に出力されます。ファイル名を 1 個 指定した場合は、指定したファイルから読んで標準出力に出力されます。ファイル名を 2 個 指定した場合は、 1 番目に指定したファイルから読んで 2 番目に指定したファイルに出力されます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>filterBugs</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
+</pre><div class="table"><a name="computeBugHistoryTable"></a><p class="title"><b>表12.1 computeBugHistory コマンドのオプション一覧</b></p><div class="table-contents"><table summary="computeBugHistory コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">-output <file></td><td align="left">output="<file>"</td><td align="left">出力結果を保存するファイル名を指定します。 (同時に入力ファイルにもなりえます)</td></tr><tr><td align="left">-overrideRevisionNames[:truth]</td><td align="left">overrideRevisionNames="[true|false]"</td><td align="left">ファイル名から算出されるそれぞれのバージョン名を指定変更します。</td></tr><tr><td align="left">-noPackageMoves[:truth]</td><td align="left">noPackageMoves="[true|false]"</td><td align="left">パッケージを移動したクラスがある場合、当該クラスの警告は別の存在として扱われます。</td></tr><tr><td align="left">-preciseMatch[:truth]</td><td align="left">preciseMatch="[true|false]"</td><td align="left">バグパターンが正確に一致することを要求します。</td></tr><tr><td align="left">-precisePriorityMatch[:truth]</td><td align="left">precisePriorityMatch="[true|false]"</td><td align="left">優先度が正確に一致した場合のみ警告が同一であると判断されます。</td></tr><tr><td align="left">-quiet[:truth]</td><td align="left">quiet="[true|false]"</td><td align="left">エラーが発生しない限り、標準出力には何も表示されません。</td></tr><tr><td align="left">-withMessages[:truth]</td><td align="left">withMessages="[true|false]"</td><td align="left">出力 XML に人間が読むことができるバグメッセージが含まれます。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="filterBugs"></a>1.3. filterBugs</h3></div></div></div><p>このコマンドを使用することで、 FindBugs XML 警告ファイルから一部分を選び出して新規 FindBugs 警告ファイルに選択された部分を書き込むことができます。</p><p>このコマンドには、オプション群に続いて 0 個から 2 個の findbugs xml バグファイルを指定することができます。</p><p>ファイル名をひとつも指定しない場合は、標準入力から読んで標準出力に出力されます。ファイル名を 1 個 指定した場合は、指定したファイルから読んで標準出力に出力されます。ファイル名を 2 個 指定した場合は、 1 番目に指定したファイルから読んで 2 番目に指定したファイルに出力されます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>filterBugs</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
<taskdef name="filterBugs" classname="edu.umd.cs.findbugs.anttask.FilterBugsTask"> |
<classpath refid="findbugs.lib" /> |
@@ -35,7 +35,7 @@ |
<datafile name="analyze.xml"/> |
</filterBugs> |
-</pre><div class="table"><a name="filterOptionsTable"></a><p class="title"><b>表12.2 filterBugs コマンドのオプション一覧</b></p><div class="table-contents"><table summary="filterBugs コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-not</td><td align="left">not="[true|false]"</td><td align="left">フィルターのスイッチを反転します。</td></tr><tr><td align="left">-withSource[:truth]</td><td align="left">withSource="[true|false]"</td><td align="left">ソースが入手可能な警告のみ出力されます。</td></tr><tr><td align="left">-exclude <filter file></td><td align="left">exclude="<filter file>"</td><td align="left">フィルターに一致するバグが除外されます。</td></tr><tr><td align="left">-include <filter file></td><td align="left">include="<filter file>"</td><td align="left">フィルターに一致するバグのみを含まれます。</td></tr><tr><td align="left">-annotation <text></td><td align="left">annotation="<text>"</td><td align="left">手で入力した注釈に指定した文言を含む警告のみ出力されます。</td></tr><tr><td align="left">-after <when></td><td align="left">after="<when>"</td><td align="left">指定したバージョンより後に初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-before <when></td><td align="left">before="<when>"</td><td align="left">指定したバージョンより前に初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-first <when></td><td align="left">first="<when>"</td><td align="left">指定したバージョンに初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-last <when></td><td align="left">last="<when>"</td><td align="left">指定したバージョンが出現した最後である警告のみ出力されます。</td></tr><tr><td align="left">-fixed <when></td><td align="left">fixed="<when>"</td><td align="left">指定したバージョンの前回のバージョンが出現した最後である警告のみ出力されます。 (<code class="option">-last</code> に優先します)。</td></tr><tr><td align="left">-present <when></td><td align="left">present="<when>"</td><td align="left">指定したバージョンに存在する警告のみ出力されます。</td></tr><tr><td align="left">-absent <when></td><td align="left">absent="<when>"</td><td align="left">指定したバージョンに存在しない警告のみ出力されます。</td></tr><tr><td align="left">-active[:truth]</td><td align="left">active="[true|false]"</td><td align="left">最終通番に存在する警告のみ出力されます。</td></tr><tr><td align="left">-introducedByChange[:truth]</td><td align="left">introducedByChange="[true|false]"</td><td align="left">存在するクラスの変更によってもたらされた警告のみ出力されます。</td></tr><tr><td align="left">-removedByChange[:truth]</td><td align="left">removedByChange="[true|false]"</td><td align="left">存在するクラスの変更によって除去された警告のみ出力されます。</td></tr><tr><td align="left">-newCode[:truth]</td><td align="left">newCode="[true|false]"</td><td align="left">新クラスの追加によってもたらされた警告のみ出力されます。</td></tr><tr><td align="left">-removedCode[:truth]</td><td align="left">removedCode="[true|false]"</td><td align="left">クラスの削除によって除去された警告のみ出力されます。</td></tr><tr><td align="left">-priority <level></td><td align="left">priority="<level>"</td><td align="left">指定した優先度以上の優先度をもつ警告のみ出力されます。</td></tr><tr><td align="left">-maxRank <rank></td><td align="left">rank="[1..20]"</td><td align="left">allow only warnings with this rank or lower</td></tr><tr><td align="left">-class <pattern></td><td align="left">class="<class>"</td><td align="left">指定したパターンに一致する主クラスをもつ警告のみ出力されます。</td></tr><tr><td align="left">-bugPattern <pattern></td><td align="left">bugPattern="<pattern>"</td><td align="left">指定したパターンに一致するバグ種別をもつ警告のみ出力されます。</td></tr><tr><td align="left">-category <category></td><td align="left">category="<category>"</td><td align="left">指定した文字列で始まるカテゴリーの警告のみ出力されます。</td></tr><tr><td align="left">-designation <designation></td><td align="left">designation="<designation>"</td><td align="left">指定したバグ分類指定をもつ警告のみ出力されます。 (例、 -designation SHOULD_FIX)</td></tr><tr><td align="left">-withMessages[:truth] </td><td align="left">withMessages="[true|false]"</td><td align="left">テキストメッセージを含んだ XML が生成されます。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="1.4. mineBugHistory"><div class="titlepage"><div><div><h3 class="title"><a name="mineBugHistory"></a>1.4. mineBugHistory</h3></div></div></div><p>このコマンドを使用することで、複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成することができます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>mineBugHistory</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
+</pre><div class="table"><a name="filterOptionsTable"></a><p class="title"><b>表12.2 filterBugs コマンドのオプション一覧</b></p><div class="table-contents"><table summary="filterBugs コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-not</td><td align="left">not="[true|false]"</td><td align="left">フィルターのスイッチを反転します。</td></tr><tr><td align="left">-withSource[:truth]</td><td align="left">withSource="[true|false]"</td><td align="left">ソースが入手可能な警告のみ出力されます。</td></tr><tr><td align="left">-exclude <filter file></td><td align="left">exclude="<filter file>"</td><td align="left">フィルターに一致するバグが除外されます。</td></tr><tr><td align="left">-include <filter file></td><td align="left">include="<filter file>"</td><td align="left">フィルターに一致するバグのみを含まれます。</td></tr><tr><td align="left">-annotation <text></td><td align="left">annotation="<text>"</td><td align="left">手で入力した注釈に指定した文言を含む警告のみ出力されます。</td></tr><tr><td align="left">-after <when></td><td align="left">after="<when>"</td><td align="left">指定したバージョンより後に初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-before <when></td><td align="left">before="<when>"</td><td align="left">指定したバージョンより前に初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-first <when></td><td align="left">first="<when>"</td><td align="left">指定したバージョンに初めて出現した警告のみ出力されます。</td></tr><tr><td align="left">-last <when></td><td align="left">last="<when>"</td><td align="left">指定したバージョンが出現した最後である警告のみ出力されます。</td></tr><tr><td align="left">-fixed <when></td><td align="left">fixed="<when>"</td><td align="left">指定したバージョンの前回のバージョンが出現した最後である警告のみ出力されます。 (<code class="option">-last</code> に優先します)。</td></tr><tr><td align="left">-present <when></td><td align="left">present="<when>"</td><td align="left">指定したバージョンに存在する警告のみ出力されます。</td></tr><tr><td align="left">-absent <when></td><td align="left">absent="<when>"</td><td align="left">指定したバージョンに存在しない警告のみ出力されます。</td></tr><tr><td align="left">-active[:truth]</td><td align="left">active="[true|false]"</td><td align="left">最終通番に存在する警告のみ出力されます。</td></tr><tr><td align="left">-introducedByChange[:truth]</td><td align="left">introducedByChange="[true|false]"</td><td align="left">存在するクラスの変更によってもたらされた警告のみ出力されます。</td></tr><tr><td align="left">-removedByChange[:truth]</td><td align="left">removedByChange="[true|false]"</td><td align="left">存在するクラスの変更によって除去された警告のみ出力されます。</td></tr><tr><td align="left">-newCode[:truth]</td><td align="left">newCode="[true|false]"</td><td align="left">新クラスの追加によってもたらされた警告のみ出力されます。</td></tr><tr><td align="left">-removedCode[:truth]</td><td align="left">removedCode="[true|false]"</td><td align="left">クラスの削除によって除去された警告のみ出力されます。</td></tr><tr><td align="left">-priority <level></td><td align="left">priority="<level>"</td><td align="left">指定した優先度以上の優先度をもつ警告のみ出力されます。</td></tr><tr><td align="left">-maxRank <rank></td><td align="left">rank="[1..20]"</td><td align="left">allow only warnings with this rank or lower</td></tr><tr><td align="left">-class <pattern></td><td align="left">class="<class>"</td><td align="left">指定したパターンに一致する主クラスをもつ警告のみ出力されます。</td></tr><tr><td align="left">-bugPattern <pattern></td><td align="left">bugPattern="<pattern>"</td><td align="left">指定したパターンに一致するバグ種別をもつ警告のみ出力されます。</td></tr><tr><td align="left">-category <category></td><td align="left">category="<category>"</td><td align="left">指定した文字列で始まるカテゴリーの警告のみ出力されます。</td></tr><tr><td align="left">-designation <designation></td><td align="left">designation="<designation>"</td><td align="left">指定したバグ分類指定をもつ警告のみ出力されます。 (例、 -designation SHOULD_FIX)</td></tr><tr><td align="left">-withMessages[:truth] </td><td align="left">withMessages="[true|false]"</td><td align="left">テキストメッセージを含んだ XML が生成されます。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="mineBugHistory"></a>1.4. mineBugHistory</h3></div></div></div><p>このコマンドを使用することで、複数バージョンバグデータベースの各バージョン毎の警告数を一覧にした表を作成することができます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>mineBugHistory</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
<taskdef name="mineBugHistory" classname="edu.umd.cs.findbugs.anttask.MineBugHistoryTask"> |
<classpath refid="findbugs.lib" /> |
@@ -47,13 +47,13 @@ |
<datafile name="analyze.xml"/> |
</mineBugHistory> |
-</pre><div class="table"><a name="mineBugHistoryOptionsTable"></a><p class="title"><b>表12.3 mineBugHistory コマンドのオプション一覧</b></p><div class="table-contents"><table summary="mineBugHistory コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-formatDates</td><td align="left">formatDates="[true|false]"</td><td align="left">データがテキスト形式で描画されます。</td></tr><tr><td align="left">-noTabs</td><td align="left">noTabs="[true|false]"</td><td align="left">タブの代わりに複数スペースでカラムが区切られます (下記参照)。</td></tr><tr><td align="left">-summary</td><td align="left">summary="[true|false]"</td><td align="left">最新 10 件の変更の要約が出力されます。</td></tr></tbody></table></div></div><br class="table-break"><p><code class="option">-noTabs</code> 出力を使うことで、固定幅フォントのシェルで読み易くなります。数値カラムは右寄せされるので、スペースがカラム値の前に挿入されます。また、このオプションを使用した場合、 <code class="option">-formatDates</code> を指定したときに要約の日付を描画するのに空白が埋め込まれなくなります。</p><p>出力される表は、 (<code class="option">-noTabs</code> が無ければ) タブ区切りで次に示すカラムから成ります :</p><div class="table"><a name="mineBugHistoryColumns"></a><p class="title"><b>表12.4 mineBugHistory 出力のカラム一覧</b></p><div class="table-contents"><table summary="mineBugHistory 出力のカラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">表題</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">seq</td><td align="left">シーケンス番号 (0 始まりの連続した整数値)</td></tr><tr><td align="left">version</td><td align="left">バージョン名</td></tr><tr><td align="left">time</td><td align="left">リリースされた日時</td></tr><tr><td align="left">classes</td><td align="left">分析されたクラス数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements)</td></tr><tr><td align="left">added</td><td align="left">前回のバージョンに存在したクラスにおける新規警告数</td></tr><tr><td align="left">newCode</td><td align="left">前回のバージョンに存在しなかったクラスにおける新規警告数</td></tr><tr><td align="left">fixed</td><td align="left">現在のバージョンに存在するクラスにおける除去された警告数</td></tr><tr><td align="left">removed</td><td align="left">現在のバージョンに存在しないクラスの前回のバージョンにおける警告数</td></tr><tr><td align="left">retained</td><td align="left">現在のバージョンと前回のバージョンの両方に存在する警告の数</td></tr><tr><td align="left">dead</td><td align="left">以前のバージョンに存在したが現在のバージョンにも直前のバージョンにも存在しない警告の数</td></tr><tr><td align="left">active</td><td align="left">現在のバージョンに存在する警告総数</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="1.5. defectDensity"><div class="titlepage"><div><div><h3 class="title"><a name="defectDensity"></a>1.5. defectDensity</h3></div></div></div><p>このコマンドを使用することで、プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示できます。標準入力から読み込む場合はファイル指定なしで、そうでなければ、コマンドラインでファイルを指定して、このコマンドを実行します。</p><p>出力される表は、次に示すカラムから成ります。また、プロジェクト全体情報の行、および、4 個以上の警告を含んでいる各パッケージ情報または各クラス情報の行も出力されます。</p><div class="table"><a name="defectDensityColumns"></a><p class="title"><b>表12.5 defectDensity 出力のカラム一覧</b></p><div class="table-contents"><table summary="defectDensity 出力のカラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">表題</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">kind</td><td align="left">プロジェクト (project)、パッケージ (package) またはクラス (class)</td></tr><tr><td align="left">name</td><td align="left">プロジェクト、パッケージまたはクラスの名前</td></tr><tr><td align="left">density</td><td align="left"> 1000 NCSS 毎の警告数</td></tr><tr><td align="left">bugs</td><td align="left">警告数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements) </td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="1.6. convertXmlToText"><div class="titlepage"><div><div><h3 class="title"><a name="convertXmlToText"></a>1.6. convertXmlToText</h3></div></div></div><p>このコマンドを使用することで、XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換することができます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>convertXmlToText</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
+</pre><div class="table"><a name="mineBugHistoryOptionsTable"></a><p class="title"><b>表12.3 mineBugHistory コマンドのオプション一覧</b></p><div class="table-contents"><table summary="mineBugHistory コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-formatDates</td><td align="left">formatDates="[true|false]"</td><td align="left">データがテキスト形式で描画されます。</td></tr><tr><td align="left">-noTabs</td><td align="left">noTabs="[true|false]"</td><td align="left">タブの代わりに複数スペースでカラムが区切られます (下記参照)。</td></tr><tr><td align="left">-summary</td><td align="left">summary="[true|false]"</td><td align="left">最新 10 件の変更の要約が出力されます。</td></tr></tbody></table></div></div><br class="table-break"><p><code class="option">-noTabs</code> 出力を使うことで、固定幅フォントのシェルで読み易くなります。数値カラムは右寄せされるので、スペースがカラム値の前に挿入されます。また、このオプションを使用した場合、 <code class="option">-formatDates</code> を指定したときに要約の日付を描画するのに空白が埋め込まれなくなります。</p><p>出力される表は、 (<code class="option">-noTabs</code> が無ければ) タブ区切りで次に示すカラムから成ります :</p><div class="table"><a name="mineBugHistoryColumns"></a><p class="title"><b>表12.4 mineBugHistory 出力のカラム一覧</b></p><div class="table-contents"><table summary="mineBugHistory 出力のカラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">表題</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">seq</td><td align="left">シーケンス番号 (0 始まりの連続した整数値)</td></tr><tr><td align="left">version</td><td align="left">バージョン名</td></tr><tr><td align="left">time</td><td align="left">リリースされた日時</td></tr><tr><td align="left">classes</td><td align="left">分析されたクラス数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements)</td></tr><tr><td align="left">added</td><td align="left">前回のバージョンに存在したクラスにおける新規警告数</td></tr><tr><td align="left">newCode</td><td align="left">前回のバージョンに存在しなかったクラスにおける新規警告数</td></tr><tr><td align="left">fixed</td><td align="left">現在のバージョンに存在するクラスにおける除去された警告数</td></tr><tr><td align="left">removed</td><td align="left">現在のバージョンに存在しないクラスの前回のバージョンにおける警告数</td></tr><tr><td align="left">retained</td><td align="left">現在のバージョンと前回のバージョンの両方に存在する警告の数</td></tr><tr><td align="left">dead</td><td align="left">以前のバージョンに存在したが現在のバージョンにも直前のバージョンにも存在しない警告の数</td></tr><tr><td align="left">active</td><td align="left">現在のバージョンに存在する警告総数</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="defectDensity"></a>1.5. defectDensity</h3></div></div></div><p>このコマンドを使用することで、プロジェクト全体およびクラス毎・パッケージ毎の不良密度 (1000 NCSS 毎の警告数) に関する情報を一覧表示できます。標準入力から読み込む場合はファイル指定なしで、そうでなければ、コマンドラインでファイルを指定して、このコマンドを実行します。</p><p>出力される表は、次に示すカラムから成ります。また、プロジェクト全体情報の行、および、4 個以上の警告を含んでいる各パッケージ情報または各クラス情報の行も出力されます。</p><div class="table"><a name="defectDensityColumns"></a><p class="title"><b>表12.5 defectDensity 出力のカラム一覧</b></p><div class="table-contents"><table summary="defectDensity 出力のカラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">表題</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">kind</td><td align="left">プロジェクト (project)、パッケージ (package) またはクラス (class)</td></tr><tr><td align="left">name</td><td align="left">プロジェクト、パッケージまたはクラスの名前</td></tr><tr><td align="left">density</td><td align="left"> 1000 NCSS 毎の警告数</td></tr><tr><td align="left">bugs</td><td align="left">警告数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements) </td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="convertXmlToText"></a>1.6. convertXmlToText</h3></div></div></div><p>このコマンドを使用することで、XML 形式のバグ警告を、 1 行 1 バグのテキスト形式、または、HTML形式に変換することができます。</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>convertXmlToText</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
<taskdef name="convertXmlToText" classname="edu.umd.cs.findbugs.anttask.ConvertXmlToTextTask"> |
<classpath refid="findbugs.lib" /> |
</taskdef> |
-</pre><p>この ant タスクに指定できる属性を、下表に一覧で示します。</p><div class="table"><a name="convertXmlToTextTable"></a><p class="title"><b>表12.6 convertXmlToText コマンドのオプション一覧</b></p><div class="table-contents"><table summary="convertXmlToText コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<filename>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<filename>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-longBugCodes</td><td align="left">longBugCodes="[true|false]"</td><td align="left">2 文字のバグ略称の代わりに、省略なしのバグパターンコードを使用します。</td></tr><tr><td align="left"> </td><td align="left">format="text"</td><td align="left">プレーンテキストの出力が作成されます。1 行につき 1 つのバグが出力されます。コマンドライン時のデフォルトです。</td></tr><tr><td align="left">-html[:stylesheet]</td><td align="left">format="html:<stylesheet>"</td><td align="left">指定されたスタイルシートを使用して出力が作成されます (下記参照) 。省略した場合は、 default.xsl が使用されます。</td></tr></tbody></table></div></div><br class="table-break"><p>-html/format オプションには、plain.xsl 、 default.xsl 、 fancy.xsl 、 fancy-hist.xsl または ユーザ自身が作成した XSL スタイルシートのいずれかを指定することができます。オプション名をよそに、 html 以外の形式を出力するスタイルシートを指定することもできます。FindBugs に含まれているスタイルシート(上述)以外のスタイルシートを使用する場合は、オプション -html/format で当該スタイルシートへのパスまたは URL を指定してください。</p></div><div class="sect2" title="1.7. setBugDatabaseInfo"><div class="titlepage"><div><div><h3 class="title"><a name="setBugDatabaseInfo"></a>1.7. setBugDatabaseInfo</h3></div></div></div><p>このコマンドを使用することで、指定したバグ警告にメタ情報を設定することができます。このコマンドには次に示すオプションがあります:</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>setBugDatabaseInfo</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
+</pre><p>この ant タスクに指定できる属性を、下表に一覧で示します。</p><div class="table"><a name="convertXmlToTextTable"></a><p class="title"><b>表12.6 convertXmlToText コマンドのオプション一覧</b></p><div class="table-contents"><table summary="convertXmlToText コマンドのオプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<filename>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<filename>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-longBugCodes</td><td align="left">longBugCodes="[true|false]"</td><td align="left">2 文字のバグ略称の代わりに、省略なしのバグパターンコードを使用します。</td></tr><tr><td align="left"> </td><td align="left">format="text"</td><td align="left">プレーンテキストの出力が作成されます。1 行につき 1 つのバグが出力されます。コマンドライン時のデフォルトです。</td></tr><tr><td align="left">-html[:stylesheet]</td><td align="left">format="html:<stylesheet>"</td><td align="left">指定されたスタイルシートを使用して出力が作成されます (下記参照) 。省略した場合は、 default.xsl が使用されます。</td></tr></tbody></table></div></div><br class="table-break"><p>-html/format オプションには、plain.xsl 、 default.xsl 、 fancy.xsl 、 fancy-hist.xsl または ユーザ自身が作成した XSL スタイルシートのいずれかを指定することができます。オプション名をよそに、 html 以外の形式を出力するスタイルシートを指定することもできます。FindBugs に含まれているスタイルシート(上述)以外のスタイルシートを使用する場合は、オプション -html/format で当該スタイルシートへのパスまたは URL を指定してください。</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="setBugDatabaseInfo"></a>1.7. setBugDatabaseInfo</h3></div></div></div><p>このコマンドを使用することで、指定したバグ警告にメタ情報を設定することができます。このコマンドには次に示すオプションがあります:</p><p>この機能は、 ant からも使用することができます。まず次に示すように、ビルドファイルに <span class="command"><strong>setBugDatabaseInfo</strong></span> を taskdef で定義します :</p><pre class="programlisting"> |
<taskdef name="setBugDatabaseInfo" classname="edu.umd.cs.findbugs.anttask.SetBugDatabaseInfoTask"> |
<classpath refid="findbugs.lib" /> |
@@ -65,7 +65,7 @@ |
<datafile name="analyze.xml"/> |
</setBugDatabaseInfo> |
-</pre><div class="table"><a name="setBugDatabaseInfoOptions"></a><p class="title"><b>表12.7 setBugDatabaseInfo オプション一覧</b></p><div class="table-contents"><table summary="setBugDatabaseInfo オプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-name <name></td><td align="left">name="<name>"</td><td align="left">最新リビジョンの名前を設定します。</td></tr><tr><td align="left">-timestamp <when></td><td align="left">timestamp="<when>"</td><td align="left">最新リビジョンのタイム・スタンプを設定します。</td></tr><tr><td align="left">-source <directory></td><td align="left">source="<directory>"</td><td align="left">ソースを検索するディレクトリーを追加指定します。</td></tr><tr><td align="left">-findSource <directory></td><td align="left">findSource="<directory>"</td><td align="left">指定したディレクトリー内を検索して関連するソースの場所を追加します。</td></tr><tr><td align="left">-suppress <filter file></td><td align="left">suppress="<filter file>"</td><td align="left">指定したファイルに一致する警告を抑止します (以前に指定した抑止設定は置き換えられます)。</td></tr><tr><td align="left">-withMessages</td><td align="left">withMessages="[true|false]"</td><td align="left">XMLにテキストメッセージを追加します。</td></tr><tr><td align="left">-resetSource</td><td align="left">resetSource="[true|false]"</td><td align="left">ソース検索パスをすべて削除します。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2" title="1.8. listBugDatabaseInfo"><div class="titlepage"><div><div><h3 class="title"><a name="listBugDatabaseInfo"></a>1.8. listBugDatabaseInfo</h3></div></div></div><p>このコマンドの実行においては、コマンドラインで 0 個以上の xml バグデータベースファイル名を指定します。ファイル名を1つも指定しなければ、標準出力から読み込みを行いテーブルのヘッダーは生成されません。</p><p>このコマンドには 1 つだけオプションがあります : <code class="option">-formatDates</code> を指定するとテキスト形式でデータが描画されます。</p><p>出力される表は、各バグデータベースごとに行を持ち、次に示すカラムから成ります :</p><div class="table"><a name="listBugDatabaseInfoColumns"></a><p class="title"><b>表12.8 listBugDatabaseInfo カラム一覧</b></p><div class="table-contents"><table summary="listBugDatabaseInfo カラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">カラム</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">version</td><td align="left">バージョン名</td></tr><tr><td align="left">time</td><td align="left">リリースされた日時</td></tr><tr><td align="left">classes</td><td align="left">分析されたクラス数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements)</td></tr><tr><td align="left">total</td><td align="left">全警告数</td></tr><tr><td align="left">high</td><td align="left">優先度(高)の警告の総数</td></tr><tr><td align="left">medium</td><td align="left">優先度(中)の警告の総数</td></tr><tr><td align="left">low</td><td align="left">優先度(低)の警告の総数</td></tr><tr><td align="left">filename</td><td align="left">データベースのファイル名</td></tr></tbody></table></div></div><br class="table-break"></div></div><div class="sect1" title="2. 例"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="examples"></a>2. 例</h2></div></div></div><div class="sect2" title="2.1. 提供されたシェル・スクリプトを使用しての履歴マイニング"><div class="titlepage"><div><div><h3 class="title"><a name="unixscriptsexamples"></a>2.1. 提供されたシェル・スクリプトを使用しての履歴マイニング</h3></div></div></div><p>以下はすべて、 jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60 のディレクトリに対してコマンドを実行しています。</p><p>以下のコマンドを実行してみます :</p><pre class="screen"> |
+</pre><div class="table"><a name="setBugDatabaseInfoOptions"></a><p class="title"><b>表12.7 setBugDatabaseInfo オプション一覧</b></p><div class="table-contents"><table summary="setBugDatabaseInfo オプション一覧" border="1"><colgroup><col><col><col></colgroup><thead><tr><th align="left">コマンドラインオプション</th><th align="left">Ant 属性</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left"> </td><td align="left">input="<file>"</td><td align="left">入力ファイルを指定します。</td></tr><tr><td align="left"> </td><td align="left">output="<file>"</td><td align="left">出力ファイルを指定します。</td></tr><tr><td align="left">-name <name></td><td align="left">name="<name>"</td><td align="left">最新リビジョンの名前を設定します。</td></tr><tr><td align="left">-timestamp <when></td><td align="left">timestamp="<when>"</td><td align="left">最新リビジョンのタイム・スタンプを設定します。</td></tr><tr><td align="left">-source <directory></td><td align="left">source="<directory>"</td><td align="left">ソースを検索するディレクトリーを追加指定します。</td></tr><tr><td align="left">-findSource <directory></td><td align="left">findSource="<directory>"</td><td align="left">指定したディレクトリー内を検索して関連するソースの場所を追加します。</td></tr><tr><td align="left">-suppress <filter file></td><td align="left">suppress="<filter file>"</td><td align="left">指定したファイルに一致する警告を抑止します (以前に指定した抑止設定は置き換えられます)。</td></tr><tr><td align="left">-withMessages</td><td align="left">withMessages="[true|false]"</td><td align="left">XMLにテキストメッセージを追加します。</td></tr><tr><td align="left">-resetSource</td><td align="left">resetSource="[true|false]"</td><td align="left">ソース検索パスをすべて削除します。</td></tr></tbody></table></div></div><br class="table-break"></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="listBugDatabaseInfo"></a>1.8. listBugDatabaseInfo</h3></div></div></div><p>このコマンドの実行においては、コマンドラインで 0 個以上の xml バグデータベースファイル名を指定します。ファイル名を1つも指定しなければ、標準出力から読み込みを行いテーブルのヘッダーは生成されません。</p><p>このコマンドには 1 つだけオプションがあります : <code class="option">-formatDates</code> を指定するとテキスト形式でデータが描画されます。</p><p>出力される表は、各バグデータベースごとに行を持ち、次に示すカラムから成ります :</p><div class="table"><a name="listBugDatabaseInfoColumns"></a><p class="title"><b>表12.8 listBugDatabaseInfo カラム一覧</b></p><div class="table-contents"><table summary="listBugDatabaseInfo カラム一覧" border="1"><colgroup><col><col></colgroup><thead><tr><th align="left">カラム</th><th align="left">目的</th></tr></thead><tbody><tr><td align="left">version</td><td align="left">バージョン名</td></tr><tr><td align="left">time</td><td align="left">リリースされた日時</td></tr><tr><td align="left">classes</td><td align="left">分析されたクラス数</td></tr><tr><td align="left">NCSS</td><td align="left">コメント文を除いた命令数 (Non Commenting Source Statements)</td></tr><tr><td align="left">total</td><td align="left">全警告数</td></tr><tr><td align="left">high</td><td align="left">優先度(高)の警告の総数</td></tr><tr><td align="left">medium</td><td align="left">優先度(中)の警告の総数</td></tr><tr><td align="left">low</td><td align="left">優先度(低)の警告の総数</td></tr><tr><td align="left">filename</td><td align="left">データベースのファイル名</td></tr></tbody></table></div></div><br class="table-break"></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="examples"></a>2. 例</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="unixscriptsexamples"></a>2.1. 提供されたシェル・スクリプトを使用しての履歴マイニング</h3></div></div></div><p>以下はすべて、 jdk1.6.0-b12, jdk1.6.0-b13, ..., jdk1.6.0-b60 のディレクトリに対してコマンドを実行しています。</p><p>以下のコマンドを実行してみます :</p><pre class="screen"> |
computeBugHistory jdk1.6.0-b* | filterBugs -bugPattern IL_ | mineBugHistory -formatDates |
</pre><p>すると、次のような出力が行われます :</p><pre class="screen"> |
seq version time classes NCSS added newCode fixed removed retained dead active |
@@ -164,9 +164,9 @@ seq version time classes NCSS added newCode fixed removed retained dead active |
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 |
-</pre></div><div class="sect2" title="2.2. 増分履歴メンテナンス"><div class="titlepage"><div><div><h3 class="title"><a name="incrementalhistory"></a>2.2. 増分履歴メンテナンス</h3></div></div></div><p>仮に、 db.xml がビルド b12 - b60 に対する findbugs 実行結果を保持している場合、次に示すコマンドを実行することで、 db.xml に b61 に対する実行結果を追加することができます :</p><pre class="screen"> |
+</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="incrementalhistory"></a>2.2. 増分履歴メンテナンス</h3></div></div></div><p>仮に、 db.xml がビルド b12 - b60 に対する findbugs 実行結果を保持している場合、次に示すコマンドを実行することで、 db.xml に b61 に対する実行結果を追加することができます :</p><pre class="screen"> |
computeBugHistory -output db.xml db.xml jdk1.6.0-b61/jre/lib/rt.xml |
-</pre></div></div><div class="sect1" title="3. Ant の例"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="antexample"></a>3. Ant の例</h2></div></div></div><p>findbugs の実行とその後のデータ・マイニングツールの活用の両方を実行している ant スクリプトの完全な例を以下に示します :</p><pre class="screen"> |
+</pre></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="antexample"></a>3. Ant の例</h2></div></div></div><p>findbugs の実行とその後のデータ・マイニングツールの活用の両方を実行している ant スクリプトの完全な例を以下に示します :</p><pre class="screen"> |
<project name="analyze_asm_util" default="findbugs"> |
<!-- findbugs タスク定義 --> |