SpotBugs Antタスクの使い方
この章では、一般的なJavaビルドおよびデプロイメントツールであるAntのビルドスクリプトにSpotBugs を統合する方法について説明します。SpotBugs Antタスクを使用するとビルドスクリプトはJavaコードでSpotBugs を自動的に実行できます。
Antタスクは、Mike Fagan氏の多大なる貢献によるものです。
Antタスクのインストール
Antタスクをインストールするには、Antインストールのlibサブディレクトリに $SPOTBUGS_HOME/lib/spotbugs-ant.jar
をコピーします。
注釈
SpotBugsに含まれていたバージョンのAntタスクを使用することを強くお勧めします。AntタスクのJarファイルは SpotBugsに含まれていたバージョン以外のバージョンで動作することを保証しません。
build.xml の変更
SpotBugsをbuild.xml (Antのビルドスクリプト)に組み込むには、まず最初にタスク定義を追加する必要があります。これは次のように記述します。
<taskdef
resource="edu/umd/cs/findbugs/anttask/tasks.properties"
classpath="path/to/spotbugs-ant.jar" />
タスク定義は、 spotbugs要素を build.xml
に記述したとき、タスクの実行に使用されるクラスを指定します。
タスク定義を追加したら、spotbugsタスクを使用するターゲットを定義できます。次の例は、build.xml
に追加したApache BCEL ライブラリです。
<property name="spotbugs.home" value="/export/home/daveho/work/spotbugs" />
<target name="spotbugs" depends="jar">
<spotbugs home="${spotbugs.home}"
output="xml"
outputFile="bcel-sb.xml" >
<auxClasspath path="${basedir}/lib/Regex.jar" />
<sourcePath path="${basedir}/src/java" />
<class location="${basedir}/bin/bcel.jar" />
</spotbugs>
</target>
spotbugs要素のhome 属性には、SpotBugsがインストールされているディレクトリが設定されている必要があります。つまり、$SPOTBUGS_HOME
です。インストール を参照してください。
このターゲットは、bcel.jar
に対してSpotBugsを実行します。これは、BCELのビルドスクリプトによって生成された Jarファイルです。("jar" ターゲットに依存させることで、SpotBugs を実行する前にライブラリが完全にコンパイルされていることを保証します)SpotBugsの出力は、XML形式で bcel-sb.xml
というファイルに保存されます。補助JarファイルRegex.jarを補助クラスパスに追加します。なぜなら、BCEL ライブラリによって参照されるからです。保存されるバグデータがBCEL ソースコードへの正確な参照を持つようにするためにソースパスが指定されています。
タスクの実行
上記で定義したspotbugsターゲットを使用して、コマンドラインからAnt を起動する例を示します。
[daveho@noir]$ ant spotbugs
Buildfile: build.xml
init:
compile:
examples:
jar:
spotbugs:
[spotbugs] Running SpotBugs...
[spotbugs] Bugs were found
[spotbugs] Output saved to bcel-sb.xml
BUILD SUCCESSFUL
Total time: 35 seconds
この場合バグ結果をXMLファイルに保存したのでSpotBugs GUIを使用して結果を表示できます。SpotBugsの実行 を参照してください。
パラメータ
この節では、SpotBugsタスクの使用時に指定できるパラメータについて説明します。
- class
オプションのネストされた要素です。解析するクラスを指定します。class要素は、解析されるアーカイブファイル (jar、zip など)、ディレクトリ、クラスファイルの名前をlocation属性に指定する必要があります。複数のクラス要素は、単一のspotbugs 要素の子要素として指定します。
クラス要素の指定を追加する、または代わりに、SpotBugsタスクに解析するファイルを指定する1つまたは複数のfileset 要素を含めることができます。たとえば、filesetを使用して、ディレクトリ内のすべてのjarファイルを解析するように指定できます。
- auxClasspath
オプションのネストされた要素です。解析するライブラリまたはアプリケーションで使用されるが、解析したくはないクラスを含むクラスパス (jar ファイルまたはディレクトリ)を指定します。AntのJavaタスクのclasspath 要素と同じ方法で指定します。
- sourcePath
オプションのネストされた要素です。解析されるJava コードをコンパイルするために使用されるソースファイルを含むソースディレクトリのパスを指定します。ソースパスを指定することにより生成されたXML バグ出力に完全なソース情報が含まれ、後で GUI で見ることができます。
- home
必須属性です。SpotBugsがインストールされているディレクトリの名前を設定する必要があります。
- quietErrors
オプションのブール値属性です。trueのときは、SpotBugs の出力で深刻な解析エラーや見つからなかったクラスの報告が抑制されます。デフォルトは false です。
- reportLevel
オプション属性です。問題を報告するための信頼度/優先度を指定します。
low
に設定すると、信頼度はバグをフィルタリングするために使われません。medium
(デフォルト)に設定すると、信頼度が低い問題が抑制されます。high
に設定すると、信頼度が高いバグだけが報告されます。- output
オプション属性です。出力形式を指定します。
xml
(デフォルト)に設定すると、出力はXML 形式になります。「xml:withMessages」に設定されているときは、出力は人間が読めるメッセージで拡張されたXML 形式になります。(XSLスタイルシートを使用してレポートを生成するときは、この形式を使用する必要があります)「HTML」に設定したときは、出力はHTML形式になります (デフォルトスタイルシートはdefault.xsl)。text
に設定すると、出力は特別なテキスト形式になります。emacs
に設定すると、出力はEmacs のエラーメッセージ形式になります。xdocs
に設定すると、出力はApache Maven で使用する xdoc XML形式になります。- stylesheet
オプション属性です。出力がhtmlに設定されているときにhtml出力を生成するために使用するスタイルシートを設定します。SpotBugs 配布物に含まれるスタイルシートには、default.xsl、fancy.xsl、fancy-hist.xsl、plain.xsl、summary.xslがあります。stylesheet属性が指定されていないときのデフォルト値は default.xsl です。
- sort
オプション属性です。output属性が
text
に設定されているときは、sort 属性は報告されたバグをクラスごとにソートするかどうかを設定します。デフォルトはtrue
です。- outputFile
オプション属性です。SpotBugs出力を保存する出力ファイルの名前を指定します。デフォルトでは、出力は Ant によって直接表示されます。
- debug
オプションのブール値属性です。
true
に設定すると、SpotBugs はどのクラスが解析されているか、どのバグパターンディテクタが実行されているかに関する診断情報を出力します。デフォルトはfalse
です。- effort
解析力を設定します。指定する値は、
min
、default
、max
のいずれかでなければなりません。解析力の詳細については コマンドラインオプション を参照してください。- conserveSpace
effort="min"
と同義です。- workHard
effort="max"
と同義です。- visitors
オプション属性です。実行すべきバグディテクタのコンマ区切りリストを指定します。バグディテクタは、パッケージ名がないクラス名で指定します。デフォルトでは、デフォルトで無効にされていないすべてのディテクタが実行されます。
- omitVisitors
オプション属性です。コンマ区切りのバグディテクタのリストを指定します。visitors 属性と似ていますが、実行しないディテクタを設定します。
- chooseVisitors
オプション属性です。コンマ区切りのバグディテクタリストのバグディテクタの接頭辞に「+」または「 -」を設定して、選択的に有効/無効にします。
- excludeFilter
オプション属性です。レポートから除外するバグを指定するフィルタのファイル名を指定します。フィルタファイル を参照してください。
- excludePath
An optional nested element. It specifies a path containing filters specifying bugs to exclude from being reported. See フィルタファイル.
- includeFilter
オプション属性です。報告するバグを指定するフィルタのファイル名を指定します。フィルタファイル を参照してください。
- includePath
An optional nested element. It specifies a path containing filters specifying which bugs are reported. See フィルタファイル.
- projectFile
オプション属性です。プロジェクトファイルの名前を指定します。プロジェクトファイルは、SpotBugs GUI によって作成され、クラス、補助クラスパスエントリ、ソースディレクトリを指定します。プロジェクトに名前を付けることによって、class 要素や``auxClasspath`` または
sourcePath
属性を設定する必要がありません。プロジェクトの作成 を参照してください。- jvmargs
オプション属性です。SpotBugsを実行するために使用するJava 仮想マシンに渡す必要がある引数を指定します。この属性を使用して、巨大なプログラムを解析するときに JVM が使用するメモリ量を増やすためのフラグを指定する必要があります。
- systemProperty
オプションのネストされた要素です。システムプロパティを定義します。name 属性はシステムプロパティの名前を指定し、value 属性はシステムプロパティの値を指定します。
- timeout
オプション属性です。SpotBugsを実行しているJava プロセスがハングアップして終了する前に実行される時間をミリ秒単位で指定します。デフォルトは600,000ミリ秒 (10 分) です。巨大なプログラムのときは、SpotBugs は解析を完了するのに10分以上かかることがあります。
- failOnError
オプションのブール値属性です。SpotBugs を実行中にエラーが発生したときに、ビルドプロセスを中断するかどうか指定します。デフォルトは
false
です。- errorProperty
オプション属性です。SpotBugs の実行中にエラーが発生したときに、
true
に設定するプロパティの名前を指定します。- warningsProperty
オプション属性です。 SpotBugs によって解析されたプログラムの警告が報告されたときに、
true
に設定するプロパティの名前を指定します。- userPreferencesFile
オプション属性です。使用するユーザ設定ファイルを設定します。上記のオプションの一部が上書きされる可能性があります。最初の引数として
userPreferencesFile
を指定すると、後続のオプションで上書きすることを意味します。最後の引数として指定すると以前のオプションを上書きすることを意味します。このオプションの背後にある根拠は、コマンドライン実行で SpotBugs Eclipse プロジェクトの設定を再利用するためです。- nested
オプション属性です。解析されるファイルとディレクトリのリストにあるネストされた jar/zip ファイルのスキャンを有効また無効にします。デフォルトでは、ネストされたjar/zip ファイルのスキャンが有効になっています。
- setExitCode
オプションのブール値属性です。終了コードがメインの ant ジョブに戻されるかどうか指定します。デフォルトは
true
です。