クラス MBeanServerFactoryBean

メソッドの詳細

• setLocateExistingServerIfPossible

  public void setLocateExistingServerIfPossible(boolean locateExistingServerIfPossible)

  MBeanServerFactoryBean が、実行中の MBeanServer を作成する前に検索を試みるかどうかを設定します。

  デフォルトは false です。

• setAgentId

  public void setAgentId(StringSE agentId)

  検索する MBeanServer のエージェント ID を設定します。

  デフォルトは none です。指定した場合、これにより、アテンダント MBeanServer の検索が自動的に試行され、（重要なことですが）MBeanServer が見つからない場合、新しい MBeanServer の作成は試行されません（解決時に MBeanServerNotFoundException がスローされます）。

  空の文字列を指定すると、プラットフォーム MBeanServer が示されます。

  関連事項:

  • MBeanServerFactory.findMBeanServer(String)SE

• setDefaultDomain

  public void setDefaultDomain(StringSE defaultDomain)

  MBeanServer で使用され、MBeanServerFactory.createMBeanServer() または MBeanServerFactory.findMBeanServer() に渡されるデフォルトのドメインを設定します。

  デフォルトはなしです。

  関連事項:

  • MBeanServerFactory.createMBeanServer(String)SE
  • MBeanServerFactory.findMBeanServer(String)SE

• setRegisterWithFactory

  public void setRegisterWithFactory(boolean registerWithFactory)

  MBeanServer を MBeanServerFactory に登録するかどうかを設定し、MBeanServerFactory.findMBeanServer() を介して利用できるようにします。

  デフォルトは true です。

  関連事項:

  • MBeanServerFactory.createMBeanServer()
  • MBeanServerFactory.findMBeanServer(java.lang.String)SE

• afterPropertiesSet

  public void afterPropertiesSet() throws MBeanServerNotFoundException

  MBeanServer インスタンスを作成します。

  次で指定:

  インターフェース InitializingBean の afterPropertiesSet 

  例外:

  MBeanServerNotFoundException

• locateMBeanServer

  protected MBeanServerSE locateMBeanServer(@Nullable StringSE agentId) throws MBeanServerNotFoundException

  既存の MBeanServer を見つけようとします。locateExistingServerIfPossible が true に設定されている場合に呼び出されます。

  デフォルトの実装では、標準のルックアップを使用して MBeanServer を見つけようとします。サブクラスをオーバーライドして、ロケーションロジックを追加できます。

  パラメーター:

  agentId - 取得する MBeanServer のエージェント識別子。このパラメーターが null の場合、登録されているすべての MBeanServer が考慮されます。

  戻り値:

  MBeanServer が見つかった場合

  例外:

  MBeanServerNotFoundException - MBeanServer が見つからなかった場合

  関連事項:

  • setLocateExistingServerIfPossible(boolean)
  • JmxUtils.locateMBeanServer(String)
  • MBeanServerFactory.findMBeanServer(String)SE

• createMBeanServer

  protected MBeanServerSE createMBeanServer(@Nullable StringSE defaultDomain, boolean registerWithFactory)

  必要に応じて、新しい MBeanServer インスタンスを作成し、MBeanServerFactory に登録します。

  パラメーター:

  defaultDomain - デフォルトのドメイン、または存在しない場合は null 

  registerWithFactory - MBeanServer を MBeanServerFactory に登録するかどうか

  関連事項:

  • MBeanServerFactory.createMBeanServer()
  • MBeanServerFactory.newMBeanServer()

• getObject

  @Nullable public MBeanServerSE getObject()

  インターフェースからコピーされた説明: FactoryBean

  このファクトリによって管理されるオブジェクトのインスタンス（おそらく共有または独立）を返します。

  BeanFactory と同様に、これにより、シングルトンとプロトタイプの両方の設計パターンをサポートできます。

  この FactoryBean が呼び出し時にまだ完全に初期化されていない場合（たとえば、循環参照に関係しているため）、対応する FactoryBeanNotInitializedException をスローします。

  FactoryBeans は null オブジェクトを返すことができます。Bean ファクトリはこれを通常の値と見なし、この場合は FactoryBeanNotInitializedException をスローしません。ただし、FactoryBean 実装では、必要に応じて FactoryBeanNotInitializedException 自体をスローすることが推奨されます。

  次で指定:

  インターフェース FactoryBean<MBeanServerSE> の getObject 

  戻り値:

  Bean のインスタンス (null にすることができます)

  関連事項:

  • FactoryBeanNotInitializedException

• getObjectType

  public ClassSE<? extends MBeanServerSE> getObjectType()

  インターフェースからコピーされた説明: FactoryBean

  この FactoryBean が作成するオブジェクトの型を返します。事前にわからない場合は null を返します。

  これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。

  シングルトンオブジェクトを作成する実装の場合、このメソッドはシングルトンの作成を可能な限り回避し、事前に型を推定する必要があります。プロトタイプの場合は、ここで意味のある型を返すことも推奨されます。

  このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。

  注意 : オートワイヤーは、ここで null を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。

  次で指定:

  インターフェース FactoryBean<MBeanServerSE> の getObjectType 

  戻り値:

  この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は null 

  関連事項:

  • ListableBeanFactory.getBeansOfType(java.lang.Class<T>)

• isSingleton

  public boolean isSingleton()

  インターフェースからコピーされた説明: FactoryBean

  このファクトリによって管理されるオブジェクトはシングルトンですか？ つまり、FactoryBean.getObject() は常に同じオブジェクト（キャッシュ可能な参照）を返しますか？

  注意 : FactoryBean がシングルトンオブジェクトを保持していることを示している場合、getObject() から返されたオブジェクトは、所有する BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true を返さないでください。

  FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。

  注意 : false を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張 SmartFactoryBean インターフェースの実装は、SmartFactoryBean.isPrototype() メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンな FactoryBean 実装は、isSingleton() 実装が false を返す場合、常に独立したインスタンスを返すと単純に想定されます。

  FactoryBean は通常シングルトンインスタンスを管理するため、デフォルトの実装では true が返されます。

  次で指定:

  インターフェース FactoryBean<MBeanServerSE> の isSingleton 

  戻り値:

  公開されたオブジェクトがシングルトンかどうか

  関連事項:

  • FactoryBean.getObject()
  • SmartFactoryBean.isPrototype()

• destroy

  public void destroy()

  必要に応じて、MBeanServer インスタンスの登録を解除します。

  次で指定:

  インターフェース DisposableBean の destroy