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

3.15.2 POAインタフェース

3.15.2.1 org.omg.PortableServer.POA.create_POA()

名前

org.omg.PortableServer.POA.create_POA

形式

public org.omg.PortableServer.POA create_POA(
                    java.lang.String adapter_name,
                    org.omg.PortableServer.POAManager a_POAManager,
                    org.omg.CORBA.Policy[] policies)
throws org.omg.PortableServer.POAPackage.AdapterAlreadyExists,
       org.omg.PortableServer.POAPackage.InvalidPolicy;

機能説明

対象のPOAオブジェクトの、子POAオブジェクトを作成します。adapter_nameパラメタには、同じ親に対する子POAにおいて、新しい子POAを識別する名前を指定します。

パラメタ

adapter_name

生成する子POAの名前。

a_POAManager

関連付けるPOAマネージャのオブジェクト。

policies

子POAに指定するポリシを持つPolicyListオブジェクト

復帰値

正常終了した場合は、生成された子POAオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.AdapterAlreadyExists

対象のPOAオブジェクトが、すでに指定した名前の子POAオブジェクトを持っています。

org.omg.PortableServer.POAPackage.InvalidPolicy

指定したポリシオブジェクトの組み合わせが無効です。

org.omg.CORBA.SystemException

その他の要因。

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

注意事項

OMGのCORBA規約ではcreate_POA()の2番目のパラメタ“a_POAManager”に“null”を指定した場合は、新しくPOAManagerオブジェクトが作成され、新しく作成するPOAオブジェクトを関連付ける仕様ですが、Interstage CORBAサービスにおいては、1プロセス中に唯一のPOAManagerオブジェクトのみが存在する仕様となっています。CORBAサービスのPOAManagerオブジェクトは、RootPOAオブジェクトが生成されたときに1つだけ作成されます。

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サービスから通知される例外情報/マイナーコード”を参照してください。

3.15.2.3 org.omg.PortableServer.POA.destroy()

名前

org.omg.PortableServer.POA.destroy

形式

public void destroy(boolean etherealize_objects,
                        boolean wait_for_completion);

機能説明

対象のPOAオブジェクトおよびその子孫のPOAオブジェクトを破棄します。

パラメタ

etherealize_objects

true:
POAがRETAINポリシを持つ場合、POAに登録されているServantManagerはAOM上のアクティブなオブジェクトに対してetherealize()メソッドを発行します。
false:
上記の動作を行いません。

wait_for_completion

true:
本メソッドは、プロセス内のリクエストが完了し、かつetherealize()メソッドの起動がすべて完了した時点で復帰します。
false:
本メソッドは、POAオブジェクトを破棄した時点で復帰します。

復帰値

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

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

3.15.2.4 org.omg.PortableServer.POA.create_thread_policy()

名前

org.omg.PortableServer.POA.create_thread_policy

形式

public org.omg.PortableServer.ThreadPolicy 
create_thread_policy( org.omg.PortableServer.ThreadPolicyValue value);

機能説明

valueで指定したポリシを持つThreadPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.PortableServer.ThreadPolicyValue.ORB_CTRL_MODEL
  org.omg.PortableServer.ThreadPolicyValue.SINGLE_THREAD_MODEL

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したThreadPolicyオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.5 org.omg.PortableServer.POA.create_lifespan_policy()

名前

org.omg.PortableServer.POA.create_lifespan_policy

形式

public org.omg.PortableServer.LifespanPolicy
create_lifespan_policy(
        org.omg.PortableServer.LifespanPolicyValue value);

機能説明

valueで指定したポリシを持つLifespanPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.CORBA.PortableServer.LifespanPolicyValue.TRANSIENT
  org.omg.CORBA.PortableServer.LifespanPolicyValue.PERSISTENT

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したLifespanPolicyオブジェクトを返します。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.6 org.omg.PortableServer.POA.create_id_uniqueness_policy()

名前

org.omg.PortableServer.POA.create_id_uniqueness_policy

