ヘッドレス・モードで実行されるコード・レビュー

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
注: 使用しているオペレーティング・システムの構成によっては、この例のコマンド行を 実行するために、パラメーターを追加する必要がある場合があります。 パラメーターは、「システム・プロパティー」 (「ヘルプ」>「About」>「構成詳細」>「システム・プロパティー」) にあるシステム構成詳細にあります。
関連タスク
コマンド行からのコード・レビューの実行
Ant スクリプトからのコード・レビューの実行
関連資料
コード・レビューのヘッドレス・モードのリファレンス
即時コード・レビュー
ご利用条件 | フィードバック
(C) Copyright IBM Corporation 2004, 2005. All Rights Reserved. (C) Copyright IBM Japan 2005