Java 2 Platform SE 1.3: インタフェース Registry

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM 2 Platform
Std. Ed. v1.3

前のクラス 次のクラス

フレームあり フレームなし

概要: 内部クラス | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.rmi.registry
インタフェース Registry

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

public interface Registry
extends Remote

リモートオブジェクトの参照を取得するために、RMI はリモートオブジェクトの参照を格納および取得するためのメソッドを提供する単純なリモートオブジェクトレジストリインタフェース (RMI の rmiregistry によって実装される) を提供します。java.rmi.Naming クラスは、リモートレジストリとリモートオブジェクトの名前の両方を簡潔な形式で指定する URL 形式の名前を使ってリモートオブジェクトレジストリにアクセスするためのメソッドを提供します。

通常、レジストリは、ノード上にあるサーバへの RMI 接続を許可する各ノードに存在します。特定のノード上のレジストリには、名前をリモートオブジェクトに対応付けるための一時的なデータベースが格納されます。レジストリの起動時は、レジストリのデータベースは空の状態です。レジストリ内に保存されている名前はそのままの状態で、解析されていません。レジストリにサービスを保存する際には、レジストリ内で名前が重複する可能性を減らすために、サービス名の先頭にパッケージ名を付けるのが理想的です (必須ではない)。

アプリケーションで動作するレジストリを作成するには、LocateRegistry.createRegistry メソッドを使います。リモートオブジェクトレジストリの参照を取得するには、LocateRegistry.getRegistry メソッドを使います。

導入されたバージョン:: JDK1.1
関連項目:: Naming, LocateRegistry

フィールドの概要

static int REGISTRY_PORT
          レジストリによく使われるポートです。

メソッドの概要

void bind(String name, Remote obj)
          指定された name をリモートオブジェクトにバインドします。

String[] list()
          レジストリ内のバインドされている名前の配列を返します。

Remote lookup(String name)
          指定された name に関連したリモートオブジェクトの参照 (スタブ) を返します。

void rebind(String name, Remote obj)
          指定された名前を新しいリモートオブジェクトにバインドし直します。

void unbind(String name)
          リモートオブジェクトに関連した指定された名前に対するバインディングを破棄します。

フィールドの詳細

REGISTRY_PORT

public static final int REGISTRY_PORT

レジストリによく使われるポートです。

メソッドの詳細

lookup

public Remote lookup(String name)
              throws RemoteException,
                     NotBoundException,
                     AccessException

指定された name に関連したリモートオブジェクトの参照 (スタブ) を返します。

パラメータ:: name - リモートオブジェクトの URL 形式の名前
戻り値:: リモートオブジェクトの参照
例外:: NotBoundException - 名前がバインドされていない場合; RemoteException - レジストリに接続できない場合; AccessException - この操作が許可されていない場合 (たとえば、ローカルではないホストから操作している場合)
導入されたバージョン:: JDK1.1

bind

public void bind(String name,
                 Remote obj)
          throws RemoteException,
                 AlreadyBoundException,
                 AccessException

指定された name をリモートオブジェクトにバインドします。

パラメータ:: name - リモートオブジェクトの URL 形式の名前; obj - リモートオブジェクトの参照 (通常はスタブ)
例外:: AlreadyBoundException - 名前がすでにバインドされている場合; MalformedURLException - 名前が適切な形式の URL でない場合; RemoteException - レジストリに接続できない場合; AccessException - この操作が許可されていない場合 (たとえば、ローカルではないホストから操作している場合)
導入されたバージョン:: JDK1.1

unbind

public void unbind(String name)
            throws RemoteException,
                   NotBoundException,
                   AccessException

リモートオブジェクトに関連した指定された名前に対するバインディングを破棄します。

パラメータ:: name - リモートオブジェクトに関連した URL 形式の名前
例外:: NotBoundException - 名前がバインドされていない場合; MalformedURLException - 名前が適切な形式の URL でない場合; RemoteException - レジストリに接続できない場合; AccessException - この操作が許可されていない場合 (たとえば、ローカルではないホストから操作している場合)
導入されたバージョン:: JDK1.1

rebind

public void rebind(String name,
                   Remote obj)
            throws RemoteException,
                   AccessException

指定された名前を新しいリモートオブジェクトにバインドし直します。名前に対する既存のバインディングは置き換えられます。

パラメータ:: name - リモートオブジェクトに関連した URL 形式の名前; obj - 名前に関連した新しいリモートオブジェクト
例外:: MalformedURLException - 名前が適切な形式の URL でない場合; RemoteException - レジストリに接続できない場合; AccessException - この操作が許可されていない場合 (たとえば、ローカルではないホストから操作している場合)
導入されたバージョン:: JDK1.1

list

public String[] list()
              throws RemoteException,
                     AccessException

レジストリ内のバインドされている名前の配列を返します。名前は、URL 形式の文字列です。配列には、呼び出しの時点でレジストリに存在する名前のスナップショットを格納します。

戻り値:: レジストリ内のバインドされている名前 (適切な URL 形式) の配列
例外:: RemoteException - レジストリに接続できない場合; AccessException - この操作が許可されていない場合 (たとえば、ローカルではないホストから操作している場合)
導入されたバージョン:: JDK1.1

概要