public class RmiRegistryFactoryBean extends ObjectSE implements FactoryBean<RegistrySE>, InitializingBean, DisposableBean
Registry
SE を見つけ、Bean 参照用に公開する FactoryBean
。ローカル RMI レジストリがまだ存在しない場合は、その場で作成することもできます。 実際のレジストリオブジェクトをセットアップし、RMI で動作する必要があるアプリケーションオブジェクトに渡すために使用できます。RMI で動作する必要のあるオブジェクトの例として、Spring の RmiServiceExporter
があります。これは、渡されたレジストリ参照で動作するか、ローカルプロパティとデフォルトで指定されたレジストリにフォールバックします。
また、JMX コネクターなど、特定のポートでローカル RMI レジストリの作成を強制するのにも役立ちます。ConnectorServerFactoryBean
と組み合わせて使用する場合は、レジストリ定義(RmiRegistryFactoryBean)の「依存」としてコネクター定義(ConnectorServerFactoryBean)をマークして、レジストリの最初の始動を保証することをお勧めします。
メモ: このクラスの実装は、RmiServiceExporter
の対応するロジックを反映しており、同じカスタマイズフックも提供しています。RmiServiceExporter は、便利な独自のレジストリルックアップを実装しています: レジストリのデフォルトに単純に依存することは非常に一般的です。
RmiServiceExporter.setRegistry(java.rmi.registry.Registry)
, ConnectorServerFactoryBean
, Registry
SE, LocateRegistry
SEコンストラクターと説明 |
---|
RmiRegistryFactoryBean() |
修飾子と型 | メソッドと説明 |
---|---|
void | afterPropertiesSet() |
void | destroy() この Bean が実際にレジストリを作成した場合、Bean のファクトリシャットダウン時に RMI レジストリをアンエクスポートします。 |
StringSE | getHost() エクスポートされた RMI サービスのレジストリのホストを返します。 |
RegistrySE | getObject() このファクトリによって管理されるオブジェクトのインスタンス(おそらく共有または独立)を返します。 |
ClassSE<? extends RegistrySE> | getObjectType() この FactoryBean が作成するオブジェクトの型、または事前に不明な場合は null を返します。 |
int | getPort() エクスポートされた RMI サービスのレジストリのポートを返します。 |
protected RegistrySE | getRegistry(int registryPort) RMI レジストリを見つけるか作成します。 |
protected RegistrySE | getRegistry(int registryPort, RMIClientSocketFactorySE clientSocketFactory, RMIServerSocketFactorySE serverSocketFactory) RMI レジストリを見つけるか作成します。 |
protected RegistrySE | getRegistry(StringSE registryHost, int registryPort, RMIClientSocketFactorySE clientSocketFactory, RMIServerSocketFactorySE serverSocketFactory) RMI レジストリを見つけるか作成します。 |
boolean | isSingleton() このファクトリによって管理されるオブジェクトはシングルトンですか? つまり、 FactoryBean.getObject() は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? |
void | setAlwaysCreate(boolean alwaysCreate) 指定されたポートで既存のレジストリを見つけようとせずに、常にインプロセスでレジストリを作成するかどうかを設定します。 |
void | setClientSocketFactory(RMIClientSocketFactorySE clientSocketFactory) RMI レジストリに使用するカスタム RMI クライアントソケットファクトリを設定します。 |
void | setHost(StringSE host) エクスポートされた RMI サービスのレジストリのホストを設定します。 |
void | setPort(int port) エクスポートされた RMI サービスのレジストリのポートを設定します。 |
void | setServerSocketFactory(RMIServerSocketFactorySE serverSocketFactory) RMI レジストリに使用するカスタム RMI サーバーソケットファクトリを設定します。 |
protected void | testRegistry(RegistrySE registry) 指定された RMI レジストリをテストし、その上で何らかの操作を呼び出して、まだアクティブかどうかを確認します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
protected final Log logger
public void setHost(StringSE host)
rmi://HOST:port/name
を設定します デフォルトは localhost です。
public StringSE getHost()
public void setPort(int port)
rmi://host:PORT/name
を設定します デフォルトは Registry.REGISTRY_PORT
(1099) です。
public int getPort()
public void setClientSocketFactory(RMIClientSocketFactorySE clientSocketFactory)
指定されたオブジェクトも java.rmi.server.RMIServerSocketFactory
を実装している場合、サーバーソケットファクトリとしても自動的に登録されます。
public void setServerSocketFactory(RMIServerSocketFactorySE serverSocketFactory)
クライアントソケットファクトリが java.rmi.server.RMIServerSocketFactory
をまだ実装していない場合にのみ指定する必要があります。
public void setAlwaysCreate(boolean alwaysCreate)
デフォルトは "false" です。常に新しいレジストリを作成する場合に、既存のレジストリを見つけるオーバーヘッドを回避するために、このフラグを "true" に切り替えます。
public void afterPropertiesSet() throws ExceptionSE
InitializingBean
BeanFactoryAware
、ApplicationContextAware
などを満たした後、包含 BeanFactory
によって呼び出されます。このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。
InitializingBean
の afterPropertiesSet
ExceptionSE
- 構成の誤り(必須プロパティの設定の失敗など)の場合、またはその他の理由で初期化が失敗した場合 protected RegistrySE getRegistry(StringSE registryHost, int registryPort, @Nullable RMIClientSocketFactorySE clientSocketFactory, @Nullable RMIServerSocketFactorySE serverSocketFactory) throws RemoteExceptionSE
registryHost
- 使用するレジストリホスト (これが指定されている場合、RMI レジストリの暗黙的な作成は行われません)registryPort
- 使用するレジストリポート clientSocketFactory
- レジストリの RMI クライアントソケットファクトリ (もしあれば)serverSocketFactory
- レジストリの RMI サーバーソケットファクトリ (もしあれば)RemoteExceptionSE
- レジストリを見つけられなかったか、作成できなかった場合 protected RegistrySE getRegistry(int registryPort, @Nullable RMIClientSocketFactorySE clientSocketFactory, @Nullable RMIServerSocketFactorySE serverSocketFactory) throws RemoteExceptionSE
registryPort
- 使用するレジストリポート clientSocketFactory
- レジストリの RMI クライアントソケットファクトリ (もしあれば)serverSocketFactory
- レジストリの RMI サーバーソケットファクトリ (もしあれば)RemoteExceptionSE
- レジストリを見つけられなかったか、作成できなかった場合 protected RegistrySE getRegistry(int registryPort) throws RemoteExceptionSE
registryPort
- 使用するレジストリポート RemoteExceptionSE
- レジストリを見つけられなかったか、作成できなかった場合 protected void testRegistry(RegistrySE registry) throws RemoteExceptionSE
デフォルトの実装は Registry.list()
を呼び出します。
registry
- テストする RMI レジストリ RemoteExceptionSE
- レジストリメソッドによってスローされた場合 Registry.list()
SEpublic RegistrySE getObject() throws ExceptionSE
FactoryBean
BeanFactory
と同様に、これにより、シングルトンとプロトタイプの両方のデザインパターンをサポートできます。
この FactoryBean が呼び出し時にまだ完全に初期化されていない場合(たとえば、循環参照に関係しているため)、対応する FactoryBeanNotInitializedException
をスローします。
Spring 2.0 以降、FactoryBeans は null
オブジェクトを返すことができます。ファクトリはこれを通常の値として使用します。この場合、FactoryBeanNotInitializedException はスローされません。FactoryBean の実装では、必要に応じて FactoryBeanNotInitializedException 自体をすぐにスローすることをお勧めします。
FactoryBean<RegistrySE>
の getObject
null
にすることができます)ExceptionSE
- 作成エラーの場合 FactoryBeanNotInitializedException
public ClassSE<? extends RegistrySE> getObjectType()
FactoryBean
null
を返します。これにより、たとえばオートワイヤーなどで、オブジェクトをインスタンス化せずに特定の型の Bean を確認できます。
シングルトンオブジェクトを作成している実装の場合、このメソッドはシングルトンの作成を可能な限り回避しようとします。むしろ、事前に型を推定する必要があります。プロトタイプの場合、ここで意味のある型を返すこともお勧めします。
このメソッドは、この FactoryBean が完全に初期化される前に呼び出すことができます。初期化中に作成された状態に依存しないでください。もちろん、利用可能な場合はそのような状態を引き続き使用できます。
注意 : オートワイヤーは、ここで null
を返す FactoryBeans を単に無視します。FactoryBean の現在の状態を使用して、このメソッドを適切に実装することを強くお勧めします。
FactoryBean<RegistrySE>
の getObjectType
null
ListableBeanFactory.getBeansOfType(java.lang.Class<T>)
public boolean isSingleton()
FactoryBean
FactoryBean.getObject()
は常に同じオブジェクト(キャッシュ可能な参照)を返しますか? 注意 : FactoryBean がシングルトンオブジェクトを保持することを示す場合、getObject()
から返されたオブジェクトは所有 BeanFactory によってキャッシュされる可能性があります。FactoryBean が常に同じ参照を公開しない限り、true
を返さないでください。
FactoryBean 自体のシングルトンステータスは、通常、所有する BeanFactory によって提供されます。通常、そこではシングルトンとして定義する必要があります。
注意 : false
を返すこのメソッドは、返されるオブジェクトが独立したインスタンスであることを必ずしも示しません。拡張 SmartFactoryBean
インターフェースの実装は、SmartFactoryBean.isPrototype()
メソッドを通じて独立したインスタンスを明示的に示す場合があります。この拡張インターフェースを実装しないプレーンな FactoryBean
実装は、isSingleton()
実装が false
を返す場合、常に独立したインスタンスを返すと単純に想定されます。
FactoryBean
は通常シングルトンインスタンスを管理するため、デフォルトの実装では true
が返されます。
FactoryBean<RegistrySE>
の isSingleton
FactoryBean.getObject()
, SmartFactoryBean.isPrototype()
public void destroy() throws RemoteExceptionSE
DisposableBean
の destroy
RemoteExceptionSE