形式

public org.omg.PortableServer.IdUniquenessPolicy
create_id_uniqueness_policy(
   org.omg.PortableServer.IdUniquenessPolicyValue value);

機能説明

valueで指定したポリシを持つIdUniquenessPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.CORBA.PortableServer.IdUniquenessPolicyValue.UNIQUE_ID,
  org.omg.CORBA.PortableServer.IdUniquenessPolicyValue.MULTIPLE_ID

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したIdUniquenessPolicyオブジェクトを返します。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.7 org.omg.PortableServer.POA.create_id_assignment_policy()

名前

org.omg.PortableServer.POA.create_id_assignment _policy

形式

public org.omg.PortableServer.IdAssignmentPolicy
create_id_assignment_policy( 
     org.omg.PortableServer.IdAssignmentPolicyValue value);

機能説明

valueで指定したポリシを持つIdAssignmentPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.PortableServer.IdAssignmentPolicyValue.USER_ID
  org.omg.PortableServer.IdAssignmentPolicyValue.SYSTEM_ID

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したIdAssignmentPolicyオブジェクトを返します。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.8 org.omg.PortableServer.POA.create_implicit_activation_policy()

名前

org.omg.PortableServer.POA.create_implicit_activation_policy

形式

public org.omg.PortableServer.ImplicitActivationPolicy
create_implicit_activation_policy(
     org.omg.PortableServer.ImplicitActivationPolicyValue value);

機能説明

valueで指定したポリシを持つImplicitActivationPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.PortableServer.ImplicitActivationPolicyValue.IMPLICIT_ACTIVATION
  org.omg.PortableServer.ImplicitActivationPolicyValue.NO_IMPLICIT_ACTIVATION

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したImplicitActivationPolicyオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.9 org.omg.PortableServer.POA.create_servant_retention_policy()

名前

org.omg.PortableServer.POA.create_servant_retention_policy

形式

public org.omg.PortableServer.ServantRetentionPolicy
create_servant_retention_policy(
      org.omg.PortableServer.ServantRetentionPolicyValue value);

機能説明

valueで指定したポリシを持つServantRetentionPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.PortableServer.ServantRetentionPolicyValue.RETAIN
  org.omg.PortableServer.ServantRetentionPolicyValue.NON_RETAIN

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したServantRetentionPolicyオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.10 org.omg.PortableServer.POA.create_request_processing_policy()

名前

org.omg.PortableServer.POA.create_request_processing_policy

形式

public org.omg.PortableServer.RequestProcessingPolicy
create_request_processing_policy(
  org.omg.PortableServer.RequestProcessingPolicyValue value);

機能説明

valueで指定したポリシを持つRequestProcessingPolicyオブジェクトを生成します。

パラメタ

value

以下の値が指定可能です。
  org.omg.PortableServer.RequestProcessingPolicyValue.USE_ACTIVE_OBJECT_MAP_ONLY
  org.omg.PortableServer.RequestProcessingPolicyValue.USE_DEFAULT_SERVANT
  org.omg.PortableServer.RequestProcessingPolicyValue.USE_SERVANT_MANAGER

POAオブジェクトについては、“アプリケーション作成ガイド(CORBAサービス編)”の“アプリケーションの開発(Java言語)”を参照してください。

復帰値

正常終了した場合は、生成したRequestProcessingPolicyオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.11 org.omg.PortableServer.POA.get_servant_manager()

名前

org.omg.PortableServer.POA.get_servant_manager

形式

public org.omg.PortableServer.ServantManager get_servant_manager()
throws org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

対象のPOAに関連付けられたServantManagerのオブジェクトを返します。関連付けられたServantManagerが存在しない場合はnullが返されます。対象のPOAには、USE_SERVANT_MANAGERポリシが設定されている必要があります。

復帰値

正常終了した場合は、関連付けられたServantManagerのオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにUSE_SERVANT_MANAGERポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.12 org.omg.PortableServer.POA.set_servant_manager()

