JavaTM 2
Platform
Std. Ed. v1.4.0

org.omg.CosNaming
クラス _NamingContextExtStub

java.lang.Object
  |
  +--org.omg.CORBA.portable.ObjectImpl
        |
        +--org.omg.CosNaming._NamingContextExtStub
すべての実装インタフェース:
IDLEntity, NamingContext, NamingContextExt, NamingContextExtOperations, NamingContextOperations, Object, Serializable

public class _NamingContextExtStub
extends ObjectImpl
implements NamingContextExt

NamingContextExt は、それぞれの名前が固有で Interoperable Naming Service の一部である名前バインディングのセットを格納する NamingContext の拡張です。異なる名前を、同じコンテキストまたは異なるコンテキストのオブジェクトに同時にバインドできます。NamingContextExt を使用すると、URL ベースの名前を使用してバインドおよび解決が可能になります。

「CORBA COS Naming Specification」 を参照してください。


コンストラクタの概要
_NamingContextExtStub()
           
 
メソッドの概要
 String[] _ids()
          この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。
 void bind_context(NameComponent[] n, NamingContext nc)
          ネーミングコンテキストであるオブジェクトの名前を指定します。
 NamingContext bind_new_context(NameComponent[] n)
          コンテキストを新しく作成し、引数として指定された名前にそのコンテキストをバインドします。
 void bind(NameComponent[] n, Object obj)
          ネーミングコンテキストに名前とオブジェクトのバインディングを作成します。
 void destroy()
          destroy はネーミングコンテキストを削除します。
 void list(int how_many, BindingListHolder bl, BindingIteratorHolder bi)
          list を使用すると、クライアントはネーミングコンテキスト内の一連のバインディングを次々に取得することができます。
 NamingContext new_context()
          呼び出し側のコンテキストと同じネームサーバによって実装されるネーミングコンテキストを返します。
 void rebind_context(NameComponent[] n, NamingContext nc)
          名前がすでにコンテキストでバインドされている場合でも、ネーミングコンテキストに名前とネーミングコンテキストのバインディングを作成します。
 void rebind(NameComponent[] n, Object obj)
          名前がすでにコンテキストでバインドされている場合でも、ネーミングコンテキストに名前とオブジェクトのバインディングを作成します。
 Object resolve_str(String sn)
          文字列化された名前をオブジェクト参照に解決します。
 Object resolve(NameComponent[] n)
          resolve は、指定されたコンテキストで名前にバインドされているオブジェクトを取得します。
 NameComponent[] to_name(String sn)
          文字列化された名前を、等価な名前コンポーネントの配列に変換します。
 String to_string(NameComponent[] n)
          名前コンポーネントの配列から文字列に変換された名前を作成します。
 String to_url(String addr, String sn)
          オブジェクトの文字列化された名前から URL ベースの "iiopname://" 形式の名前を作成します。
 void unbind(NameComponent[] n)
          unbind は、コンテキストからネームバインディングを削除します。
 
クラス org.omg.CORBA.portable.ObjectImpl から継承したメソッド
_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString
 
クラス java.lang.Object から継承したメソッド
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 
インタフェース org.omg.CORBA.Object から継承したメソッド
_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override
 

コンストラクタの詳細

_NamingContextExtStub

public _NamingContextExtStub()
メソッドの詳細

to_string

public String to_string(NameComponent[] n)
                 throws InvalidName
名前コンポーネントの配列から文字列に変換された名前を作成します。

定義:
インタフェース NamingContextExtOperations 内の to_string
パラメータ:
n - オブジェクトの名前

例外:
org.omg.CosNaming.NamingContextExtPackage.InvalidName - 名前でバインディングが識別できない場合

InvalidName

to_name

public NameComponent[] to_name(String sn)
                        throws InvalidName
文字列化された名前を、等価な名前コンポーネントの配列に変換します。

定義:
インタフェース NamingContextExtOperations 内の to_name
パラメータ:
sn - オブジェクトの文字列化された名前

例外:
org.omg.CosNaming.NamingContextExtPackage.InvalidName - 名前でバインディングが識別できない場合

InvalidName

to_url

public String to_url(String addr,
                     String sn)
              throws InvalidAddress,
                     InvalidName
オブジェクトの文字列化された名前から URL ベースの "iiopname://" 形式の名前を作成します。

定義:
インタフェース NamingContextExtOperations 内の to_url
パラメータ:
addr - ネームサービスを実行するホストマシンのインターネットベースアドレス

sn - オブジェクトの文字列化された名前

例外:
org.omg.CosNaming.NamingContextExtPackage.InvalidName - 名前でバインディングが識別できない場合

org.omg.CosNaming.NamingContextPackage.InvalidAddress - ホストマシンのインターネットベースアドレスが正しくない場合

InvalidAddress
InvalidName

resolve_str

public Object resolve_str(String sn)
                   throws NotFound,
                          CannotProceed,
                          InvalidName
文字列化された名前をオブジェクト参照に解決します。

定義:
インタフェース NamingContextExtOperations 内の resolve_str
パラメータ:
sn - オブジェクトの文字列化された名前

例外:
NotFound - 指定された名前のオブジェクト参照が存在しない場合

CannotProceed - 指定された複合名が正しくない場合

org.omg.CosNaming.NamingContextExtPackage.InvalidName - 名前でバインディングが識別できない場合

InvalidName

bind

public void bind(NameComponent[] n,
                 Object obj)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound
