モジュール java.rmi

パッケージ java.rmi.registry

インタフェースRegistry

すべてのスーパー・インタフェース:

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

フィールドのサマリー

フィールド

修飾子と型	フィールド	説明
static final int	REGISTRY_PORT	レジストリによく使われるポートです。

メソッドのサマリー

修飾子と型	メソッド	説明
void	bind(String name, Remote obj)	このレジストリ内の特定のnameにリモート参照をバインドします。
String[]	list()	このレジストリ内にバインドされた名前の配列を返します。
Remote	lookup(String name)	このレジストリ内の特定のnameにバインドされているリモート参照を返します。
void	rebind(String name, Remote obj)	このレジストリ内の特定のnameへのバインディングを特定のリモート参照に置き換えます。
void	unbind(String name)	このレジストリの特定のnameへのバインディングを削除します。

フィールド詳細

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 - ローカル・レジストリがこの操作を実行する呼出し側アクセスを拒否した場合