プローブの事前適用

プローブを事前適用すると、Probekit は、プローブ・コード、およびプローブのクラスへの呼び出しをアプリケーションのクラス・ファイルに挿入することによってアプリケーションを装備します。

インスツルメンテーション・エンジンは、アプリケーション・ファイルおよびフォルダーを以下のように処理します。
  • クラス・ファイルが装備される場合は、装備されていない *.class ファイルが *.class.bak という名前のファイルにコピーされ、プローブのクラスへの呼び出しが *.class ファイルに挿入されます。
  • JAR ファイルが装備される場合は、装備されていない *.jar ファイルが *.jar.bak という名前のファイルにコピーされ、プローブのクラスの呼び出しが *.jar ファイル内部のクラス・ファイルに挿入されます。
注: Probekit インスツルメンテーション・エンジンは、すでに装備されているクラス・ファイルおよび JAR ファイルを再装備しません。 したがって、まず最初に、既存のプローブ・インスツルメンテーションを除去する必要があります。

プローブは、ワークベンチまたはコマンド行のいずれからも事前適用できます。

ワークベンチからのプローブの事前適用

ワークベンチでは、ナビゲーターまたはパッケージ・エクスプローラー・ビューからプローブを事前適用できます。

  1. .probe ファイルまたは事前適用するファイルを選択します。
  2. 右クリックして、「Probekit」>「装備 (Instrument)」と選択します。
  3. .probe ファイルを選択した場合:
    • 「装備 (Instrument)」ダイアログで、装備する .class ファイル、.jar ファイル、または外部 .jar ファイルを選択します。 注: 外部 .jar ファイルがワークベンチにより使用中である場合、事前適用は失敗します。 コマンド・プロンプトからファイルを事前適用する必要があります。
    .class または .jar ファイルを選択した場合:
    • 「プローブ・ファイルの選択」ダイアログで、適用する .probe ファイルを選択します。

: プローブがいったん事前適用されると、事前適用されたファイルを含むプロジェクトのクラスパスに .probe ファイルが無い場合、プロジェクトにおける一部のセットアップは、事前適用されたファイルを使用して実行されます。 必要な _probe.class ファイルは、プロジェクトの出力コンテナーにコピーされます。ソース・プロジェクトのプローブが不要になったら、以下の手順で Probekit インスツルメンテーションを除去してください。

  1. 事前適用プロジェクトをビルドして、.class ファイルからプローブ・データを消去します。
  2. _probe.class ファイルを削除します。
  3. すべての .jar.bak ファイルを元の名前に戻します。
バイナリー・プロジェクトの場合、セットアップで新規クラス・フォルダー _probekit_probes が作成され、 プロジェクトのクラスパスに追加されます。 バイナリー・プロジェクトのプローブが不要になったら、以下の手順で Probekit インスツルメンテーションを除去してください。
  1. プロジェクトのクラスパスから _probekit_probes_ フォルダーを除去します。
  2. _probekit_probes_ フォルダーを削除します。
  3. すべての .bak ファイルを元の名前に戻します。

コマンド行からのプローブの事前適用

ワークベンチの実行中に変更できない外部ファイルを事前適用するには、 Probekit インスツルメンテーション・エンジンを実行して、コマンド・プロンプトからプローブを事前適用します。Probekit インスツルメンテーション・エンジンを起動するコマンド行で、アプリケーション・クラス・ファイル、JAR ファイル、またはフォルダーの名前を指定できます。
  1. ご使用の CLASSPATH 環境変数に、probekit.jar ファイルの絶対パスおよびファイル名を必ず指定してください。 probekit.jar ファイルは、Eclipse plugins フォルダーの org.eclipse.hyades.probekit サブフォルダーにあります。
  2. ご使用の PATH 環境変数に、ユーザーのプラットフォームに適した org.eclipse.hyades.probekit のサブフォルダーへの絶対パスを必ず指定してください。
    • Windows プラットフォーム・アイコン os¥win32¥x86 (Microsoft® Windows® の場合)
    • Solaris プラットフォーム・アイコン os/solaris/sparc (Solaris の場合)
    • Linux プラットフォーム・アイコン os/linux/x86 (Linux™ の場合)
  3. コマンド・プロンプトで、コマンド java ProbeInstrumenter を入力し、その後に、使用するプローブの .probescript ファイルの名前、プローブ装備対象項目のリストを指定します。 リスト項目は、クラス・ファイル、JAR ファイル、またはフォルダーです。 例:
    java ProbeInstrumenter myprobe.probescript c:¥myproject_path¥myprogram.jar
    プローブのターゲット規則に一致するアプリケーション・クラス・ファイルが装備されます。

関連タスク
Probekit インスツルメンテーションの除去

(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.