パッケージ org.springframework.jmx.support

クラス MBeanRegistrationSupport

java.lang.ObjectSE
org.springframework.jmx.support.MBeanRegistrationSupport
既知の直属サブクラス
ConnectorServerFactoryBean, MBeanExporter
public class MBeanRegistrationSupport extends ObjectSE
MBean を MBeanServerSE に登録するためのサポートインフラストラクチャを提供します。特定の ObjectNameSE で既存の MBean に遭遇したときの動作は完全に構成可能で、柔軟な登録設定が可能です。

登録されているすべての MBean は追跡され、unregisterBeans() メソッドを呼び出すことで登録解除できます。

サブクラスは、onRegister(ObjectName) メソッドと onUnregister(ObjectName) メソッドをそれぞれオーバーライドすることにより、MBean が登録または登録解除されたときに通知を受け取ることができます。

デフォルトでは、すでに使用されている ObjectNameSE を使用して MBean を登録しようとすると、登録プロセスは失敗します。

registrationPolicy プロパティを RegistrationPolicy.IGNORE_EXISTING に設定することにより、登録プロセスは既存の MBean を無視し、登録したままにします。これは、複数のアプリケーションが共有 MBeanServerSE 内の共通 MBean を共有する必要がある設定で役立ちます。

registrationPolicy プロパティを RegistrationPolicy.REPLACE_EXISTING に設定すると、既存の MBean が必要に応じて登録中に置き換えられます。これは、MBeanServerSE の状態を保証できない状況で役立ちます。

導入:
2.0
作成者:
Rob Harrop, Juergen Hoeller, Phillip Webb
関連事項:

  • フィールドの詳細

    • logger

      protected final Log logger
      このクラスの Log インスタンス。

    • server

      @Nullable protected MBeanServerSE server
      Bean の登録に使用されている MBeanServer インスタンス。

  • コンストラクターの詳細

    • MBeanRegistrationSupport

      public MBeanRegistrationSupport()

  • メソッドの詳細

    • setServer

      public void setServer(@Nullable MBeanServerSE server)
      すべての Bean を登録する MBeanServer インスタンスを指定します。MBeanExporter は、何も指定されていない場合、既存の MBeanServer を見つけようとします。

    • getServer

      @Nullable public final MBeanServerSE getServer()
      Bean が登録される MBeanServer を返します。

    • setRegistrationPolicy

      public void setRegistrationPolicy(RegistrationPolicy registrationPolicy)
      すでに存在する ObjectNameSE で MBean を登録しようとするときに使用するポリシー。
      パラメーター:
      registrationPolicy - 使用するポリシー
      導入:
      3.2

    • doRegister

      protected void doRegister(ObjectSE mbean, ObjectNameSE objectName) throws JMExceptionSE
      実際に MBean をサーバーに登録します。既存の MBean に遭遇したときの動作は、setRegistrationPolicy(org.springframework.jmx.support.RegistrationPolicy) を使用して構成できます。
      パラメーター:
      mbean - MBean インスタンス
      objectName - MBean の推奨 ObjectName
      例外:
      JMExceptionSE - 登録に失敗した場合

    • unregisterBeans

      protected void unregisterBeans()
      このクラスのインスタンスによって登録されたすべての Bean を登録解除します。

    • doUnregister

      protected void doUnregister(ObjectNameSE objectName)
      指定された MBean をサーバーから実際に登録解除します。
      パラメーター:
      objectName - MBean の推奨 ObjectName

    • getRegisteredObjectNames

      protected final ObjectNameSE[] getRegisteredObjectNames()
      登録されているすべての Bean の ObjectNamesSE を返します。

    • onRegister

      protected void onRegister(ObjectNameSE objectName, ObjectSE mbean)
      MBean が指定された ObjectNameSE で登録されたときに呼び出されます。MBean の登録時にサブクラスが追加の処理を実行できるようにします。

      デフォルトの実装は onRegister(ObjectName) に委譲します。

      パラメーター:
      objectName - MBean が登録された実際の ObjectNameSE
      mbean - 登録された MBean インスタンス

    • onRegister

      protected void onRegister(ObjectNameSE objectName)
      MBean が指定された ObjectNameSE で登録されたときに呼び出されます。MBean の登録時にサブクラスが追加の処理を実行できるようにします。

      デフォルトの実装は空です。サブクラスでオーバーライドできます。

      パラメーター:
      objectName - MBean が登録された実際の ObjectNameSE

    • onUnregister

      protected void onUnregister(ObjectNameSE objectName)
      MBean が指定された ObjectNameSE で登録解除されたときに呼び出されます。MBean が登録解除されたときにサブクラスが追加の処理を実行できるようにします。

      デフォルトの実装は空です。サブクラスでオーバーライドできます。

      パラメーター:
      objectName - MBean が登録された ObjectNameSE