Probekit エディターのビジュアル・インターフェースを使用して、新規プローブのソース・コードを作成できます。
Probekit エディターを使用してプローブを作成するには、次のようにします。
- プローブを組み込むプロジェクトを右
クリックして、ポップアップ・メニューで「新規」>「その他」と選択します。
- 「ウィザードを選択」ページで、「プロファイルおよびロギング」を展開し、「Probekit ソース・ファイル」を選択します。
- 「次へ」をクリックします。
- 「新規プローブ・ファイルの作成 (Create a New Probe File)」ウィザードで、「ファイル名」フィールドに新規プローブ・ソース・ファイルの名前を入力します。プローブ・ソース・ファイルのファイル名拡張子は .probe でなければなりません。
- 「ソース・フォルダー」で、新規プローブ・ソース・ファイルを入れるプロジェクト・ソース・フォルダーを選択します。
編集ボックスにフォルダー名を入力するか、またはツリー・ペインでフォルダーを選択します。
注: プローブ・ソース・ファイルは、プロジェクト・ソース・フォルダーのトップレベルになければなりません。サブフォルダーには入れられません。
- プローブに追加するコンテンツのタイプを選択します。「メソッド・プローブ」
または「callsite プローブ」を選択する場合は、「フラグメント型」も選択する必要があります。
- 「次へ」をクリックします。
- 「追加」ボタンを使用して、必要に応じてデータ・プローブ・オブジェクトを追加します。作成しているプローブの型に使用可能なデータ・プローブ・オブジェクトの説明が、ページの下部に表示されます。
注: 前に戻って、作成中のプローブの型または挿入するフラグメント型を変更する場合は、
適用しなくなったデータ・プローブ・オブジェクトを破棄するようプロンプトが出されることがあります。
- 「終了」をクリックします。新規 .probe ファイルがプロジェクト・ソース・フォルダーに表示され、
デフォルトで自動的に Probekit エディターで開かれます。
- 「一般」タブを選択します。
- 「ID」フィールドに、プローブに固有の id ストリングを入力し、オプションで「バージョン」フィールドにバージョン番号を入力します。
id ストリングは、Probekit レジストリーでプローブを一意的に識別するために使用されます。
詳しくは、『Probekit オブジェクト』を参照してください。
- 「プローブ」タブを選択して、「プローブの追加」ボタンをクリックします。
新規プローブ・オブジェクトが、ツリー・ペインに表示されます。
- エディター・ツリーのプローブ・オブジェクト
を右クリックして、ポップアップ・メニューでと選択します。
新規フラグメント・オブジェクトが、プローブ・オブジェクトの子としてツリーに表示され、フラグメントのプロパティー・フィールドが、編集ペインに表示されます。
- 編集ペインで、「フラグメント型」を選択し、
プローブ・フラグメントの Java コードを入力します。
詳しくは、『フラグメント・プローブ・オブジェクト』を参照してください。
- 引き続き、ツリーからオブジェクトを選択
し、ポップアップ・メニューを使用してプローブを定義し、子オブジェクト
を追加して、さらに編集ペインで新規オブジェクトの値を入力します。
プローブ・オブジェクトおよびそのプロパティーに関する詳細情報は、
『Probekit エレメント参照』を参照してください。
ポップアップ・メニューには、ツリーで選択されているオブジェクトに有効な子オブジェクトのみがリストされます。
有効であるが、もう追加できないオブジェクトのメニュー項目は、使用不可になります。
注: インポート・プローブ・オブジェクトの「
インポート・ディレクティブ」プロパティー・フィールドに値を入力する際は、
インポートするパッケージまたはクラスの名前のみを入力してください。
「import」キーワードまたは末尾のセミコロン (;) は入力しないでください。
- プローブの定義を終了したら、とクリックします。
注: .probe ファイルの保管時に、Probekit エディター
は、ファイル内のすべての Java エレメントの構文を検査し、すべての javac 問題をユーザーに報告します。
エラーまたは警告があるオブジェクトについては、ツリー内のアイコンがエラー・アイコンまたは警告アイコンに変更されます。
javac 問題は、エディターの「プローブ」タブの下部のテーブルに表示されます。
このテーブルの項目をダブルクリックすると、ペインへのフォーカスがプローブ・ツリーの右側に変わり、javac エラーまたは警告が含まれているウィジェットがフォーカスされます。
Java ウィジェットが複数行の場合 (伴っている画面に表示される「Java コード」ウィジェットなど)、ウィジェットの最初の行が選択されるので、
ユーザーは問題のある行までスクロールします。
構文問題テーブルは、フィルターをサポートしていません。