Java™ ソース・ファイルに対するコード・レビューは、ヘッドレス・ワークベンチ
(環境開発に対するユーザー・インターフェースがない) でコマンド行から実行できます。
これは、無人で定期的にコード・レビューを実行したい場合、またはコード・レビューを Ant スクリプトに組み込みたい場合に便利です。
コマンド行インターフェースによって、ワークスペースおよびオプショナル・パラメーターを指定できます。
コマンド行はヘッドレスの Eclipse 環境を起動します。この環境はコード・レビュー実行に必要なコア機能のみを備え、ユーザー・インターフェース機能はありません。
デフォルトでは、即時コード・レビューのルールか、最後にコード・レビューが実行された際に UI で指定されたルールを使用して、
ワークスペースのソース・コードでコード・レビューを実行します。
ヘッドレス・モードでコード・レビューを実行する前に、Java ソース・ファイルを持つプロジェクトを含むワークスペースが
用意されている必要があります。
開発環境は稼働中でなくてもかまいません。
注: Windows
® オペレーティング・システムの制限により、コマンド行モードの
実行に使用される文字列 (C:¥path¥java.exe …) の長さは、
できるだけ短くする必要があります。長すぎると、
文字列末尾のパラメーターがシステムによってカットされたり、失われたりすることがあります。
Windows ユーザーが最良の結果を得るためには、以下のベスト・プラクティスに従う必要があります。
- PATH 変数には、できるだけ多くのパス (Java パス、
JAR ファイルのパスなど) を含める必要があります。
- ワークスペースへのパスは、できるだけ短くする必要があります (C:¥workspace など)。
- レポートが生成される場所のパスもできるだけ短くする必要があります (C:¥report など)。
ヘッドレス・モードのコード・レビューを同一のワークスペースで同時に複数実行することはできません。
また、Eclipse グラフィカル・ユーザー・インターフェースによってワークスペースがロックされている場合もヘッドレス・モードは使用できません。
例
下記のコマンド行によって、Windows OS
上のワークスペース D:¥workspace からコード・レビューが実行されます。HTML レポートが D:¥workspace¥report に作成されます。
D:¥eclipse¥jre¥bin¥java -Xj9 -Dorg.eclipse.swt.browser.internal.flash
-Dorg.eclipse.emf.ecore.EPackage.Registry.INSTANCE=org.eclipse.emf.ecore.impl.EPackageRegistryImpl
-cp D:¥eclipse¥startup.jar org.eclipse.core.launcher.Main -application com.ibm.r2a.command.line.mode.CommandLineModeApplication
-plugincustomization <pluginCustomizationPath> -data <workspace_dir> -reportDirectory
D:¥workspace¥report -onlyClient CodeReview
注: 使用しているオペレーティング・システムの構成によっては、この例のコマンド行を
実行するために、パラメーターを追加する必要がある場合があります。
パラメーターは、「システム・プロパティー」
() にあるシステム構成詳細にあります。