名前

org.omg.PortableServer.POA.set_servant_manager

形式

public void  org.omg.PortableServer.POA.set_servant_manager(
             org.omg.PortableServer.ServantManager imgr )
throws org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

POAに関連付けるデフォルトのServantManagerの設定を行います。対象のPOAには、USE_SERVANT_MANAGERポリシが設定されている必要があります。本メソッドは同じPOAに対し、1回だけ発行できます。

パラメタ

imgr

関連付けるデフォルトのServantManagerのオブジェクト

復帰値

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

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにUSE_SERVANT_MANAGERポリシが設定されていません。

org.omg.CORBA.BAD_INV_ORDER

同じPOAに対し、複数回発行されました。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.13 org.omg.PortableServer.POA.get_servant()

名前

org.omg.PortableServer.POA.get_servant

形式

public org.omg.PortableServer.Servant get_servant()
throws org.omg.PortableServer.POAPackage.NoServant,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

POAに関連付けられているデフォルトのServantを返します。対象のPOAには、USE_DEFAULT_SERVANTポリシが設定されている必要があります。

復帰値

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

org.omg.PortableServer.POAPackage.NoServant

対象のPOAに関連付けられているServantが存在しません。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにUSE_SERVANT_MANAGERポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.14 org.omg.PortableServer.POA.set_servant()

名前

org.omg.PortableServer.POA.set_servant

形式

