RmiRegistryFactoryBean (Spring Framework API)

java.lang.ObjectSE
- org.springframework.remoting.rmi.RmiRegistryFactoryBean

実装されたすべてのインターフェース:
DisposableBean, FactoryBean<RegistrySE>, InitializingBean
使用すべきではありません。
5.3 現在 (直列化ベースのリモート処理を段階的に廃止)
```
@DeprecatedSE
public class RmiRegistryFactoryBean
extends ObjectSE
implements FactoryBean<RegistrySE>, InitializingBean, DisposableBean
```
RegistrySE を見つけ、Bean 参照用に公開する FactoryBean。ローカル RMI レジストリがまだ存在しない場合は、その場で作成することもできます。
実際のレジストリオブジェクトをセットアップし、RMI で動作する必要があるアプリケーションオブジェクトに渡すために使用できます。RMI で動作する必要のあるオブジェクトの例として、Spring の RmiServiceExporter があります。これは、渡されたレジストリ参照で動作するか、ローカルプロパティとデフォルトで指定されたレジストリにフォールバックします。
また、JMX コネクターなど、特定のポートでローカル RMI レジストリの作成を強制するのにも役立ちます。ConnectorServerFactoryBean と組み合わせて使用する場合は、レジストリ定義（RmiRegistryFactoryBean）の「依存」としてコネクター定義（ConnectorServerFactoryBean）をマークして、レジストリの最初の始動を保証することをお勧めします。
メモ: このクラスの実装は、RmiServiceExporter の対応するロジックを反映しており、同じカスタマイズフックも提供しています。RmiServiceExporter は、便利な独自のレジストリルックアップを実装しています: レジストリのデフォルトに単純に依存することは非常に一般的です。
導入:
1.2.3
作成者:
Juergen Hoeller
関連事項:
RmiServiceExporter.setRegistry(java.rmi.registry.Registry), ConnectorServerFactoryBean, RegistrySE, LocateRegistrySE

フィールドサマリー
フィールド
修飾子と型フィールドと説明
protected Log logger
使用すべきではありません。
- インターフェース org.springframework.beans.factory.FactoryBean から継承されたフィールド
  OBJECT_TYPE_ATTRIBUTE

フィールド
修飾子と型	フィールドと説明
`protected Log`	`logger` 使用すべきではありません。

コンストラクターのサマリー
コンストラクター
コンストラクターと説明
RmiRegistryFactoryBean()
使用すべきではありません。

コンストラクター
コンストラクターと説明
`RmiRegistryFactoryBean()` 使用すべきではありません。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`void`	`afterPropertiesSet()` 使用すべきではありません。すべての Bean プロパティを設定し、`BeanFactoryAware`、`ApplicationContextAware` などを満たした後、包含 `BeanFactory` によって呼び出されます。
`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 レジストリをテストし、その上で何らかの操作を呼び出して、まだアクティブかどうかを確認します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

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

クラス RmiRegistryFactoryBean

フィールドサマリー

インターフェース org.springframework.beans.factory.FactoryBean から継承されたフィールド

コンストラクターのサマリー

メソッドのサマリー

クラス java.lang.ObjectSE から継承されたメソッド

フィールドの詳細

logger

コンストラクターの詳細

RmiRegistryFactoryBean

メソッドの詳細

setHost

getHost

setPort

getPort

setClientSocketFactory

setServerSocketFactory

setAlwaysCreate

afterPropertiesSet

getRegistry

getRegistry

getRegistry

testRegistry

getObject

getObjectType

isSingleton

destroy