CORBAネーム・サービスの使用

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

ここでは、以下の内容について説明します。

CORBAネーム・サービスのコマンド

CORBAネーム・サービスには、CORBAネーム・サービスのサーバー・プロセスの管理、ネームスペースの名前のバインドとアンバインド、およびネームスペースの内容の表示のための次のコマンドが用意されています。

次の項では、これらのコマンドについて説明します。

cns

形式

CORBAネーム・サービスのサーバー・プロセスを制御します。

構文

cns CLOPT="[-A] [servopts options] --
[-b bucketcount]
[-c]
[-d]
[-f filename]
[-M maxiterators]
[-p [persiststoragefilename] ]"

説明

CORBAネーム・サービスのサーバー・プロセスでは、CORBA CosNaming準拠のネーム・サービスが提供されます。使用するOracle Tuxedoアプリケーションに対して、そのOracle Tuxedoアプリケーションで使用される他のサーバー・プロセスと同様に、CORBAネーム・サービスのサーバー・プロセスとそのオプションをUBBCONFIGファイルで定義する必要があります。UBBCONFIGファイルのCLOPTパラメータの2つのダッシュ(--)の後に、cnsコマンドライン・オプションを入力します。コマンドライン・オプションは次のとおりです。

-b bucketcount

-c

-d

-f filename

-M maxiterators

-p [persistentstoragefilename]

cnsbind

形式

アプリケーション・オブジェクトおよびネーミング・コンテキストをネームスペースにバインドします。

構文

cnsbind
[-C]
[-f root_context_filename]
[-h]
[-N]
[-o ior_filename]
[-r]
[-T TObjAddr]
bind_name

説明

cnsbindコマンドでは、CORBA CosNamingインタフェースを使用して新しいアプリケーション・オブジェクトとネーミング・コンテキスト・オブジェクトをネームスペースにバインドします。このコマンドでは、連合型ネームスペースを簡単に作成できます。cnsbindコマンドの起動時に例外が戻された場合は、コマンドが終了し、対応するメッセージが表示されます。

cnsbindコマンドのコマンドライン・オプションは次のとおりです。

-C

-f root_context_filename

-h

-N

-o ior_filename

-r

-T TObjAddr

bind_name

サンプル

次の例は、アプリケーション・オブジェクトのバインディングを示しています。

cnsbind -o ./app_obj_ior.txt MyContext/AppObject1

次の例は、ネーミング・コンテキストのバインディングを示しています。

cnsbind -N MyContext/CtxObject1

次の例は、別のネームスペースへのフェデレーション・ポイントのバインディングを示しています。

cnsbind -C -o ./remote_ior.txt MyContext/RemoteNSCtx1

cnsls

形式

ネームスペースの内容を表示します。

構文

cnsls
[-f root_context_filename]
[-h]
[-s]
[-R]
[-T TobjAddr]
[resolve_name]

説明

cnslsコマンドでは、CORBA CosNamingインタフェースを使用してネームスペースの内容を表示します。非印字文字がNameComponentデータ構造体の一部として使用されている場合、cnslsコマンドの動作は未定義です。cnslsコマンドの起動時に例外が発生すると、コマンドが終了し、対応するメッセージが表示されます。

cnslsコマンドのコマンドライン・オプションは次のとおりです。

-f root_context_filename

-h

-s

-R

-T TObjAddr

resolve_name

例

cnsls -R MyContext.kind/AnotherContext
[context] MyContext.kind/AnotherContext
[object] Obj1
[object] Obj2
[context] Ctx1
[object] AnotherObject

cnsunbind

形式

ネームスペースのバインディングを解除します。

構文

cnsunbind
[-D]
[-f root_context_filename]
[-h]
[-T TObjAddr]
bind_name

説明

cnsubindコマンドでは、ネームスペースのバインディングを解除します。cnsunbindコマンドの起動時に例外が戻されると、コマンドが終了し、対応するメッセージが表示されます。

cnsunbindコマンドライン・オプションは次のとおりです。

-D

-f root_context_filename

-h

-T TObjAddr

bind_name

サンプル

次の例は、ネームスペースのバインディングの解除を示しています。

cnsunbind MyContext/CtxObject1

次の例は、ネームスペースのバインディングの解除、およびバインドされているオブジェクトの破棄を示しています。

cnsunbind -D MyContext/CtxObject1

CORBAネーム・サービスの機能と制限事項

CORBAネーム・サービスには、次の機能と制限があります。

NameService環境オブジェクトへの初期リファレンスの取得

NameService環境オブジェクトは、ネームスペースのルートへの接続に使用できます。NameService環境オブジェクトを使用する場合、オブジェクト・リクエスト・ブローカ(ORB)がネームスペースのルートをロケートします。BootstrapオブジェクトまたはCORBAインターオペラブル・ネーミング・サービス(INS)のブートストラップ処理メカニズムを使用すると、NameService環境オブジェクトへの初期リファレンスを取得できます。OracleクライアントORBを使用する場合は、Oracle専用のメカニズムを使用します。別のベンダーのクライアントORBを使用する場合は、CORBA INSメカニズムを使用します。

