CORBA ネーム・サービス・リファレンス

bind() メソッドまたは bind_context() メソッドの Name が、ネーミング・コンテキスト内のほかのオブジェクトに既にバインドされていることを示します。

obj

指定した名前にバインドするオブジェクト。

例外

AlreadyBound

指定した Name に 0 名前コンポーネントがあるか、最初の名前コンポーネントのいずれか 1 つがネーミング・コンテキストに対して解決されなかったことを示します。

NotFound

目的のネーミング・コンテキスト名で初期化される Name データ構造体。シーケンス内の最初の NameComponent データ構造体がネーミング・コンテキストに対して解決される必要があります。

説明

bind にバインドされたネーミング・コンテキストは、複数の名前を解決のために渡すときに名前解決に参加しません。

戻り値

特にありません。

CosNaming::NamingContext::bind_context()

概要

このメソッドは、bind() メソッドとほぼ同じですが、指定した Name が NamingContext オブジェクトに関連付けられています。

C++ マッピング

void bind_context(in Name n, in NamingContext nc);

Java マッピング

void bind_context (NameComponent [] n, NamingContext nc);

パラメータ

指定した名前にバインドする NamingContext オブジェクト。

例外

AlreadyBound

bind() メソッドまたは bind_context() メソッドの Name が、ネーミング・コンテキスト内のほかのオブジェクトに既にバインドされていることを示します。

NotFound

NULL コンテキストをバインドするための呼び出しが試行されたことを示します。

BAD_PARAM

説明

bind_context() にバインドされたネーミング・コンテキストは、複数の名前を解決のために渡すときに名前解決に参加しません。

戻り値

特にありません。

CosNaming::NamingContext::bind_new_context()

概要

新しいコンテキストを作成し、コンテキスト内で指定した Name にバインドします。

C++ マッピング

NamingContext bind_new_context(in Name n);

Java マッピング

bind_new_context (NameComponent [] n);

パラメータ

新しく作成された NamingContext オブジェクト名で初期化される Name データ構造体。

例外

AlreadyBound

bind() メソッドまたは bind_context() メソッドの Name が、ネーミング・コンテキスト内のほかのオブジェクトに既にバインドされていることを示します。

NotFound

説明

このメソッドは、CosNaming::NamingContext::new_context() メソッドと CosNaming::NamingContext::bind_context() メソッドを 1 つにまとめたものです。

戻り値

新しい NamingContext オブジェクトに対するリファレンスを返します。

CosNaming::NamingContext::destroy()

概要

NamingContext オブジェクトを削除します。削除した後で NamingContext オブジェクトに対する呼び出しを実行すると、CORBA::NO_IMPLEMENT 例外が発生します。

C++ マッピング

void destroy();

Java マッピング

void destroy();

パラメータ

NamingContext オブジェクトにバインディングがある場合、このメソッドで NotEmpty が発生します。

例外

NotEmpty

説明

このメソッドを使用する前に、 NamingContext オブジェクトにバインドされているすべてのネーム・オブジェクトに対して、CosNaming::NamingContext::unbind() メソッドでアンバウンドする必要があります。

戻り値

特にありません。

CosNaming::NamingContext::list()

概要

このネーミング・コンテキストによって格納されているすべてのバインディングを返します。

C++ マッピング

void list(in unsigned_long how_many, 
    out BindingList bl, 
    out BindingIterator bi);

Java マッピング

void list(int how_many,
BindingListHolder bl,
BindingIteratorHolder bi);

パラメータ

how_many

リストに返されるバインディングの最大数。

返されたバインディングのリスト。各要素は、NameComponent オブジェクトを表す Name を含むバインディングです。それぞれの Name は単純な名前です。つまり、長さ 1 の名前のシーケンスです。リスト内のバインディングの数は、how_many の値を超えません。

残りのバインディングをたどるための BindingIterator オブジェクトに対するリファレンス。

例外

NotFound

説明

このメソッドは、名前のバインディングのシーケンスを返します。bl リストに当てはまるよりも多くの名前のバインディングが存在する場合、BindingIterator オブジェクトが返されます。BindingIterator オブジェクトを使用して、バインディングの次のセットを取得できます。BindingList オブジェクト (C++) または BindingListHolder オブジェクト (Java) は、要求された番号よりも少ないバインディングしかない場合、リストの最後にあるバインディングの番号を返します。bi が NULL リファレンスを返した場合、bl にはすべてのバインディングが含まれています。

戻り値

特にありません。

CosNaming::NamingContext::new_context()

概要

