ページの先頭行へ戻る
Interstage Application Server リファレンスマニュアル(API編)

3.16.1 ネーミングコンテキストインタフェース

3.16.1.1 org.omg.CosNaming.NamingContext.bind()

名前

  org.omg.CosNaming.NamingContext.bind

形式

public void bind(org.omg.CosNaming.NameComponent[] n,
      org.omg.CORBA.Object obj) throws
org.omg.CosNaming.NamingContextPackage.NotFound,
org.omg.CosNaming.NamingContextPackage.CannotProceed,
org.omg.CosNaming.NamingContextPackage.InvalidName,
org.omg.CosNaming.NamingContextPackage.AlreadyBound;

機能説明

  nで指定された名前と、objで指定されたオブジェクトリファレンスを作成し、対象のネーミングコンテキストに登録します。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

パラメタ

  n

  名前(NameComponentオブジェクトの配列として指定)。

  obj

  指定した名前とバインドするオブジェクトリファレンス

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CosNaming.NamingContextPackage.AlreadyBound

  指定された名前とオブジェクトのバインディングがすでに存在します。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.2 org.omg.CosNaming.NamingContext.rebind()

名前

  org.omg.CosNaming.NamingContext.rebind

形式

public void rebind(org.omg.CosNaming.NameComponent[] n,
      org.omg.CORBA.Object obj) throws
org.omg.CosNaming.NamingContextPackage.NotFound,
org.omg.CosNaming.NamingContextPackage.CannotProceed,
org.omg.CosNaming.NamingContextPackage.InvalidName;

機能説明

  nで指定された名前と、objで指定されたオブジェクトリファレンスのバインディングを作成し、対象のネーミングコンテキストに登録します。指定された名前のバインディングがすでに存在してもエラーにはなりません。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

パラメタ

  n

  名前(NameComponentオブジェクトの配列として指定)。

  obj

  指定した名前とバインドするオブジェクトリファレンス

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.3 org.omg.CosNaming.NamingContext.bind_context()

名前

  org.omg.CosNaming.NamingContext.bind_context

形式

public void bind_context(org.omg.CosNaming.NameComponent[] n,
      org.omg.CosNaming.NamingContext nc)throws
org.omg.CosNaming.NamingContextPackage.NotFound,
org.omg.CosNaming.NamingContextPackage.CannotProceed,
org.omg.CosNaming.NamingContextPackage.InvalidName,
org.omg.CosNaming.NamingContextPackage.AlreadyBound;

機能説明

  nで指定した名前と、ncで指定したネーミングコンテキストのオブジェクトリファレンスのバインディングを作成し、対象のネーミングコンテキストに登録します。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録します。

パラメタ

  n

  ネーミングコンテキストオブジェクトとバインドする名前(NameComponentオブジェクトの配列で指定)

  nc

  登録するネーミングコンテキストオブジェクト

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CosNaming.NamingContextPackage.AlreadyBound

  指定された名前とオブジェクトのバインディングがすでに存在します。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

  ncには、登録先のネーミングサービスのオブジェクトリファレンス、および登録先のネーミングサービスにすでに登録されているネーミングコンテキストのオブジェクトリファレンスを指定しないでください。

3.16.1.4 org.omg.CosNaming.NamingContext.rebind_context()

名前

  org.omg.CosNaming.NamingContext.rebind_context

形式

public void rebind_context(org.omg.CosNaming.NameComponent[] n,
                           org.omg.CosNaming.NamingContext nc)throws
org.omg.CosNaming.NamingContextPackage.NotFound,
org.omg.CosNaming.NamingContextPackage.CannotProceed,
org.omg.CosNaming.NamingContextPackage.InvalidName;

機能説明

  nで指定した名前と、ncで指定したネーミングコンテキストのオブジェクトリファレンスのバインディングを作成し、対象のネーミングコンテキストに登録します。指定した名前のバインディングがすでに存在してもエラーにはなりません。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。

パラメタ

  n

  ネーミングコンテキストオブジェクトとバインドする名前(NameComponentオブジェクトの配列で指定)

  nc

  登録するネーミングコンテキストオブジェクト

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

  ncには、登録先のネーミングサービスのオブジェクトリファレンス、および登録先のネーミングサービスにすでに登録されているネーミングコンテキストのオブジェクトリファレンスを指定しないでください。

3.16.1.5 org.omg.CosNaming.NamingContext.resolve()

名前

  org.omg.CosNaming.NamingContext.resolve

形式

public org.omg.CORBA.Object  resolve( org.omg.CosNaming.NameComponent[] n )
throws org.omg.CosNaming.NamingContextPackage.NotFound,
      org.omg.CosNaming.NamingContextPackage.CannotProceed,
      org.omg.CosNaming.NamingContextPackage.InvalidName;

機能説明

  ネーミングコンテキスト中で、nに指定された名前と結合されているオブジェクトリファレンスを返します。

パラメタ

  n

  オブジェクト名が設定されているNameComponentオブジェクト

復帰値

  正常終了した場合は、オブジェクトリファレンスが通知されます。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定した名前が見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.6 org.omg.CosNaming.NamingContext.unbind()

名前

  org.omg.CosNaming.NamingContext.unbind

