public class MBeanRegistrationSupport extends ObjectSE
MBeanServer
SE に登録するためのサポートインフラストラクチャを提供します。特定の ObjectName
SE で既存の MBean に遭遇したときの動作は完全に構成可能で、柔軟な登録設定が可能です。 登録されているすべての MBean は追跡され、unregisterBeans()
メソッドを呼び出すことで登録解除できます。
サブクラスは、onRegister(ObjectName)
メソッドと onUnregister(ObjectName)
メソッドをそれぞれオーバーライドすることにより、MBean が登録または登録解除されたときに通知を受け取ることができます。
デフォルトでは、すでに使用されている ObjectName
SE を使用して MBean を登録しようとすると、登録プロセスは失敗します。
registrationPolicy
プロパティを RegistrationPolicy.IGNORE_EXISTING
に設定することにより、登録プロセスは既存の MBean を無視し、登録したままにします。これは、複数のアプリケーションが共有 MBeanServer
SE 内の共通 MBean を共有する必要がある設定で役立ちます。
registrationPolicy
プロパティを RegistrationPolicy.REPLACE_EXISTING
に設定すると、既存の MBean が必要に応じて登録中に置き換えられます。これは、MBeanServer
SE の状態を保証できない状況で役立ちます。
setServer(javax.management.MBeanServer)
, setRegistrationPolicy(org.springframework.jmx.support.RegistrationPolicy)
, MBeanExporter
修飾子と型 | フィールドと説明 |
---|---|
protected Log | logger このクラスの Log インスタンス。 |
protected MBeanServerSE | server Bean の登録に使用されている MBeanServer インスタンス。 |
コンストラクターと説明 |
---|
MBeanRegistrationSupport() |
修飾子と型 | メソッドと説明 |
---|---|
protected void | doRegister(ObjectSE mbean, ObjectNameSE objectName) 実際に MBean をサーバーに登録します。 |
protected void | doUnregister(ObjectNameSE objectName) 指定された MBean をサーバーから実際に登録解除します。 |
protected ObjectNameSE[] | getRegisteredObjectNames() 登録されているすべての Bean の ObjectNames SE を返します。 |
MBeanServerSE | getServer() Bean が登録される MBeanServer を返します。 |
protected void | onRegister(ObjectNameSE objectName) MBean が指定された ObjectName SE で登録されたときに呼び出されます。 |
protected void | onRegister(ObjectNameSE objectName, ObjectSE mbean) MBean が指定された ObjectName SE で登録されたときに呼び出されます。 |
protected void | onUnregister(ObjectNameSE objectName) MBean が指定された ObjectName SE で登録解除されたときに呼び出されます。 |
void | setRegistrationPolicy(RegistrationPolicy registrationPolicy) すでに存在する ObjectName SE で MBean を登録しようとするときに使用するポリシー。 |
void | setServer(MBeanServerSE server) すべての Bean を登録する MBeanServer インスタンスを指定します。 |
protected void | unregisterBeans() このクラスのインスタンスによって登録されたすべての Bean を登録解除します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
protected final Log logger
Log
インスタンス。@Nullable protected MBeanServerSE server
MBeanServer
インスタンス。public void setServer(@Nullable MBeanServerSE server)
MBeanServer
インスタンスを指定します。MBeanExporter
は、何も指定されていない場合、既存の MBeanServer
を見つけようとします。@Nullable public final MBeanServerSE getServer()
MBeanServer
を返します。public void setRegistrationPolicy(RegistrationPolicy registrationPolicy)
ObjectName
SE で MBean を登録しようとするときに使用するポリシー。registrationPolicy
- 使用するポリシー protected void doRegister(ObjectSE mbean, ObjectNameSE objectName) throws JMExceptionSE
setRegistrationPolicy(org.springframework.jmx.support.RegistrationPolicy)
を使用して構成できます。mbean
- MBean インスタンス objectName
- MBean の推奨 ObjectNameJMExceptionSE
- 登録に失敗した場合 protected void unregisterBeans()
protected void doUnregister(ObjectNameSE objectName)
objectName
- MBean の推奨 ObjectNameprotected final ObjectNameSE[] getRegisteredObjectNames()
ObjectNames
SE を返します。protected void onRegister(ObjectNameSE objectName, ObjectSE mbean)
ObjectName
SE で登録されたときに呼び出されます。MBean の登録時にサブクラスが追加の処理を実行できるようにします。 デフォルトの実装は onRegister(ObjectName)
に委譲します。
objectName
- MBean が登録された実際の ObjectName
SEmbean
- 登録された MBean インスタンス protected void onRegister(ObjectNameSE objectName)
ObjectName
SE で登録されたときに呼び出されます。MBean の登録時にサブクラスが追加の処理を実行できるようにします。デフォルトの実装は空です。サブクラスでオーバーライドできます。
objectName
- MBean が登録された実際の ObjectName
SEprotected void onUnregister(ObjectNameSE objectName)
ObjectName
SE で登録解除されたときに呼び出されます。MBean が登録解除されたときにサブクラスが追加の処理を実行できるようにします。デフォルトの実装は空です。サブクラスでオーバーライドできます。
objectName
- MBean が登録された ObjectName
SE