org.omg.CosNaming

クラス_NamingContextExtStub

java.lang.Object

org.omg.CORBA.portable.ObjectImpl

org.omg.CosNaming._NamingContextExtStub

すべての実装されたインタフェース:

Serializable, Object, IDLEntity, NamingContext, NamingContextExt, NamingContextExtOperations, NamingContextOperations

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

名前コンポーネントの配列から文字列に変換された名前を作成します。

定義:

to_string、インタフェース: NamingContextExtOperations

パラメータ:

n - オブジェクトの名前

例外:

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

InvalidName

to_name

public NameComponent[] to_name(String sn)
                        throws InvalidName

文字列化された名前を、等価な名前コンポーネントの配列に変換します。

定義:

to_name、インタフェース: NamingContextExtOperations

パラメータ:

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

例外:

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

InvalidName

to_url

public String to_url(String addr,
                     String sn)
              throws InvalidAddress,
                     InvalidName

オブジェクトの文字列化された名前からURLベースの「iiopname://」形式の名前を作成します。

定義:

to_url、インタフェース: NamingContextExtOperations

パラメータ:

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

文字列化された名前をオブジェクト参照に解決します。

定義:

resolve_str、インタフェース: NamingContextExtOperations

パラメータ:

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

例外:

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

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

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

InvalidName

bind

public void bind(NameComponent[] n,
                 Object obj)
          throws NotFound,
                 CannotProceed,
                 InvalidName,
                 AlreadyBound

ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。名前解決において複合名が渡された場合、bindを使用してバインドされているネーミング・コンテキストは、名前解決には加わりません。

定義:

bind、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

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

例外:

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

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

InvalidName - 名前が無効な場合。

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

bind_context

public void bind_context(NameComponent[] n,
                         NamingContext nc)
                  throws NotFound,
                         CannotProceed,
                         InvalidName,
                         AlreadyBound

ネーミング・コンテキストであるオブジェクトの名前を指定します。名前解決において複合名が渡された場合、bind_context()を使用してバインドされているネーミング・コンテキストは、名前解決に加わります。

定義:

bind_context、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

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

例外:

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

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

InvalidName - 名前が無効な場合。

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

rebind

public void rebind(NameComponent[] n,
                   Object obj)
            throws NotFound,
                   CannotProceed,
                   InvalidName

名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とオブジェクトのバインディングを作成します。名前解決において複合名が渡された場合、rebindを使用してバインドされているネーミング・コンテキストは、名前解決に加わりません。

定義:

rebind、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

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

例外:

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

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

InvalidName - 名前が無効な場合。

rebind_context

public void rebind_context(NameComponent[] n,
                           NamingContext nc)
                    throws NotFound,
                           CannotProceed,
                           InvalidName

名前がすでにコンテキストでバインドされている場合でも、ネーミング・コンテキストに名前とネーミング・コンテキストのバインディングを作成します。名前解決において複合名が渡された場合、rebind_context()を使用してバインドされているネーミング・コンテキストは名前解決に加わります。

定義:

rebind_context、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

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

例外:

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

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

InvalidName - 名前が無効な場合。

resolve

public Object resolve(NameComponent[] n)
               throws NotFound,
                      CannotProceed,
                      InvalidName

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

定義:

resolve、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

例外:

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

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

InvalidName - 名前が無効な場合。

unbind

public void unbind(NameComponent[] n)
            throws NotFound,
                   CannotProceed,
                   InvalidName

unbindは、コンテキストからネーム・バインディングを削除します。

定義:

unbind、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

例外:

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

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

InvalidName - 名前が無効な場合。

list

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

listを使用すると、クライアントはネーミング・コンテキスト内の一連のバインディングを次々に取得することができます。

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

• ネーミング・コンテキストに余分なバインディングがある場合、listは余分なバインディングのバインディング・イテレータを返す。
• ネーミング・コンテキストに余分なバインディングがない場合、バインディング・イテレータはnilのオブジェクト参照。

定義:

list、インタフェース: NamingContextOperations

パラメータ:

how_many - 返されるバインディングの最大数

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

bi - 返されるバインディング・イテレータ

new_context

public NamingContext new_context()

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

定義:

new_context、インタフェース: NamingContextOperations

bind_new_context

public NamingContext bind_new_context(NameComponent[] n)
                               throws NotFound,
                                      AlreadyBound,
                                      CannotProceed,
                                      InvalidName

コンテキストを新しく作成し、引数として指定された名前にそのコンテキストをバインドします。新しく作成されたコンテキストは、バインドされたコンテキストと同じネーム・サーバーによって実装されます。つまり、最後のコンポーネントを除いた、名前引数によって示されるコンテキストを実装するネーム・サーバーです。

定義:

bind_new_context、インタフェース: NamingContextOperations

パラメータ:

n - オブジェクトの名前

例外:

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

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

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

InvalidName - 名前が無効な場合。

destroy

public void destroy()
             throws NotEmpty

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

定義:

destroy、インタフェース: NamingContextOperations

例外:

NotEmpty - Naming Contextにバインディングがある場合。

_ids

public String[] _ids()

クラスからコピーされた説明: ObjectImpl

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

定義:

_ids、クラス: ObjectImpl

戻り値:

このObjectImplのインスタンスがサポートするすべてのリポジトリ識別子の配列