RmiRegistryFactoryBean (Spring Framework 5.0.0.RELEASE API)

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

実装されているすべてのインターフェース:
DisposableBean, FactoryBean<RegistrySE>, InitializingBean
```
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

フィールド
修飾子と型	フィールドと説明
`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

フィールドのサマリー

コンストラクターの概要

メソッドのサマリー

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

フィールドの詳細

logger

コンストラクターの詳細

RmiRegistryFactoryBean

メソッドの詳細

setHost

getHost

setPort

getPort

setClientSocketFactory

setServerSocketFactory

setAlwaysCreate

afterPropertiesSet

getRegistry

getRegistry

getRegistry

testRegistry

getObject

getObjectType

isSingleton

destroy