JMX エージェントでの MBeans の登録
これは JMX エージェントが選択された場合のみ使用できる、「管理」メニューの下にあるコンテキストアクションによって実行されます。次のメニューから管理メニューにアクセスできます。
- 最上位メニュー
- プロジェクトのツリーノードを選択して右クリックしたときに表示されるコンテキストメニュー
アクションの適用性
このアクションは、JMX エージェントが選択されたときに適用します。JMX エージェントクラスは、「JMX エージェント」ウィザードから生成されたクラスです。
JMX エージェントの init メソッドは、次の項目に必要なコードで更新されます。
- インスタンス化 (MBean コンストラクタの呼び出し)
- 名前 (MBean ObjectName を提供)
- 登録 (MBeanServer register メソッドの呼び出し)
このアクションで MBeanServer プラットフォーム内に MBean が登録されます。このアクションを繰り返し呼び出すと、複数の MBeans を登録できます。
「MBean をインスタンス化して登録」アクションの使用
- 「管理」メニューから、「MBean をインスタンス化して登録」を選択します。
- ポップアップウィンドウが表示されます。
- 「既存の MBean を登録」がすでに選択されています。
- 「参照...」ボタンをクリックして、現在のプロジェクトから MBean を選択できます。テキストフィールドに Mbean クラス名を直接入力することもできます。
- 有効な Mbean クラスを入力すると、「ObjectName テキストフィールドがアクティブになります。デフォルトの ObjectName が提供されます。デフォルトの ObjectName の操作は、次のとおりです。
- ドメイン名は MBean のパッケージ名から派生されます。パッケージ名を反転します (例: com.foo.bar ==> bar.foo.com)。パッケージ名がデフォルトのパッケージ名の場合は、JMX のデフォルトのドメインが使用されます。
- 単一キーにより、type の値として、クラス名が指定されます(例: class MyClass ==> type=MyClass)。
- あらゆるキーと値のペアを自由に追加できます。デフォルトの ObjectName の操作は、「単一の」MBeans に名前をつけるのに適しています。同じ種類の MBean を 1 つ以上登録する場合は、少なくとも 1 つのキーを追加して名前の衝突を回避する必要があります。
- これで MBean コンストラクタを選択できます。
- 終了したら、「了解」をクリックします。
- JMX エージェントソースコードはエディタ内にあります。
- edit メソッドに移動し、生成されたコードを表示します。
- 生成されたコードを更新する必要がない場合、つまり、MBean コンストラクタに提供するパラメータがない場合は、エージェントで実行中の MBeans をコンパイルし、実行して表示できます。「実行」>「Run Main Project with JConsole...」をクリックするか、これに関連するツールバーのアイコンをクリックします。コンパイル、実行、および表示は自動的に操作されます。
生成されたコードの更新
作業中、MBean に複数のパラメータが必要な場合、生成したコードをそれらのパラメータで更新する必要があります。
- エージェントのソースファイルで、init() メソッドに移動します。
- 要求されたパラメータを MBean コンストラクタに提供します。次の抜粋では、MBean コンストラクタに String が必要です。
// Status(String) コンストラクタのパラメータを有効な値で更新します。
getMBeanServer().registerMBean(
new Status("OK message"),
new ObjectName("foo.bar.com:type=Status"));