service provider
メカニズムを使用してJConsoleプラグインを検索します。 ユーザーは、次のファイルを含むjarファイルに独自のJConsoleプラグインを格納して、提供することができます。
META-INF/services/com.sun.tools.jconsole.JConsolePlugin
このファイルには、個々のプラグインを表す次のような行が含まれています。
com.sun.example.JTop
これは、JConsolePlugin
を実装するクラスの完全指定クラス名です。
JConsoleのJConsoleプラグインをロードするには、次のコマンドを実行します。
jconsole -pluginpath <plugin-path>
<plugin-path>
は、ディレクトリまたはjarファイルのいずれかを検索するためのJConsoleプラグインのパスを指定します。 複数のパスを指定するときは、プラットフォーム固有のパス区切り文字で区切って指定します。
ある接続に対して新しいJConsoleウィンドウが作成されると、各JConsolePlugin
のインスタンスが作成されます。 JConsoleContext
オブジェクトは、構築中は使用できません。 JConsoleは、プラグイン・オブジェクトが作成されてから、プラグインのJConsoleContext
オブジェクトを設定します。 次に、getTabs
メソッドを呼び出し、返されたタブをJConsoleウィンドウに追加します。
- 導入されたバージョン:
- 1.6
- 関連項目:
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明final void
このプラグインのJConsoleContext
オブジェクトにPropertyChangeListener
を追加します。void
dispose()
このプラグインを破棄します。final JConsoleContext
アプリケーションへの接続を表すJConsoleContext
オブジェクトを返します。getTabs()
JConsoleウィンドウに追加されるタブを返します。abstract SwingWorker<?,
?> JConsoleがGUIを更新するのと同じ間隔でこのプラグインのGUIを更新するSwingWorker
を返します。final void
このプラグインのJConsoleContext
オブジェクトのリスナー・リストからPropertyChangeListener
を削除します。final void
setContext
(JConsoleContext context) アプリケーションへの接続を表すJConsoleContext
オブジェクトを設定します。
-
コンストラクタの詳細
-
JConsolePlugin
protected JConsolePlugin()コンストラクタです。
-
-
メソッドの詳細
-
setContext
public final void setContext(JConsoleContext context) アプリケーションへの接続を表すJConsoleContext
オブジェクトを設定します。 このメソッドは、プラグインの作成後、getTabs()
の呼出しが行われる前に1回だけ呼び出されます。 このメソッドを呼び出すときは、任意のconnection state
のcontext
を指定できます。- パラメータ:
context
-JConsoleContext
オブジェクト
-
getContext
public final JConsoleContext getContext()アプリケーションへの接続を表すJConsoleContext
オブジェクトを返します。 このメソッドは、context
が初期化される前に呼び出された場合、null
を返すことができます。- 戻り値:
- アプリケーションへの接続を表す
JConsoleContext
オブジェクト。
-
getTabs
JConsoleウィンドウに追加されるタブを返します。返されるマップには、JConsoleウィンドウのタブ付きペインに追加される各タブにエントリ(キーとしてタブ名、値として
JPanel
オブジェクトを指定)が1つずつ含まれます。 このメソッドは、このプラグインによって追加されるタブがない場合は空のマップを返します。 このメソッドは、新規接続時にイベント・ディスパッチ・スレッドから1回だけ呼び出されます。- 戻り値:
- JConsoleウィンドウに追加されるタブを表すタブ名と
JPanel
オブジェクトのマップ、または空のマップ。
-
newSwingWorker
public abstract SwingWorker<?,?> newSwingWorker()JConsoleがGUIを更新するのと同じ間隔でこのプラグインのGUIを更新するSwingWorker
を返します。JConsoleは、接続ごとに指定された間隔でGUIの更新を行うようにスケジュールします。 このメソッドは、各プラグインの
SwingWorker
を取得するため、更新のたびに呼び出されます。JConsoleは、
execute()
メソッドを呼び出して、返されるSwingWorker
が次の場合に実行されるようにスケジュールを立てます。-
SwingWorker
オブジェクトは、(つまり、SwingWorker.getState()
メソッドはPENDING
状態を返します)が実行されていません - 前の更新で返された
SwingWorker
オブジェクトは、null
(つまり、SwingWorker.isDone
メソッドはtrue
を返します)でない場合にタスクを完了しました。
そうしないと、SwingWorker
オブジェクトは機能するようにスケジュールされません。プラグインは独自のGUI更新をスケジュールでき、このメソッドは
null
を返します。- 戻り値:
- GUIの更新を実行する
SwingWorker
、またはnull
。
-
-
dispose
public void dispose()このプラグインを破棄します。 このメソッドはJConsoleによって呼び出され、このプラグインが破棄されることと、このプラグインで割り当てられたすべてのリソースを解放するべきであることを通知します。 このメソッドを呼び出すときは、任意のconnection state
のJConsoleContext
を指定できます。 -
addContextPropertyChangeListener
public final void addContextPropertyChangeListener(PropertyChangeListener listener) このプラグインのJConsoleContext
オブジェクトにPropertyChangeListener
を追加します。 このメソッドは、JConsoleContext
オブジェクトが使用できるとき、または使用できないときに、このプラグインがリスナーを登録できるようにする簡易メソッドです。たとえば、プラグイン・コンストラクタは、このメソッドを呼び出して、
connectionState
プロパティの変更を待機するようにリスナーを登録できます。この場合、リスナーは、使用可能な状態になるとJConsoleContext
オブジェクトに追加されます。- パラメータ:
listener
- 追加するPropertyChangeListener
- 例外:
NullPointerException
-listener
がnull
である場合。
-
removeContextPropertyChangeListener
public final void removeContextPropertyChangeListener(PropertyChangeListener listener) このプラグインのJConsoleContext
オブジェクトのリスナー・リストからPropertyChangeListener
を削除します。listener
が追加されなかった場合、例外はスローされず、何もアクションは行われません。- パラメータ:
listener
- 削除するPropertyChangeListener
- 例外:
NullPointerException
-listener
がnull
である場合。
-