public void set_servant(org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

対象のPOAに対して、p_servantで指定されたServantを、Default Servantとして登録します。このServantは、アクティブオブジェクトマップ(AOM)内に、リクエストに対するServantが発見できなかった場合に使用されます。対象のPOAには、USE_DEFAULT_SERVANTポリシが設定されている必要があります。

パラメタ

p_servant

登録するDefault Servantオブジェクト。

復帰値

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

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにUSE_DEFAULT_SERVANTポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.15 org.omg.PortableServer.POA.activate_object()

名前

org.omg.PortableServer.POA.activate_object

形式

public byte[]
activate_object(org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.ServantAlreadyActive,
      org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

オブジェクトIDを生成し、さらにそのオブジェクトIDと指定したServantを対象のPOAのアクティブオブジェクトマップ(AOM)に格納します。復帰値としてオブジェクトIDが返されます。対象のPOAには、SYSTEM_IDポリシとRETAINポリシが設定されている必要があります。

パラメタ

p_servant

AOMに登録するServantオブジェクト。

復帰値

正常終了した場合は、登録したServantに対するオブジェクトIDが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.ServantAlreadyActive

POAにUNIQUE_IDポリシが設定されており、かつ、p_servantパラメタで指定したServantがすでにAOMに存在します。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにSYSTEM_IDポリシとRETAINポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.16 org.omg.PortableServer.POA.activate_object_with_id()

名前

org.omg.PortableServer.POA.activate_object_with_id

形式

public void activate_object_with_id(byte[] oid,
org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.ObjectAlreadyActive,
       org.omg.PortableServer.POAPackage.ServantAlreadyActive,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

oidパラメタで指定したオブジェクトIDとp_servantパラメタで指定したServantの関連付けを、対象のPOAのアクティブオブジェクトマップ(AOM)に格納します。対象のPOAには、RETAINポリシが設定されている必要があります。

パラメタ

oid

AOMに登録するオブジェクトID

p_servant

oidと関連付け、AOMに登録するServantオブジェクト

復帰値

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

org.omg.PortableServer.POAPackage.ObjectAlreadyActive

対象のPOAにおいて、oidパラメタで指定されるCORBAオブジェクトがすでにアクティブです。

org.omg.PortableServer.POAPackage.ServantAlreadyActive

POAにUNIQUE_IDポリシが設定されており、かつ、p_servantパラメタで指定したServantがすでにアクティブオブジェクトマップ(AOM)に存在します。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.17 org.omg.PortableServer.POA.deactivate_object()

名前

org.omg.PortableServer.POA.deactivate_object

形式

public void deactivate_object(byte[] oid)
throws org.omg.PortableServer.POAPackage.ObjectNotActive,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

oidパラメタで指定されたオブジェクトIDとServantとの関連付けを、対象のPOAのアクティブオブジェクトマップ(AOM)から削除します。対象のPOAにServantManagerが関連付けられている場合は、org.omg.PortableServer.ServantLocator.etherealize()メソッドが、oidとServantを引数として起動されます。対象のPOAには、RETAINポリシが設定されている必要があります。

パラメタ

oid

AOMから取り除くオブジェクトID

復帰値

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

org.omg.PortableServer.POAPackage.ObjectNotActive

指定したオブジェクトIDに関連付けられた、アクティブなオブジェクトが存在しません。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.18 org.omg.PortableServer.POA.create_reference()

名前

org.omg.PortableServer.POA.create_reference

形式

public org.omg.CORBA.Object create_reference(
    java.lang.String intf)
    throws org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

POAが作成したオブジェクトIDとintfパラメタで指定したインタフェースリポジトリIDを内包するオブジェクトリファレンスを生成します。対象のPOAには、SYSTEM_IDポリシが設定されている必要があります。

パラメタ

intf

オブジェクトリファレンスの生成対象であるインタフェースリポジトリID。

復帰値

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

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにSYSTEM_IDポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.19 org.omg.PortableServer.POA.create_reference_with_id()

名前

org.omg.PortableServer.POA.create_reference_with_id

形式

public org.omg.CORBA.Object create_reference_with_id(
    byte[] oid,
    java.lang.String intf);

機能説明

oidパラメタで指定したオブジェクトIDとintfパラメタで指定したインタフェースリポジトリIDを内包するオブジェクトリファレンスを生成します。

パラメタ

oid

生成するオブジェクトリファレンスに組み込むオブジェクトID

intf

生成するオブジェクトリファレンスに組み込むインタフェースリポジトリID

復帰値

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

org.omg.CORBA.BAD_PARAM

対象となるPOAにSYSTEM_IDポリシが設定されている場合で、指定したoidの値がシステムが生成した値と異なっています。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.20 org.omg.PortableServer.POA.servant_to_id()

名前

org.omg.PortableServer.POA.servant_to_id

形式

public byte[] 
servant_to_id( org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.ServantNotActive,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

対象のPOAに設定するポリシによって、下記(a)(b)の動作を行います。
(a) 対象のPOAがUNIQUE_IDポリシをもち、p_servantパラメタで指定したServantがアクティブな場合は、Servantに関連付けられたオブジェクトIDが返されます。
(b) 対象のPOAがIMPLICIT_ACTIVATIONポリシとMULTIPLE_IDポリシを持つ場合、またはIMPLICIT_ACTIVATIONポリシをもち指定したServantがアクティブでない場合、ServantはPOAが生成するオブジェクトIDと、Servantに関連付けられたインタフェースリポジトリIDを使用してアクティベートされます。そして、対応するオブジェクトIDが返されます。
対象のPOAは、RETAINポリシに加え、UNIQUE_IDポリシまたはIMPLICIT_ACTIVATIONポリシを設定されている必要があります。

パラメタ

p_servant

オブジェクトIDを取得する対象のServant(Servant型オブジェクト)。

復帰値

正常終了した場合は、指定したServantに対応するオブジェクトIDが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.ServantNotActive

上記機能説明の(a)、(b)以外の場合。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシとUNIQUE_IDポリシまたは、RETAINポリシとIMPLICIT_ACTIVATIONポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.21 org.omg.PortableServer.POA.servant_to_reference()

名前

org.omg.PortableServer.POA.servant_to_reference

形式

public org.omg.CORBA.Object servant_to_reference(
                            org.omg.PortableServer.Servant p_servant)
throws org.omg.PortableServer.POAPackage.ServantNotActive,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

対象のPOAに設定するポリシによって、下記(a)(b)の動作を行います。
(a) 対象のPOAがUNIQUE_IDポリシをもち、p_servantパラメタで指定したServantがアクティブな場合は、Servantをアクティブにするために使用した情報を内包したオブジェクトリファレンスが返されます。
(b) 対象のPOAがIMPLICIT_ACTIVATIONポリシとMULTIPLE_IDポリシを持つ場合、またはIMPLICIT_ACTIVATIONポリシをもち指定したServantがアクティブでない場合、ServantはPOAが生成するオブジェクトIDと、Servantに関連付けられたインタフェースIDを使用してアクティベートされます。そして、対応するオブジェクトリファレンスが返されます。対象のPOAは、RETAINポリシに加え、UNIQUE_IDポリシまたはIMPLICIT_ACTIVATIONポリシを設定されている必要があります。

パラメタ

p_servant

オブジェクトリファレンスを取得する対象のServant(Servant型オブジェクト)。

復帰値

正常終了した場合は、指定したServantに対応するオブジェクトリファレンスが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.ServantNotActive

上記機能説明の(a)、(b)以外の場合。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシとUNIQUE_IDポリシまたは、RETAINポリシとIMPLICIT_ACTIVATIONポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.22 org.omg.PortableServer.POA.reference_to_servant()

名前

org.omg.PortableServer.POA.reference_to_servant

形式

org.omg.PortableServer.Servant
public org.omg.PortableServer.Servant reference_to_servant(
                                      org.omg.CORBA.Object reference)
throws org.omg.PortableServer.POAPackage.ObjectNotActive,
       org.omg.PortableServer.POAPackage.WrongAdapter,
       org.omg.PortableServer.POAPackage.WrongPolicy

機能説明

対象のPOAに設定するポリシによって、下記(a)(b)の動作を行います。
(a) 対象のPOAがRETAINポリシをもち、かつreferenceパラメタで指定したオブジェクトリファレンスがアクティブオブジェクトマップ(AOM)内に存在する場合には、AOM内でこのオブジェクトリファレンスに関連付けられたServantを返します。
(b) 対象のPOAがUSE_DEFAULT_SERVANTポリシをもち、かつ「Default Servant」がPOAに設定されている場合には、Default Servantを返します。対象のPOAは、RETAINポリシまたはUSE_DEFAULT_SERVANTポリシを設定されている必要があります。

パラメタ

reference

取得するServantに対応するオブジェクトリファレンス。

復帰値

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

org.omg.PortableServer.POAPackage.ObjectNotActive

上記機能説明の(a)、(b)以外の場合。

org.omg.PortableServer.POAPackage.WrongAdapter

オブジェクトリファレンスがこのPOAによって生成できませんでした。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシまたはUSE_DEFAULT_SERVANTポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.23 org.omg.PortableServer.POA.reference_to_id()

名前

org.omg.PortableServer.POA.reference_to_id

形式

public byte[] reference_to_id(org.omg.CORBA.Object reference) 
throws org.omg.PortableServer.POAPackage.WrongAdapter, 
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

referenceパラメタで指定したオブジェクトリファレンスが内包しているオブジェクトIDの値を返します。referenceパラメタに指定するオブジェクトリファレンスは、このメソッドが実行されるPOAオブジェクトが生成したオブジェクトリファレンスのみ有効です。

パラメタ

reference

目的のオブジェクトIDを内包したオブジェクトリファレンス。

復帰値

正常終了した場合は、指定したオブジェクトリファレンスが内包しているオブジェクトIDの値が返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.WrongAdapter

オブジェクトリファレンスがこのPOAによって生成できませんでした。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.24 org.omg.PortableServer.POA.id_to_servant()

名前

org.omg.PortableServer.POA.id_to_servant

形式

public Servant id_to_servant(byte[] oid)
throws org.omg.PortableServer.POAPackage.ObjectNotActive,
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

oidパラメタに指定されたオブジェクトIDに関連付けられたアクティブなServantを返します。対象のPOAは、RETAINポリシが設定されている必要があります。

パラメタ

oid

取得するServantに関連付けられたオブジェクトID。

復帰値

正常終了した場合は、指定されたオブジェクトIDに関連付けられたアクティブなServantが返されます。
異常終了した場合は、以下の例外が発生します。

org.omg.PortableServer.POAPackage.ObjectNotActive

対象のPOA内で、指定したオブジェクトIDがアクティブではありません。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.25 org.omg.PortableServer.POA.id_to_reference()

名前

org.omg.PortableServer.POA.id_to_reference

形式

public org.omg.CORBA.Object id_to_reference(byte[] oid) 
throws org.omg.PortableServer.POAPackage.ObjectNotActive, 
       org.omg.PortableServer.POAPackage.WrongPolicy;

機能説明

oidパラメタで指定したオブジェクトIDの値のオブジェクトが現在アクティブである場合、オブジェクトをアクティブにするために使用する情報を内包したオブジェクトリファレンスを返します。対象のPOAは、RETAINポリシが設定されている必要があります。

パラメタ

oid

オブジェクトリファレンスを取得するServantに関連付けられたオブジェクトID。

復帰値

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

org.omg.PortableServer.POAPackage.ObjectNotActive

対象のPOA内で、指定したオブジェクトIDがアクティブではありません。

org.omg.PortableServer.POAPackage.WrongPolicy

対象のPOAにRETAINポリシが設定されていません。

org.omg.CORBA.SystemException

その他の要因。

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

3.15.2.26 org.omg.PortableServer.POA.the_activator()

名前

org.omg.PortableServer.POA.the_activator

形式

(1) public AdapterActivator the_activator();
(2) public void the_activator(org.omg.PortableServer.AdapterActivator arg);

機能説明

(1) 対象のPOAに設定されているAdapterActivatorオブジェクトを返します。
(2) 対象のPOAに、AdapterActivatorオブジェクトを設定します。
AdapterActivatorオブジェクトは子POAを動的に生成するために使用されます。ORBからのリクエストを受信したPOAは、指定された名前(POA-ID)を持つ子POAを発見できなかった場合に、設定されているAdapterActivatorオブジェクトのunknown_adapter()メソッドを呼び出します。このメソッド内で指定された名前の子POAを生成します。unknown_adapter()メソッドの実装はアプリケーションで行う必要があります。

パラメタ

(1) なし。
(2)

arg

対象のPOAに設定するAdapterActivatorオブジェクト。

復帰値

(1) 正常終了した場合は、対象のPOAに設定されているAdapterActivatorオブジェクトが返されます。
(2) 正常終了した場合は、ありません。
異常終了した場合、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.27 org.omg.PortableServer.POA.the_name()

名前

org.omg.PortableServer.POA.the_name

形式

public java.lang.String the_name();

機能説明

対象のPOAオブジェクトの名前を返します。

復帰値

正常終了した場合は、対象のPOAオブジェクトの名前を表すString型オブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.28 org.omg.PortableServer.POA.the_parent()

名前

org.omg.PortableServer.POA.the_parent

形式

public org.omg.PortableServer.POA the_parent();

機能説明

対象のPOAオブジェクトの親POAオブジェクトを返します。

復帰値

正常終了した場合は、対象のPOAオブジェクトの親POAオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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

3.15.2.29 org.omg.PortableServer.POA.the_POAManager()

名前

org.omg.PortableServer.POA.the_POAManager

形式

public abstract org.omg.PortableServer.POAManager the_POAManager();

機能説明

対象のPOAオブジェクトに関連付けられているPOAManagerオブジェクトを返します。

復帰値

正常終了した場合は、対象のPOAオブジェクトに関連付けられているPOAManagerオブジェクトが返されます。
異常終了した場合は、以下の例外が発生します。
  org.omg.CORBA.SystemException

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