形式

  public void unbind(org.omg.CosNaming.NameComponent[] n)throws
    org.omg.CosNaming.NamingContextPackage.NotFound,
    org.omg.CosNaming.NamingContextPackage.CannotProceed,
    org.omg.CosNaming.NamingContextPackage.InvalidName;

機能説明

  ネーミングコンテキストから、nで指定された名前のバインディングを削除します。

パラメタ

  n

  ネーミングコンテキストからバインディングを削除する名前(NameComponentオブジェクトの配列として指定)。

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.7 org.omg.CosNaming.NamingContext.new_context()

名前

  org.omg.CosNaming.NamingContext.new_context

形式

  public NamingContext new_context();

機能説明

  対象のネーミングコンテキストを管理するネーミングサーバ内に、新しいネーミングコンテキストを作成し、作成されたネーミングコンテキストのオブジェクトリファレンスを返します。

復帰値

  正常終了した場合は、作成されたネーミングコンテキストのオブジェクトリファレンスが返されます。
  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

注意事項

3.16.1.8 org.omg.CosNaming.NamingContext.bind_new_context()

名前

  org.omg.CosNaming.NamingContext.bind_new_context

形式

  public org.omg.CosNaming.NamingContext
  bind_new_context(org.omg.CosNaming.NameComponent[] n)throws
    org.omg.CosNaming.NamingContextPackage.NotFound,
    org.omg.CosNaming.NamingContextPackage.AlreadyBound,
    org.omg.CosNaming.NamingContextPackage.CannotProceed,
    org.omg.CosNaming.NamingContextPackage.InvalidName;

機能説明

  新しいネーミングコンテキストを作成し、そのオブジェクトリファレンスとnで指定された名前のバインディングを作成し、対象のネーミングコンテキストに登録します。復帰値として、新しいネーミングコンテキストのオブジェクトリファレンスを返します。nがコンパウンドネームである場合、バインディングはコンパウンドネーム中で最後に指定されたネーミングコンテキストに登録されます。
新しいネーミングコンテキストは、名前の登録が行われたネーミングコンテキストを管理するネーミングサーバ内に作成されます。

パラメタ

  n

  新しいネーミングコンテキストのオブジェクトリファレンスとバインドする名前(NameComponentオブジェクトの配列として指定)。

復帰値

  正常終了した場合は、生成された新しいネーミングコンテキストのオブジェクトリファレンスが返されます。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotFound

  nで指定したネーミングコンテキストが見つかりません。

  org.omg.CosNaming.NamingContextPackage.CannotProceed

  ネーミングコンテキストが存在しません。

  org.omg.CosNaming.NamingContextPackage.InvalidName

  名前の指定に誤りがあります。

  org.omg.CosNaming.NamingContextPackage.AlreadyBound

  指定された名前とオブジェクトのバインディングがすでに存在します。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.9 org.omg.CosNaming.NamingContext.destroy()

名前

  org.omg.CosNaming.NamingContext.destroy

形式

public void  destroy()
         throws org.omg.CosNaming.NamingContextPackage.NotEmpty;

機能説明

  ネーミングコンテキストを削除します。

復帰値

  正常終了した場合は、ありません。
  異常終了した場合は、以下の例外が発生します。

  org.omg.CosNaming.NamingContextPackage.NotEmpty

  ネーミングコンテキスト内にバインディングが存在します。

  org.omg.CORBA.SystemException

  その他の要因。

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。

3.16.1.10 org.omg.CosNaming.NamingContext.list()

名前

  org.omg.CosNaming.NamingContext.list()

形式

public void  list( int how_many,
      org.omg.CosNaming.BindingListHolder bl,
      org.omg.CosNaming.BindingIteratorHolder bi );

機能説明

  ネーミングコンテキスト中のバインディングのリストを、最大でhow_manyで指定された個数分返します。how_manyで指定された値が、nsconfigファイルのbl_how_manyパラメタで設定されている最大バインディング数より大きい場合、ネーミングサービスは最大bl_how_manyパラメタで指定された個数分のバインディングを返します。how_manyに0が設定された場合、クライアントはバインディングにアクセスするためのbiと、長さ0のシーケンスのblを返します。
  リストはblで指定されたorg.omg.CosNaming.BindingListHolderに設定されます。ネーミングコンテキスト内のバインディングの数がhow_manyで指定された数よりも多い場合、ネーミングコンテキスト内での現在の位置を示すオブジェクトが生成され、このオブジェクトリファレンスがbiに返されます。このオブジェクトをバインディングアイテレータといいます。biに返されたオブジェクトリファレンスは、org.omg.CosNaming.BindingIterator.next_oneおよびorg.omg.CosNaming.BindingIterator.next_nの呼び出し時に使用します。

パラメタ

  how_many

  獲得したいバインディングリストの個数

  bl

  バインディングリストの設定領域

  bi

  バインディングアイテレータの設定領域

復帰値

  正常終了した場合は、blにリストオブジェクトリファレンスが設定されます。
  異常終了した場合は、以下の例外が発生します。
    org.omg.CORBA.SystemException

  システム例外発生時に設定された例外情報およびマイナーコードの意味については、“メッセージ集”の“CORBAサービスから通知される例外情報/マイナーコード”を参照してください。