java.rmi.Naming

public final class Naming extends Object

Namingクラスは、リモート・オブジェクト・レジストリ内のリモート・オブジェクトへの参照を取得および格納するためのメソッドを提供します。 Namingクラスの各メソッドは、その引数の1つとして、次のようなjava.lang.String型のURL形式(ただしスキーム・コンポーネントは除く)の名前をとります。

    //host:port/name

hostはレジストリのある(リモートまたはローカル)ホスト、portはレジストリが呼出しを受け入れるポート番号、nameはレジストリによって解釈されない単純な文字列です。 hostおよびportの指定はオプションです。 hostを省略すると、デフォルトでローカル・ホストが使われます。 portを省略すると、ポートはデフォルトで1099になります。これは、RMIのレジストリrmiregistryが使う「よく知られた」ポートです。

リモート・オブジェクトの名前のバインディングとは、あとでこのリモート・オブジェクトを検索して使うことができるように、リモート・オブジェクトに名前を関連付ける、あるいは登録することをいいます。 Namingクラスのbindメソッドまたはrebindメソッドを使って、リモート・オブジェクトを名前と関連付けることができます。

リモート・オブジェクトがローカル・ホストでRMIレジストリに登録(バインディング)されると、リモート(またはローカル)ホストの呼出し側は名前でリモート・オブジェクトを参照し、その参照を取得し、そのオブジェクトでリモート・メソッドを呼び出すことができます。レジストリはホストで動作しているすべてのサーバーで共有でき、必要な場合は、個々のサーバー・プロセスが独自のレジストリを作成および使用することもできます。詳細は、java.rmi.registry.LocateRegistry.createRegistryメソッドを参照してください。

導入されたバージョン:

1.1

関連項目:

メソッドのサマリー

修飾子と型

メソッド

説明

static void

bind(String name, Remote obj)

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

static String[]

list(String name)

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

static Remote

lookup(String name)

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

static void

rebind(String name, Remote obj)

指定された名前を新しいリモート・オブジェクトにバインドし直します。

static void

unbind(String name)

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

クラスjava.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

メソッドの詳細
- lookup
  
  public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
  
  指定されたnameに関連したリモート・オブジェクトの参照(スタブ)を返します。
  
  パラメータ:
  
  name - URL形式の名前(ただしスキーム・コンポーネントは除く)
  
  戻り値:
  
  リモート・オブジェクトの参照
  
  例外:
  
  NotBoundException - 名前がバインドされていない場合
  
  RemoteException - レジストリに接続できない場合
  
  AccessException - この操作が許可されていない場合
  
  MalformedURLException - 名前が適切な形式のURLでない場合
  
  導入されたバージョン:
  
  1.1
- bind
  
  public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
  
  指定されたnameをリモート・オブジェクトにバインドします。
  
  パラメータ:
  
  name - URL形式の名前(ただしスキーム・コンポーネントは除く)
  
  obj - リモート・オブジェクトの参照(通常はスタブ)
  
  例外:
  
  AlreadyBoundException - 名前がすでにバインドされている場合
  
  MalformedURLException - 名前が適切な形式のURLでない場合
  
  RemoteException - レジストリに接続できない場合
  
  AccessException - この操作が許可されていない場合(たとえば、ローカルではないホストから操作している場合)
  
  導入されたバージョン:
  
  1.1
- unbind
  
  public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
  
  リモート・オブジェクトに関連した指定された名前に対するバインディングを破棄します。
  
  パラメータ:
  
  name - URL形式の名前(ただしスキーム・コンポーネントは除く)
  
  例外:
  
  NotBoundException - 名前がバインドされていない場合
  
  MalformedURLException - 名前が適切な形式のURLでない場合
  
  RemoteException - レジストリに接続できない場合
  
  AccessException - この操作が許可されていない場合(たとえば、ローカルではないホストから操作している場合)
  
  導入されたバージョン:
  
  1.1
- rebind
  
  public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
  
  指定された名前を新しいリモート・オブジェクトにバインドし直します。名前に対する既存のバインディングは置き換えられます。
  
  パラメータ:
  
  name - URL形式の名前(ただしスキーム・コンポーネントは除く)
  
  obj - 名前に関連付ける新しいリモート・オブジェクト
  
  例外:
  
  MalformedURLException - 名前が適切な形式のURLでない場合
  
  RemoteException - レジストリに接続できない場合
  
  AccessException - この操作が許可されていない場合(たとえば、ローカルではないホストから操作している場合)
  
  導入されたバージョン:
  
  1.1
- list
  
  public static String[] list(String name) throws RemoteException, MalformedURLException
  
  レジストリ内のバインドされている名前の配列を返します。名前は、URL形式(ただしスキーム・コンポーネントは除く)の文字列です。配列には、呼出しの時点でレジストリに存在する名前のスナップショットを格納します。
  
  パラメータ:
  
  name - URL形式のレジストリ名(ただしスキーム・コンポーネントは除く)
  
  戻り値:
  
  レジストリ内のバインドされている名前(適切な形式)の配列
  
  例外:
  
  MalformedURLException - 名前が適切な形式のURLでない場合
  
  RemoteException - レジストリに接続できない場合。
  
  導入されたバージョン:
  
  1.1

クラスNaming

メソッドのサマリー

クラスjava.lang.Objectで宣言されたメソッド

メソッドの詳細

lookup

bind

unbind

rebind

list