新しいネーミング・コンテキストを作成します。新しく作成されたコンテキストは、最初はどの Name にもバインドされていません。

C++ マッピング

NamingContext new_context();

Java マッピング

NamingContext new_context();

パラメータ

例外

説明

CosNaming::NamingContext::bind_context() メソッドを使用して、新しいネーミング・コンテキストを Name にバインドします。

戻り値

新しいネーミング・コンテキストに対するリファレンスを返します。

CosNaming::NamingContext::rebind()

概要

このメソッドは、bind() メソッドとほぼ同じです。違いは、rebind メソッドでは AlreadyBound 例外が発生しないという点です。指定した Name が既にほかのオブジェクトにバインドされている場合、そのバインディングは新しいバインディングに置き換えられます。

C++ マッピング

void rebind(in Name n, in Object obj);

Java マッピング

void rebind(NameComponent [] n, Object obj);

パラメータ

obj

命名対象のオブジェクト。

例外

指定した Name データ構造体に 0 名前コンポーネントがあるか、最初の名前コンポーネントのいずれか 1 つがネーミング・コンテキストに対して解決されなかったことを示します。

NotFound

Name またはそのコンポーネントのいずれか 1 つが見つからなかったことを示します。バインディングが既に存在しているか、またはバインディングが不正なタイプのものであるために例外が発生した場合、例外の rest_of_name メンバーには長さ 1 があります。

説明

rebind() メソッドにバインドされたネーミング・コンテキストは、複数の名前を解決のために渡すときに名前解決に参加しません。

戻り値

特にありません。

CosNaming::NamingContext::rebind_context()

概要

このメソッドは、bind_context() メソッドとほぼ同じです。違いは、rebind_context メソッドでは AlreadyBound 例外が発生しないという点です。指定した Name が既にほかのオブジェクトにバインドされている場合、そのバインディングは新しいバインディングに置き換えられます。

C++ マッピング

void rebind_context(in Name n, in NamingContext nc);

Java マッピング

void rebind_context(NameComponent [] n, NamingContext nc);

パラメータ

再バインド対象の NamingContext オブジェクト。

例外

名前のコンポーネントがバインディングを識別しなかったか、バインディングのタイプが実行中のオペレーションに対して不正だったことを示します。バインディングが既に存在しているか、またはバインディングが不正なタイプのものであるために例外が発生した場合、例外の rest_of_name メンバーには長さ 1 があります。

NotFound

説明

rebind_context メソッドにバインドされたネーミング・コンテキストは、複数の名前を解決のために渡すときに名前解決に参加しません。

戻り値

特にありません。

CosNaming::NamingContext::resolve()

概要

指定した Name を解決しようとします。

C++ マッピング

Object resolve(in Name n);

Java マッピング

Object resolve (NameComponent n);

パラメータ

例外

名前のコンポーネントがバインディングを識別しなかったか、バインディングのタイプが実行中のオペレーションに対して不正だったことを示します。

NotFound

説明

指定した Name は、オブジェクトのバインドに使用する名前と同じものでなければなりません。CORBA ネーム・サービスは、オブジェクトのタイプを返しません。クライアント・アプリケーションでは、オブジェクトを適切なタイプにナロー変換します。

戻り値

指定した Name のオブジェクト・リファレンスを返します。

CosNaming::NamingContext::unbind()

概要

指定した Name に関連付けられたバインディングを削除し、bind() メソッドとは逆のオペレーションを実行します。

C++ マッピング

void unbind(in Name n);

Java マッピング

void unbind (NameComponent [] n);

パラメータ

例外

NotFound

説明

このメソッドは、名前とオブジェクトの間のバインディングを削除します。オブジェクトは削除されません。オブジェクトを削除するには、CosNaming::NamingContext::unbind() メソッドを使用してから、CosNaming::NamingContext::destroy() メソッドを使用します。

戻り値

特にありません。

NamingContextExt オブジェクト

NamingContextExt オブジェクトは、CORBA ネーム・サービスで URL と文字列化された名前を使用する方法を提供します。NamingContextExt オブジェクトは、NamingContext オブジェクトから派生したものです。CORBA ネーム・サービスのルートは、NamingContextExt オブジェクトです (つまり、ルートは NamingContext オブジェクトでもあります)。NamingContextExt オブジェクトのリファレンスを取得するのに特別なオペレーションは必要ありません。リスト2-2 は、NamingContextExt オブジェクトの OMG IDL を示しています。

コードリスト 2-2 NamingContextExt オブジェクトの OMG IDL

