JProfiler の組み込みスクリプトエディタでは、カスタムプローブ設定、例外的なメソッドの分割、ヒープウォーカーフィルタなど、JProfiler GUI の様々な場所でカスタムロジックを入力できます。
編集エリア上部のボックスには、スクリプトで利用可能なパラメータとその戻り値の型が表示されます。メニューから ヘルプ→Javadoc 概要を表示
を実行すると、com.jprofiler.api.* パッケージのクラスに関する詳細情報を取得できます。
いくつかのパッケージは、完全修飾クラス名を使わずに利用できます。利用可能なパッケージは以下の通りです。
- java.util.*
- java.io.*
完全修飾クラス名の使用を避けるために、テキストエリアの先頭行に複数の import 文を記述できます。
すべてのスクリプトには com.jprofiler.api.agent.ScriptContext のインスタンスが渡され、スクリプトの連続した呼び出し間で状態を保存できます。
エディタの機能を最大限に活用するため、一般設定で JDK を設定することを推奨します。デフォルトでは、JProfiler が実行されている JRE が使用されます。この場合、コード補完ではパラメータ名や JRE のクラスに対する Javadoc は提供されません。
スクリプトの種類
スクリプトは式として記述できます。式は末尾にセミコロンがなく、必要な戻り値の型に評価されます。例えば、
object.toString().contains("test")
上記はヒープウォーカーの参照先ビューでのフィルタスクリプトとして機能します。
または、スクリプトは一連の Java 文で構成され、最後の文が必要な戻り値の型の return 文となります。
import java.lang.management.ManagementFactory; return ManagementFactory.getRuntimeMXBean().getUptime();
上記の例はスクリプトテレメトリーで動作します。JProfiler は、入力された内容が式かスクリプトかを自動的に判別します。
以前入力したスクリプトを再利用したい場合は、スクリプト履歴から選択できます。 履歴を表示 ツールバーボタンをクリックすると、過去に使用したすべてのスクリプトが表示されます。スクリプトはシグネチャごとに整理されており、現在のスクリプトシグネチャがデフォルトで選択されます。
コード補完
CTRL-Space
を押すと、コード補完候補のポップアップが表示されます。また、「.」（ドット）を入力すると、他の文字が入力されない場合は遅延後にこのポップアップが表示されます。遅延時間はエディタ設定で調整可能です。ポップアップ表示中は、Backspace
で文字を削除したり、入力を続けたりすると、候補が動的に更新されます。「キャメルハンプ」補完もサポートされています。例えば、NPE と入力して CTRL-Space
を押すと、java.lang.NullPointerException などが候補として表示されます。自動インポートされないクラスを選択した場合は、完全修飾名が挿入されます。
オートコンプリートのポップアップでは、以下の候補が提案されます。
- 変数およびスクリプトパラメータ。スクリプトパラメータは太字で表示されます。
- import 文入力時のパッケージ
- クラス
- クラスがコンテキストの場合のフィールド
- クラスまたはメソッドのパラメータリストがコンテキストの場合のメソッド
設定されたセッションクラスパスや JDK に含まれていないクラスのパラメータは [unresolved] としてマークされ、汎用型
java.lang.Object に変更されます。そのようなパラメータでメソッドを呼び出したり、コード補完を利用したい場合は、アプリケーション設定のクラスパスに不足している JAR
ファイルを追加してください。
問題解析
入力したコードはリアルタイムで解析され、エラーや警告条件がチェックされます。エラーはエディタ内で赤い下線と右側ガターの赤いストライプで表示されます。未使用変数宣言などの警告は、エディタ内で黄色の背景およびガターの黄色いストライプで示されます。エディタ内やガターのストライプ上にマウスカーソルを合わせると、エラーや警告メッセージが表示されます。
右側ガター上部のステータスインジケータは、コードに警告やエラーがなければ緑、警告があれば黄色、エラーが検出されると赤になります。問題解析の閾値はエディタ設定で調整できます。
ダイアログ右上のガターアイコンが緑色の場合、エディタ設定でエラー解析を無効にしていなければスクリプトはコンパイル可能です。場合によっては、実際にコンパイルを試したいこともあるでしょう。メニューから コード→テストコンパイル を選択すると、スクリプトをコンパイルし、エラーがあれば別ダイアログで表示します。OK ボタンでスクリプトを保存しても、スクリプトがすぐに使用されない限り構文の正しさはテストされません。
キーバインド
SHIFT-F1 を押すと、カーソル位置の要素を説明する Javadoc ページがブラウザで開きます。Java ランタイムライブラリの Javadoc を表示するには、Javadoc の場所が有効な
JDK を一般設定でコードエディタ用に設定する必要があります。
Java コードエディタのすべてのキーバインドはカスタマイズ可能です。ウィンドウメニューから 設定→キーマップ
を選択すると、キーマップエディタが表示されます。キーバインドは $HOME/.jprofiler16/editor_keymap.xml
ファイルに保存されます。このファイルは、デフォルトのキーマップがコピーされた場合のみ存在します。JProfiler
のインストールを他のコンピュータに移行する際は、このファイルをコピーすることでキーバインドを引き継ぐことができます。
