- すべてのスーパー・インタフェース:
Remote
public interface Registry extends Remote
Registry
は、単純なリモート・オブジェクト・レジストリに対するリモート・インタフェースで、任意の文字列名にバインドされたリモート・オブジェクト参照を格納および取得するためのメソッドを提供します。 bind
、unbind
、およびrebind
メソッドはレジストリ内のネーム・バインディングを変更するときに使用し、lookup
およびlist
メソッドは現在のネーム・バインディングを照会するときに使用します。
Registry
は通常、RMIクライアントのブートストラップを有効にします。クライアントは、リモート・オブジェクトへの初期参照を起動時に取得します。 このため、レジストリのリモート・オブジェクト実装は通常、既知のアドレス(既知のObjID
など)およびTCPポート番号(デフォルトは1099
)を使ってエクスポートされます。
LocateRegistry
クラスでは、リモート・アドレスにあるRegistry
へのブートストラップ参照を構築するためのプログラムAPI (staticメソッドgetRegistry
を参照)と、現在のVMにRegistry
を作成して特定のローカル・アドレスにエクスポートするプログラムAPI (staticメソッドcreateRegistry
を参照)を利用できます。
Registry
の実装では、その一部またはすべてのメソッドへのアクセスを制限できます。たとえば、レジストリのバインディングを変更するメソッドをローカル・ホストから発生する呼出しに制限できます。 Registry
メソッドが特定の呼出しのアクセスを拒否した場合、その実装によりAccessException
がスローされることがあります。この例外はRemoteException
の拡張であるため、リモート・クライアントにキャッチされるとServerException
にラップされます。
Registry
でバインディングに使用する名前は、純粋な文字列で、解析されません。 Registry
にサービスへのリモート参照を格納するときは、レジストリ内での名前の衝突を減らすために、ネーム・バインディングの接頭辞としてパッケージ名を使用することをお薦めします。
- 導入されたバージョン:
- 1.1
- 関連項目:
LocateRegistry
-
フィールド詳細
-
REGISTRY_PORT
static final int REGISTRY_PORTレジストリによく使われるポートです。- 関連項目:
- 定数フィールド値
-
-
メソッドの詳細
-
lookup
Remote lookup(String name) throws RemoteException, NotBoundException, AccessExceptionこのレジストリ内の特定のname
にバインドされているリモート参照を返します。- パラメータ:
name
- 検索するリモート参照の名前- 戻り値:
- リモート・オブジェクトへの参照
- 例外:
NotBoundException
-name
がバインドされていない場合RemoteException
- レジストリとのリモート通信に失敗した場合。AccessException
を含むServerException
例外の場合、レジストリはこの操作を実行する呼出し側アクセスを拒否するAccessException
- ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合NullPointerException
-name
がnull
である場合
-
bind
void bind(String name, Remote obj) throws RemoteException, AlreadyBoundException, AccessExceptionこのレジストリ内の特定のname
にリモート参照をバインドします。- パラメータ:
name
- リモート参照に関連付ける名前obj
- リモート・オブジェクトへの参照(通常はスタブ)- 例外:
AlreadyBoundException
-name
がすでにバインドされている場合RemoteException
- レジストリとのリモート通信に失敗した場合。AccessException
を含むServerException
例外の場合、レジストリはこの操作を実行する呼出し側アクセスを拒否する(たとえば、ローカルではないホストから操作している場合)AccessException
- ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合NullPointerException
-name
がnull
、またはobj
がnull
の場合
-
unbind
void unbind(String name) throws RemoteException, NotBoundException, AccessExceptionこのレジストリの特定のname
へのバインディングを削除します。- パラメータ:
name
- 削除するバインディングの名前- 例外:
NotBoundException
-name
がバインドされていない場合RemoteException
- レジストリとのリモート通信に失敗した場合。AccessException
を含むServerException
例外の場合、レジストリはこの操作を実行する呼出し側アクセスを拒否する(たとえば、ローカルではないホストから操作している場合)AccessException
- ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合NullPointerException
-name
がnull
である場合
-
rebind
void rebind(String name, Remote obj) throws RemoteException, AccessExceptionこのレジストリ内の特定のname
へのバインディングを特定のリモート参照に置き換えます。 指定されたname
にすでにバインディングが設定されている場合は、破棄されます。- パラメータ:
name
- リモート参照に関連付ける名前obj
- リモート・オブジェクトへの参照(通常はスタブ)- 例外:
RemoteException
- レジストリとのリモート通信に失敗した場合。AccessException
を含むServerException
例外の場合、レジストリはこの操作を実行する呼出し側アクセスを拒否する(たとえば、ローカルではないホストから操作している場合)AccessException
- ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合NullPointerException
-name
がnull
、またはobj
がnull
の場合
-
list
String[] list() throws RemoteException, AccessExceptionこのレジストリ内にバインドされた名前の配列を返します。 配列には、このメソッドを呼び出した時点でレジストリ内にバインドされている名前のスナップショットが含まれます。- 戻り値:
- このレジストリ内にバインドされた名前の配列
- 例外:
RemoteException
- レジストリとのリモート通信に失敗した場合。AccessException
を含むServerException
例外の場合、レジストリはこの操作を実行する呼出し側アクセスを拒否するAccessException
- ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合
-