module CosNaming {
	interface NamingContextExt : NamingContext {
		typedef string StringName;
		typedef string Address;
		typedef string URLString;

		StringName to_string(in Name n)
			raises(InvalidName);
		Name to_name(in StringName sn)
			raises(InvalidName);

		exception InvalidAddress {};

		URLString to_url(in Address addr, in StringName sn)
			raises(InvalidAddress, InvalidName);
		Object resolve_str(in StringName n)
			raises(NotFound, 
				CannotProceed, 
				InvalidName,
				AlreadyBound);
	}
}

CosNaming::NamingContextExt::resolve_str()

概要

文字列化された名前を取り、それを Name に変換し、解決します。

構文

object resolve_str(in StringName n);

パラメータ

解決対象の文字列化された名前。

例外

名前が無効であることを示します。長さ 0 の名前は無効です。

NotFound

説明

これは、CosNaming:NamingContext::resolve() メソッドと同じ方法で解決を実行する便利なメソッドです。
メソッドは、文字列化された名前を Name オブジェクトではなく引数として受け付けます。文字列化された名前が不正な場合、または文字列化された名前をバインドできなかった場合、メソッドはエラーを返します。

戻り値

バインドされた名前に対するリファレンス。

CosNaming::NamingContextExt::to_name()

概要

文字列化された名前を取り、Name オブジェクトを返します。

構文

Name to_name(in StringName sn);

パラメータ

Name オブジェクトに対して解決する文字列化された名前。

例外

名前が無効であることを示します。長さ 0 の名前は無効です。

説明

このメソッドは、文字列化された名前を受け付け、Name オブジェクトを返します。名前が不正な場合、メソッドはエラーを返します。

戻り値

Name オブジェクトを返します。

CosNaming::NamingContextExt::to_string()

概要

Name オブジェクトを受け付け、文字列化された名前を返します。

構文

StringName to_string(in Name n);

パラメータ

文字列化された名前に変換する Name オブジェクト。

例外

名前が無効であることを示します。長さ 0 の名前は無効です。

説明

このメソッドは、Name オブジェクトを受け付け、文字列化された名前を返します。名前が不正な場合、メソッドはエラーを返します。

戻り値

文字列化された名前を返します。

CosNaming::NamingContextExt::to_URL()

概要

URL と文字列化された名前を組み合わせ、URL 文字列を返します。

構文

CosNaming::NamingContextExt::to_URL()

URLString to_URL(in Address addr, in StringName sn);

パラメータ

addr

URL。このパラメータが定義されていない場合、IIOP プロトコルでローカル・ホスト名が使用されます。

URL と組み合わせる文字列化された名前。

例外

InvalidAddress

URL が無効であることを示します。

名前が無効であることを示します。長さ 0 の名前は無効です。

戻り値

URL と文字列化された名前を組み合わせた URL 文字列を返します。

BindingIterator オブジェクト

BindingIterator オブジェクトを使用すると、クライアント・アプリケーションは、NamingContext オブジェクトの list メソッドで返されたバインディングのアンバウンディッド・コレクションをたどることができます。
BindingIterator オブジェクトを使用すると、クライアント・アプリケーションは、各呼び出しで取得したバインディング数を制御できます。BindingIterator オブジェクトのメソッドの呼び出しの間にネーミング・コンテキストが変更された場合、以降の next_one() メソッドまたは next_n() メソッドの呼び出しの動作は、インプリメンテーションによって異なります。

BindingIterator オブジェクトを作成しても、destroy メソッドを呼び出さない場合、クライアント・アプリケーションはリソース不足になる場合があります。CORBA ネーム・サービスでは、クライアント・アプリケーションに通知せずに、いつでもバインディング・イテレータを破棄できます。BindingIterator オブジェクトに対する呼び出しで OBJECT_NOT_EXIST 例外を予期し、この例外を適切に処理するようにクライアント・アプリケーションを記述する必要があります。

リスト2-3 は、BindingIterator オブジェクトの OMG IDL を示しています。

コードリスト 2-3 BindingIterator オブジェクトの OMG IDL

module CosNaming {
	interface BindingIterator {
		boolean next_one(out Binding b);
		boolean next_n(in unsigned long how_many,
                             out BindingList b);
		void destroy();
	};
}

CosNaming::BindingIterator::destroy()

概要

BindingIterator オブジェクトを破棄し、オブジェクトに関連付けられているメモリを解放します。このメソッドの呼び出しに失敗すると、メモリの使用量が増加します。

C++ マッピング

void destroy();

Java マッピング

void destroy();

パラメータ

例外