ヘッドレス・ワークベンチ (開発環境向けの、ユーザー・インターフェースのないワークベンチ) では、コマンド行インターフェースからコード・レビューを実行することができます。ソース・コード上で実行されるコード・レビュー・ルールは、ユーザー・インターフェースで最後に使用されたものです。コード・レビューを一度も実行していない場合は、
「Java 設定 - コード・レビュー (Java preferences - Code Review)」ページのデフォルト設定 (即時コード・レビュー) が
実行されます。デフォルトでは、コード・レビューの実行後、
HTML レポートと JSML (JScrib Markup Language) レポートの 2 つのレポートが生成されます。これらは、
com.ibm.r2a.command.line.mode フォルダー内のワークスペースのメタデータ・フォルダーにあります。生成されるレポートのタイプと、コード・レビューの実行後にレポートが生成される場所を指定することができます。
注: コード・レビューをヘッドレス・モードで実行できるのは、ワークスペースの場合のみです。ワークスペースのサブセット (1 つ以上の特定のプロジェクトなど) を分析する場合は、そのプロジェクトを含むワークスペースを作成して、このワークスペース上でコード・レビューを実行してください。
コード・レビューをヘッドレス・モードで実行する前には、以下を確認してください。
- ワークスペースには、Java ソース・ファイルを含むプロジェクトが少なくとも 1 つは必要です。
- 実行するルールを指定する場合は、ユーザー・インターフェースでコード・レビューを構成する必要があります。
開発環境は稼働中でなくてもかまいません。
ヘッドレス・モードのコード・レビューを同一のワークスペースで同時に複数実行することはできません。
また、Eclipse グラフィカル・ユーザー・インターフェースによってワークスペースがロックされている場合もヘッドレス・モードは使用できません。
注: Windows オペレーティング・システムの制限により、コマンド行モードの実行に使用される文字列 (C:¥path¥java.exe …) の長さは、
できるだけ短くする必要があります。長すぎると、文字列末尾のパラメーターがシステムによってカットされたり、失われたりすることがあります。
Windows ユーザーは、以下のベスト・プラクティスに従って最良の結果を得る必要があります。
- PATH 変数にはできるだけ多くのパスを組み込む必要があります。例えば、Java のパスおよび JAR ファイルへのパス。
- ワークスペースへのパスは、できるだけ短くする必要があります。例えば、C:¥workspace。
- レポートが生成される場所のパスもできるだけ短くする必要があります。例えば、C:¥report。
ヘッドレス・ワークベンチでコード・レビューを実行するには、
次のコマンドを製品構成と共に使用して、コマンド行モードのアプリケーションを起動します。
<eclipse_dir>/jre/bin/java <virtual
machine options> -cp <eclipse_dir>/startup.jar
org.eclipse.core.launcher.Main <command line mode options> <eclipse
options>
製品構成は、にあります。
<virtual
machine options> は
eclipse.vmargs プロパティーにあります。主要な Eclipse オプションは
eclipse.commands プロパティーにあります。このプロパティーには、Eclipse トークンの
-data を使用してワークスペースのパスを追加します。
<command
line mode options> はコマンド行モードのオプションを指します。
注: ご使用のオペレーティング・システム構成によって、次のステップのコマンドにパラメーターを追加する必要がある場合があります。これらのパラメーターは、"「システム・プロパティー (System properties)」"の下のシステム構成詳細にあります。