クラス MBeanServerFactoryBean
- 実装されたすべてのインターフェース:
DisposableBean
、FactoryBean<MBeanServerSE>
、InitializingBean
MBeanServerFactory
SE API を介して MBeanServer
SE 参照を取得する FactoryBean
。Bean 参照の MBeanServer
を公開します。
デフォルトでは、MBeanServerFactoryBean
は、すでに実行されている場合でも、常に新しい MBeanServer
を作成します。MBeanServerFactoryBean
が実行中の MBeanServer
を最初に見つけようとするようにするには、"locateExistingServerIfPossible" プロパティの値を "true" に設定します。
- 導入:
- 1.2
- 作成者:
- Rob Harrop, Juergen Hoeller
- 関連事項:
フィールドサマリー
フィールドインターフェース org.springframework.beans.factory.FactoryBean から継承されたフィールド
OBJECT_TYPE_ATTRIBUTE
コンストラクターのサマリー
コンストラクターメソッドのサマリー
修飾子と型メソッド説明void
MBeanServer
インスタンスを作成します。protected MBeanServerSE
createMBeanServer
(StringSE defaultDomain, boolean registerWithFactory) 必要に応じて、新しいMBeanServer
インスタンスを作成し、MBeanServerFactory
に登録します。void
destroy()
必要に応じて、MBeanServer
インスタンスの登録を解除します。このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。ClassSE<? extends MBeanServerSE>
この FactoryBean が作成するオブジェクトの型、または事前に不明な場合はnull
を返します。boolean
このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、FactoryBean.getObject()
は常に同じオブジェクト(キャッシュ可能な参照)を返しますか?protected MBeanServerSE
locateMBeanServer
(StringSE agentId) 既存のMBeanServer
を見つけようとします。void
setAgentId
(StringSE agentId) 検索するMBeanServer
のエージェント ID を設定します。void
setDefaultDomain
(StringSE defaultDomain) MBeanServer
で使用され、MBeanServerFactory.createMBeanServer()
またはMBeanServerFactory.findMBeanServer()
に渡されるデフォルトのドメインを設定します。void
setLocateExistingServerIfPossible
(boolean locateExistingServerIfPossible) MBeanServerFactoryBean
が、実行中のMBeanServer
を作成する前に検索を試みるかどうかを設定します。void
setRegisterWithFactory
(boolean registerWithFactory) MBeanServer
をMBeanServerFactory
に登録するかどうかを設定し、MBeanServerFactory.findMBeanServer()
を介して利用できるようにします。
フィールドの詳細
logger
コンストラクターの詳細
MBeanServerFactoryBean
public MBeanServerFactoryBean()
メソッドの詳細
setLocateExistingServerIfPossible
public void setLocateExistingServerIfPossible(boolean locateExistingServerIfPossible) MBeanServerFactoryBean
が、実行中のMBeanServer
を作成する前に検索を試みるかどうかを設定します。デフォルトは
false
です。setAgentId
検索するMBeanServer
のエージェント ID を設定します。デフォルトは none です。指定した場合、これにより、アテンダント MBeanServer の検索が自動的に試行され、(重要なことですが)MBeanServer が見つからない場合、新しい MBeanServer の作成は試行されません(解決時に MBeanServerNotFoundException がスローされます)。
空の文字列を指定すると、プラットフォーム MBeanServer が示されます。
setDefaultDomain
MBeanServer
で使用され、MBeanServerFactory.createMBeanServer()
またはMBeanServerFactory.findMBeanServer()
に渡されるデフォルトのドメインを設定します。デフォルトはなしです。
setRegisterWithFactory
public void setRegisterWithFactory(boolean registerWithFactory) MBeanServer
をMBeanServerFactory
に登録するかどうかを設定し、MBeanServerFactory.findMBeanServer()
を介して利用できるようにします。デフォルトは
true
です。afterPropertiesSet
MBeanServer
インスタンスを作成します。- 次で指定:
- インターフェース
InitializingBean
のafterPropertiesSet
- 例外:
MBeanServerNotFoundException
locateMBeanServer
protected MBeanServerSE locateMBeanServer(@Nullable StringSE agentId) throws MBeanServerNotFoundException 既存のMBeanServer
を見つけようとします。locateExistingServerIfPossible
がtrue
に設定されている場合に呼び出されます。デフォルトの実装では、標準のルックアップを使用して
MBeanServer
を見つけようとします。サブクラスをオーバーライドして、ロケーションロジックを追加できます。- パラメーター:
agentId
- 取得する MBeanServer のエージェント識別子。このパラメーターがnull
の場合、登録されているすべての MBeanServer が考慮されます。- 戻り値:
MBeanServer
が見つかった場合- 例外:
MBeanServerNotFoundException
-MBeanServer
が見つからなかった場合- 関連事項:
createMBeanServer
protected MBeanServerSE createMBeanServer(@Nullable StringSE defaultDomain, boolean registerWithFactory) 必要に応じて、新しいMBeanServer
インスタンスを作成し、MBeanServerFactory
に登録します。- パラメーター:
defaultDomain
- デフォルトのドメイン、または存在しない場合はnull
registerWithFactory
-MBeanServer
をMBeanServerFactory
に登録するかどうか- 関連事項:
getObject
インターフェースからコピーされた説明:FactoryBean
このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。BeanFactory
と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する
FactoryBeanNotInitializedException
をスローします。Spring 2.0 以降、FactoryBeans は
null
オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。- 次で指定:
- インターフェース
FactoryBean<MBeanServerSE>
のgetObject
- 戻り値:
- Bean のインスタンス (
null
にすることができます) - 関連事項:
getObjectType
インターフェースからコピーされた説明:FactoryBean
この FactoryBean が作成するオブジェクトの型、または事前に不明な場合はnull
を返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで
null
を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。- 次で指定:
- インターフェース
FactoryBean<MBeanServerSE>
のgetObjectType
- 戻り値:
- この FactoryBean が作成するオブジェクトの型、または呼び出し時に不明な場合は
null
- 関連事項:
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
- 戻り値:
- 公開されたオブジェクトがシングルトンかどうか
- 関連事項:
destroy
public void destroy()必要に応じて、MBeanServer
インスタンスの登録を解除します。- 次で指定:
- インターフェース
DisposableBean
のdestroy