ヘッドレス・ワークベンチ (開発環境向けの、ユーザー・インターフェースのないワークベンチ) では、
コマンド行インターフェースからコード・レビューを実行することができます。
ソース・コード上で実行されるコード・レビュー・ルールは、
ユーザー・インターフェースで最後に使用されたものです。コード・レビューを一度も実行していない場合は、
「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)」の下のシステム構成詳細にあります。