ネーミングコンテキストに名前とオブジェクトのバインディングを作成します。名前解決において複合名が渡された場合、bind を使ってバインドされているネーミングコンテキストは、名前解決には加わりません。

定義:
インタフェース NamingContextOperations 内の bind
パラメータ:
n - オブジェクトの名前

obj - 指定された名前にバインドされる Object

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合

AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合


bind_context

public void bind_context(NameComponent[] n,
                         NamingContext nc)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound
ネーミングコンテキストであるオブジェクトの名前を指定します。名前解決において複合名が渡された場合、bind_context() を使ってバインドされているネーミングコンテキストは、名前解決に加わります。

定義:
インタフェース NamingContextOperations 内の bind_context
パラメータ:
n - オブジェクトの名前

nc - 指定された名前にバインドされる NamingContect オブジェクト

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合

AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合


rebind

public void rebind(NameComponent[] n,
                   Object obj)
            throws NotFound,
                   CannotProceed,
                   InvalidName
名前がすでにコンテキストでバインドされている場合でも、ネーミングコンテキストに名前とオブジェクトのバインディングを作成します。名前解決において複合名が渡された場合、rebind を使ってバインドされているネーミングコンテキストは、名前解決に加わりません。

定義:
インタフェース NamingContextOperations 内の rebind
パラメータ:
n - オブジェクトの名前

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合


rebind_context

public void rebind_context(NameComponent[] n,
                           NamingContext nc)
                    throws NotFound,
                           CannotProceed,
                           InvalidName
名前がすでにコンテキストでバインドされている場合でも、ネーミングコンテキストに名前とネーミングコンテキストのバインディングを作成します。名前解決において複合名が渡された場合、rebind_context() を使ってバインドされているネーミングコンテキストは名前解決に加わります。

定義:
インタフェース NamingContextOperations 内の rebind_context
パラメータ:
n - オブジェクトの名前

nc - 指定された名前に再バインドされる NamingContect オブジェクト

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合


resolve

public Object resolve(NameComponent[] n)
               throws NotFound,
                      CannotProceed,
                      InvalidName
resolve は、指定されたコンテキストで名前にバインドされているオブジェクトを取得します。指定された名前は、バインドされた名前と完全に一致している必要があります。ネームサービスは、オブジェクトの型を返しません。適切な型へのオブジェクトのナロー変換は、クライアント側で行う必要があります。つまり、通常クライアントは、Object から返されたオブジェクトをより特殊化されたインタフェースにキャストします。

定義:
インタフェース NamingContextOperations 内の resolve
パラメータ:
n - オブジェクトの名前

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合


unbind

public void unbind(NameComponent[] n)
            throws NotFound,
                   CannotProceed,
                   InvalidName
unbind は、コンテキストからネームバインディングを削除します。

定義:
インタフェース NamingContextOperations 内の unbind
パラメータ:
n - オブジェクトの名前

例外:
NotFound - 名前でバインディングが識別できない場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合


list

public void list(int how_many,
                 BindingListHolder bl,
                 BindingIteratorHolder bi)
list を使用すると、クライアントはネーミングコンテキスト内の一連のバインディングを次々に取得することができます。

list は、バインディングリスト bl 内の、指定された数を最大数としてバインディングを返します。

定義:
インタフェース NamingContextOperations 内の list
パラメータ:
how_many - 返されるバインディングの最大数

bl - 返されるバインディングのリスト

bi - 返されるバインディング反復子


new_context

public NamingContext new_context()
呼び出し側のコンテキストと同じネームサーバによって実装されるネーミングコンテキストを返します。新しいコンテキストはどの名前にもバインドされていません。

定義:
インタフェース NamingContextOperations 内の new_context

bind_new_context

public NamingContext bind_new_context(NameComponent[] n)
                               throws NotFound,
                                      AlreadyBound,
                                      CannotProceed,
                                      InvalidName
コンテキストを新しく作成し、引数として指定された名前にそのコンテキストをバインドします。新しく作成されたコンテキストは、バインドされたコンテキストと同じネームサーバによって実装されます。つまり、最後のコンポーネントを除いた、名前引数によって示されるコンテキストを実装するネームサーバです。

定義:
インタフェース NamingContextOperations 内の bind_new_context
パラメータ:
n - オブジェクトの名前

例外:
NotFound - 名前でバインディングが識別できない場合

AlreadyBound - 指定された名前にオブジェクトがすでにバインドされている場合

CannotProceed - なんらかの理由により実装が中止された場合。ただしクライアントは、返されたネーミングコンテキストで処理を続行できる場合もある

InvalidName - 名前が無効な場合


destroy

public void destroy()
             throws NotEmpty
destroy はネーミングコンテキストを削除します。ネーミングコンテキストにバインディングがある場合は、NotEmpty 例外がスローされます。

定義:
インタフェース NamingContextOperations 内の destroy
例外:
NotEmpty - Naming Context にバインディングがある場合

_ids

public String[] _ids()
クラス ObjectImpl の記述:
この ObjectImpl オブジェクトがサポートするリポジトリ識別子を含む文字列配列を取得します。たとえばスタブの場合、このメソッドはスタブがサポートするすべてのインタフェースに関する情報を返します。

定義:
クラス ObjectImpl 内の _ids
戻り値:
この ObjectImpl のインスタンスがサポートするすべてのリポジトリ識別子の配列

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.