JProfiler ヘルプDownload

JProfilerのスクリプト

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で文字を入力または削除し続けることができ、ポップアップはそれに応じて更新されます。"Camel-hump"補完がサポートされています。例えば、NPEを入力してCTRL-Spaceを押すと、java.lang.NullPointerExceptionなどのクラスが提案されます。自動的にインポートされないクラスを受け入れると、完全修飾名が挿入されます。

自動補完ポップアップは次のことを提案できます:

  • 変数とスクリプトパラメータ。スクリプトパラメータは太字で表示されます。
  • import文を入力する際のパッケージ
  • クラス
  • コンテキストがクラスの場合のフィールド
  • コンテキストがクラスまたはメソッドのパラメータリストの場合のメソッド

設定されたセッションクラスパスにも設定されたJDKにも含まれていないクラスを持つパラメータは[未解決]としてマークされ、ジェネリックなjava.lang.Object型に変更されます。そのようなパラメータにメソッドを呼び出し、コード補完を取得するために、アプリケーション設定でクラスパスに欠落しているJARファイルを追加します。

問題分析

入力したコードはリアルタイムで分析され、エラーと警告条件がチェックされます。エラーはエディタ内で赤い下線として表示され、右側のガターに赤いストライプとして表示されます。未使用の変数宣言などの警告は、エディタ内で黄色の背景として表示され、ガターに黄色のストライプとして表示されます。エディタ内のエラーまたは警告にマウスをホバーすると、またガターエリアのストライプにマウスをホバーすると、エラーまたは警告メッセージが表示されます。

右側のガターの上部にあるステータスインジケータは、コードに警告やエラーがない場合は緑色、警告がある場合は黄色、エラーが見つかった場合は赤色です。エディタ設定で問題分析のしきい値を構成できます。

ダイアログの右上隅にあるガターアイコンが緑色の場合、エディタ設定でエラー分析を無効にしていない限り、スクリプトはコンパイルされます。いくつかの状況では、実際のコンパイルを試みることができます。メニューからコード→テストコンパイルを選択すると、スクリプトがコンパイルされ、別のダイアログにエラーが表示されます。OKボタンでスクリプトを保存しても、スクリプトがすぐに使用されない限り、スクリプトの構文の正しさはテストされません。

キーのバインディング

SHIFT-F1を押すと、カーソル位置の要素を説明するJavadocページがブラウザで開きます。JavaランタイムライブラリのJavadocは、コードエディタの一般設定で有効なJavadocの場所を持つJDKが設定されている場合にのみ表示できます。

Javaコードエディタのすべてのキーのバインディングは構成可能です。ウィンドウメニューから設定→キー マップを選択して、キー マップ エディタを表示します。キーのバインディングはファイル$HOME/.jprofiler15/editor_keymap.xmlに保存されます。このファイルは、デフォルトのキー マップがコピーされた場合にのみ存在します。JProfilerのインストールを別のコンピュータに移行する際に、このファイルをコピーしてキーのバインディングを保持できます。