Interstage Application Server リファレンスマニュアル（API編）

3.17.4.3 org.omg.CORBA.Container.lookup_name()

名前

　org.omg.CORBA.Container.lookup_name

形式

public interface Container extends org.omg.CORBA.IRObject,
       ContainerOperations, org.omg.CORBA.portable.IDLEntity,
       org.omg.CORBA.Object
{
       public org.omg.CORBA.Contained[] lookup_name(
              java.lang.String search_name,
              int levels_to_search,
              org.omg.CORBA.DefinitionKind limit_type,
              boolean exclude_inherited);
}

機能説明

　インタフェースリポジトリオブジェクトに直接包含される、または継承によって包含されるオブジェクトの中から、指定された名前を持つオブジェクトを見つけだし、そのオブジェクトリファレンスとともに、更にそのオブジェクトが包含/継承するオブジェクトのオブジェクトリファレンスをリスト形式で返します。
　返却対象のオブジェクトが見つからない場合は、返却リストのlengthに0が設定され、オブジェクトリファレンスは不定となります。

パラメタ

　search_name

　検索のキーとする名前（Identifier）。

　levels_to_search

　検索の対象とする階層の深さ。-1を指定すると、すべての階層を検索します。1を指定すると、指定されたオブジェクトの直下にあるオブジェクトだけを検索します。

　limit_type

　検索するインタフェースタイプの包含オブジェクト。
　本パラメタにdk_allを指定し、exclude_inheritedにFALSEを指定すると、該当オブジェクトおよびそのオブジェクトが包含/継承するすべてのオブジェクトリファレンスを対象とします。

　exclude_inherited

　TRUE：
　　継承オブジェクトを検索の対象としません。
　FALSE：
　　継承オブジェクトを検索の対象とします。

復帰値

　正常終了した場合は、検索されたオブジェクトのオブジェクトリファレンスのリストが返されます。
　異常終了した場合は、org.omg.CORBA.SystemExceptionが発生します。

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