ネームスペースへの接続の詳細は、「ステップ3: Oracle Tuxedoネームスペースに接続する」を参照してください。Oracle Tuxedoドメインのブートストラップ処理の詳細は、Oracle Tuxedoオンライン・ドキュメントの『Oracle Tuxedo CORBAプログラミング・リファレンス』の第4章「CORBAブートストラップ処理のプログラミング・リファレンス」を参照してください。

CORBAネーム・サービスで使用するCosNamingデータ構造体

CORBAネーム・サービスでは、次のCosNamingデータ構造体を使用します。

NamingContextオブジェクト

NamingContextオブジェクトは、オブジェクト・リクエスト・ブローカ(ORB)オブジェクトまたは他のNamingContextオブジェクトにバインドされている名前のリストの格納および操作に使用されます。Oracle Tuxedo CORBAクライアント・アプリケーションは、このインタフェースを使用して、コンテキスト内のすべての名前を解決またはリストします。Oracle Tuxedo CORBAサーバー・アプリケーションでは、このオブジェクトを使用して、名前をアプリケーション・オブジェクトまたはネーミング・コンテキスト・オブジェクトにバインドします。リスト2-1は、NamingContextオブジェクトのOMG IDLを示します。

module CosNaming {
  interface NamingContext {
    void bind(in Name, in Object obj)
       raises(NotFound, CannotProceed, InvalidName, AlreadyBound);
    void rebind(in Name, in Object obj)
        raises(NotFound, CannotProceed, InvalidName);
    void bind_context(in Name n, in NamingContext nc)
        raises(NotFound, CannotProceed, InvalidName, AlreadyBound);
    void rebind_context(in Name n, in NamingContext nc)
        raises(NotFound, CannotProceed, InvalidName);
    Object resolve(in Name n)
        raises(NotFound, CannotProceed, InvalidName);
    void unbind(in Name n)
        raises(NotFound, CannotProceed, InvalidName);
    NamingContext new_context
    NamingContext bind_new_context(in Name n)
        raises(NotFound, CannotProceed, InvalidName, AlreadyBound);
    void destroy()
        raises(NotEmpty);
    void list(in unsigned long how_many,
              out BindingList bl,
              out BindingIterator bi);
    }
}

CosNaming::NamingContext::bind()

形式

最初のNameComponentデータ構造体に関連付けられているコンテキストを解決し、次に新しいコンテキストにオブジェクトをバインドして、指定したオブジェクトを指定の名前にバインドしようとします。

C++マッピング

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

パラメータ

n

obj

例外

AlreadyBound

InvalidName

NotFound

説明

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

戻り値

なし。

CosNaming::NamingContext::bind_context()

形式

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

C++マッピング

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

パラメータ

n

nc

例外

AlreadyBound

InvalidName

NotFound

BAD_PARAM

説明

bind_context()でバインドされているネーミング・コンテキストは、解決するために複合名が渡されるときに名前解決に参加します。

戻り値

なし。

CosNaming::NamingContext::bind_new_context()

形式

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

C++マッピング

NamingContext bind_new_context(in Name n); 

パラメータ

n

例外

AlreadyBound

InvalidName

NotFound

説明

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

戻り値

新しいNamingContextオブジェクトへの参照を戻します。

CosNaming::NamingContext::destroy()

形式

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

C++マッピング

void destroy(); 

パラメータ

なし。

例外

NotEmpty

説明

このメソッドを使用する前に、NamingContext オブジェクトにバインドされているすべてのすべてのネーム・オブジェクトを、
CosNaming::NamingContext::unbind()メソッドを使用してアンバインドしてください。

戻り値

なし。

CosNaming::NamingContext::list()

形式

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

C++マッピング

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

パラメータ

how_many

bl

bi

例外

InvalidName

NotFound

説明

このメソッドでは、名前のバインディングのシーケンスを戻します。blリストに該当するより多くの名前のバインディングが存在する場合は、BindingIteratorオブジェクトが戻されます。BindingIteratorオブジェクトを使用すると、バインディングの次のセットを取得できます。BindingList (C++)オブジェクトでは、リクエストされた番号のバインディングがリストの最後にある場合は、その番号よりも小さい番号のバインディングを戻すことができます。biでNULL参照が戻された場合、blにはすべてのバインディングが格納されています。

戻り値

なし。

CosNaming::NamingContext::new_context()

形式

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

C++マッピング

NamingContext new_context(); 

パラメータ

なし。

例外

なし。

説明

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

戻り値

新しいネーミング・コンテキストへの参照を戻します。

CosNaming::NamingContext::rebind()

形式

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

C++マッピング

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

パラメータ

n

obj

例外

InvalidName

NotFound

説明

rebind()でバインドされているネーミング・コンテキストは、解決するために複合名が渡されるときに名前解決に参加しません。

戻り値

なし。

CosNaming::NamingContext::rebind_context()

形式

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

C++マッピング

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

パラメータ

n

nc

例外

InvalidName

NotFound

説明

