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







