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

3.15.2.2 org.omg.PortableServer.POA.find_POA()

名前

　org.omg.PortableServer.POA.find_POA

形式

public org.omg.PortableServer.POA find_POA()(
                    java.lang.String adapter_name,
                    boolean activate_it)
throws org.omg.PortableServer.POAPackage.AdapterNonExistent;

機能説明

　対象のPOAオブジェクトの、子POAオブジェクトのうち、adapter_nameで指定した名前を持つ子POAオブジェクトを返します。指定した名前を持つ子POAオブジェクトが存在せず、かつactivate_itパラメタがTRUEの場合、対象のPOAオブジェクトのAdapterActivatorが存在すればそれが起動されます。
　AdapterActivatorでは指定した名前を持つ子POAを生成します。これに成功した場合、本メソッドは生成された子POAオブジェクトを返します。
　上記以外の場合、AdapterNonExistent例外が発生します。

パラメタ

　adapter_name

　子POAの名前。

　activate_it

　true：
　　指定した子POAの名前が存在しない場合、新しい子POAを活性化します。
　false：
　　指定した子POAの名前が存在しない場合何もしません（AdapterNonExistent例外発生）。

復帰値

　正常終了した場合は、adapter_nameで指定した名前を持つ子POAオブジェクトが返されます。
　異常終了した場合は、以下の例外が発生します。

　org.omg.PortableServer.POAPackage.AdapterNonExistent

　機能説明参照。

　org.omg.CORBA.SystemException

　その他の要因。

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