rebind_contextでバインドされているネーミング・コンテキストは、解決するために複合名が渡されるときに名前解決に参加しません。

戻り値

なし。

CosNaming::NamingContext::resolve()

形式

指定したNameの解決を試みます。

C++マッピング

Object resolve(in Name n); 

パラメータ

n

例外

InvalidName

NotFound

説明

指定したNameは、オブジェクトのバインドに使用される名前と正確に一致する必要があります。CORBAネーム・サービスでは、オブジェクトの型を戻しません。オブジェクトを適切な型にナロー変換する操作は、クライアント・アプリケーションで実行します。

戻り値

指定したNameのオブジェクト参照を戻します。

CosNaming::NamingContext::unbind()

形式

bind()メソッドの逆演算を実行し、指定したNameに関連付けられたバインディングを削除します。

C++マッピング

void unbind(in Name n); 

パラメータ

n

例外

InvalidName

NotFound

説明

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

戻り値

なし。

NamingContextExtオブジェクト

NamingContextExtオブジェクトでは、CORBAネーム・サービスのURLおよび文字列化された名前を使用するための方法が提供されます。NamingContextExtオブジェクトは、NamingContextオブジェクトから派生したものです。CORBAネーム・サービスのルートはNamingContextExtオブジェクト(ルートはNamingContextオブジェクトでもあります)であることに注意してください。NamingContextExtオブジェクトへの参照を取得するのに特別な操作は必要ありません。リスト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);

パラメータ

n

例外

InvalidName

NotFound

説明

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

戻り値

バインドされた名前への参照。

CosNaming::NamingContextExt::to_name()

形式

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

構文

Name to_name(in StringName sn);

パラメータ

sn

例外

InvalidName

説明

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

戻り値

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

CosNaming::NamingContextExt::to_string()

形式

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

構文

StringName to_string(in Name n);

パラメータ

n

例外

InvalidName

説明

このメソッドでは、Nameを受け付け、文字列化された名前を戻します。名前が無効の場合は、エラーが戻されます。

戻り値

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

CosNaming::NamingContextExt::to_URL()

形式

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

構文

CosNaming::NamingContextExt::to_URL()

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

パラメータ

addr

sn

例外

InvalidAddress

URLが無効です。

InvalidName

名前が無効です。長さがゼロの名前は無効です。

戻り値

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

BindingIteratorオブジェクト

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

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

リスト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();

パラメータ

なし。

例外

なし。

説明

destroyメソッドの呼出し後にクライアント・アプリケーションがBindingIteratorオブジェクトに対する操作を呼び出すと、OBJECT_NOT_EXIST 例外が発生します。

戻り値

なし。

CosNaming::BindingIterator::next_n()

形式

リストからリクエストされたバインディングの番号を格納するBindingListデータ構造体を戻します。戻されるバインディングの番号は、リクエストされた数がリストを超えている場合は、それよりも少なくなります。

C++マッピング

boolean next_n(in unsigned_long how_many, out BindingList bl); 

パラメータ

how_many

bl

例外

BAD_PARAM

戻り値

リストの上限に達した場合にCORBA::FALSEが戻されます。それ以外の場合は、CORBA::TRUEが戻されます。

CosNaming::BindingIterator::next_one()

形式

リスト内の次のBindingオブジェクトを戻します。

C++マッピング

boolean next_one(out Binding b); 

パラメータ

b

例外

なし。

戻り値

リストの上限に達した場合にCORBA::FALSEが戻されます。それ以外の場合は、CORBA::TRUEが戻されます。

CORBAネーム・サービスで発生する例外

この項では、CORBAネーム・サービスで発生する例外について説明します。

AlreadyBound

構文

exception AlreadyBound{}; 

パラメータ

なし。

説明

この例外は、指定した名前にオブジェクトがすでにバインドされている場合に発生します。1つのコンテキストで名前にバインドできるオブジェクトは1つのみです。

CannotProceed

構文

exception CannotProceed{};

パラメータ

NamingContext cxt

Name rest_of_name

説明

この例外は、予期しない例外が発生して、メソッドで適切に処理できない場合に発生します。

InvalidAddress

構文

exception InvalidAddress{};

パラメータ

なし。

説明

この例外は、URLが無効の場合に発生します。

InvalidName

構文

exception InvalidName{};

パラメータ

なし。

説明

この例外は、Nameが無効の場合に発生します。長さがゼロの名前は無効です。

NotEmpty

構文

exception NotEmpty{};

パラメータ

なし。

説明

この例外は、バインディングを含むNamingContextオブジェクトでdestroy()メソッドが使用されている場合に発生します。NamingContextオブジェクトは、破棄する前に空になっている必要があります。

NotFound

構文

exception NotFound{NotFoundReason why; Name rest_of_name;};

パラメータ

why

rest_of_name

説明

この例外は、名前のコンポーネントでバインディングを識別しないか、バインディングの型が実行中の操作に対して間違っている場合に発生します。whyパラメータはエラーの理由を示します。rest_of_nameパラメータはエラーの原因を示します。次の原因が表示されます。