org.omg.PortableServer
インタフェース POAOperations

既知のサブインタフェースの一覧:

POA

public interface POAOperations

メソッドの概要

void	activate_object_with_id(byte[] id, Servant p_servant) オブジェクトを活性化します。
byte[]	activate_object(Servant p_servant) オブジェクトを活性化します。
IdAssignmentPolicy	create_id_assignment_policy(IdAssignmentPolicyValue value) IdAssignmentPolicyを生成します。
IdUniquenessPolicy	create_id_uniqueness_policy(IdUniquenessPolicyValue value) IdUniquenessPolicyを生成します。
ImplicitActivationPolicy	create_implicit_activation_policy(ImplicitActivationPolicyValue value) ImplicitActivationPolicyを生成します。
LifespanPolicy	create_lifespan_policy(LifespanPolicyValue value) LifespanPolicyを生成します。
POA	create_POA(java.lang.String adapter_name, POAManager a_POAManager, Policy[] policies) 子POAを生成します。
Object	create_reference_with_id(byte[] oid, java.lang.String intf) オブジェクトリファレンスを生成します。
Object	create_reference(java.lang.String intf) オブジェクトリファレンスを生成します。
RequestProcessingPolicy	create_request_processing_policy(RequestProcessingPolicyValue value) RequestProcessingPolicyを生成します。
ServantRetentionPolicy	create_servant_retention_policy(ServantRetentionPolicyValue value) ServantRetentionPolicyを生成します。
ThreadPolicy	create_thread_policy(ThreadPolicyValue value) ThreadPolicyを生成します。
void	deactivate_object(byte[] oid) オブジェクトを非活性化します。
void	destroy(boolean etherealize_objects, boolean wait_for_completion) このメソッドを呼び出したPOAおよびその配下にあるすべてのPOAを削除します。
POA	find_POA(java.lang.String adapter_name, boolean activate_it) 子POAを検索します。
ServantManager	get_servant_manager() サーバントマネージャを取得します。
Servant	get_servant() デフォルトサーバントを取得します。
Object	id_to_reference(byte[] oid) オブジェクトIDに対応したオブジェクトリファレンスを取得します。
Servant	id_to_servant(byte[] oid) オブジェクトIDに関連付けられている実装オブジェクトを取得します。
byte[]	reference_to_id(Object reference) オブジェクトリファレンスに含まれているオブジェクトIDを取得します。
Servant	reference_to_servant(Object reference) オブジェクトリファレンスに対応した実装オブジェクトを取得します。
byte[]	servant_to_id(Servant p_servant) 実装オブジェクトに関連付けられているオブジェクトIDを取得します。
Object	servant_to_reference(Servant p_servant) 実装オブジェクトに関連付けられているオブジェクトリファレンスを取得します。
void	set_servant_manager(ServantManager imgr) サーバントマネージャを設定します。
void	set_servant(Servant p_servant) デフォルトサーバントとなる実装オブジェクトを設定します。
AdapterActivator	the_activator() AdapterActivatorを取得します。
void	the_activator(AdapterActivator i) AdapterActivatorを設定します。
POA[]	the_children() 子POAリストを取得します。
java.lang.String	the_name() 自分自身の名前を取得します。
POA	the_parent() 親POAを取得します。
POAManager	the_POAManager() 関連付けられているPOAManagerを取得します。

メソッドの詳細

create_POA

public POA create_POA(java.lang.String adapter_name,
                      POAManager a_POAManager,
                      Policy[] policies)
               throws AdapterAlreadyExists,
                      InvalidPolicy

子POAを生成します。生成される子POAは親POAの方針を受け継ぎません。

パラメータ:

adapter_name - POAの名前

a_POAManager - 生成するPOAを管理するPOAManager

policies - POAのポリシー

戻り値:

例外:

AdapterAlreadyExists - 指定した名前がすでに使われている

InvalidPolicy - ポリシーの組合せが正しくない

find_POA

public POA find_POA(java.lang.String adapter_name,
                    boolean activate_it)
             throws AdapterNonExistent

子POAを検索します。

パラメータ:

adapter_name - 検索する子POAの名前

activate_it - 子POAが存在しなかったときにAdapterActivatorを使って子POAの生成を試みる場合はtrue、そうでない場合はfalse

戻り値:

検索もしくは生成された子POA

例外:

AdapterNonExistent - 子POAが見つからない、もしくはAdapterActivatorによって生成することができなかった

destroy

public void destroy(boolean etherealize_objects,
                    boolean wait_for_completion)

このメソッドを呼び出したPOAおよびその配下にあるすべてのPOAを削除します。

パラメータ:

etherealize_objects - サーバントマネージャのetherealizeオペレーション呼び出しを試みる場合はtrue、そうでない場合はfalse

wait_for_completion - 現在実行中のリクエストの処理が終了するのを待つ場合はtrue、そうでない場合はfalse

create_thread_policy

public ThreadPolicy create_thread_policy(ThreadPolicyValue value)

ThreadPolicyを生成します。

パラメータ:

value - ORB_CTRL_MODELもしくはSINGLE_THREAD_MODEL

戻り値:

生成されたThreadPolicy

create_lifespan_policy

public LifespanPolicy create_lifespan_policy(LifespanPolicyValue value)

LifespanPolicyを生成します。

パラメータ:

value - TRANSIENTもしくはPERSISTENT

戻り値:

生成されたLifespanPolicy

create_id_uniqueness_policy

public IdUniquenessPolicy create_id_uniqueness_policy(IdUniquenessPolicyValue value)

IdUniquenessPolicyを生成します。

パラメータ:

value - UNIQUE_IDもしくはMULTIPLE_ID

戻り値:

生成されたIdUniquenessPolicy

create_id_assignment_policy

public IdAssignmentPolicy create_id_assignment_policy(IdAssignmentPolicyValue value)

IdAssignmentPolicyを生成します。

パラメータ:

value - USER_IDもしくはSYSTEM_ID

戻り値:

生成されたIdAssignmentPolicy

create_implicit_activation_policy

public ImplicitActivationPolicy create_implicit_activation_policy(ImplicitActivationPolicyValue value)

ImplicitActivationPolicyを生成します。

パラメータ:

value - IMPLICIT_ACTIVATIONもしくはNO_IMPLICIT_ACTIVATION

戻り値:

生成されたImplicitActivationPolicy

create_servant_retention_policy

public ServantRetentionPolicy create_servant_retention_policy(ServantRetentionPolicyValue value)

ServantRetentionPolicyを生成します。

パラメータ:

value - RETAINもしくはNON_RETAIN

戻り値:

生成されたServantRetentionPolicy

create_request_processing_policy

public RequestProcessingPolicy create_request_processing_policy(RequestProcessingPolicyValue value)

RequestProcessingPolicyを生成します。

パラメータ:

value - USE_ACTIVE_OBJECT_MAP_ONLY、USE_DEFAULT_SERVANT、USE_SERVANT_MANAGERのいずれか

戻り値:

生成されたRequestProcessingPolicy

the_name

public java.lang.String the_name()

自分自身の名前を取得します。

戻り値:

自分自身の名前

the_parent

public POA the_parent()

親POAを取得します。

戻り値:

親POA (ルートPOAに対して呼び出した場合はnull)

the_children

public POA[] the_children()

子POAリストを取得します。

戻り値:

子POAリスト

the_POAManager

public POAManager the_POAManager()

関連付けられているPOAManagerを取得します。

戻り値:

関連付けられているPOAManager

the_activator

public void the_activator(AdapterActivator i)

AdapterActivatorを設定します。

パラメータ:

i - AdapterActivator

the_activator

public AdapterActivator the_activator()

AdapterActivatorを取得します。

戻り値:

AdapterActivator (設定されていなければnull)

get_servant_manager

public ServantManager get_servant_manager()
                                   throws WrongPolicy

サーバントマネージャを取得します。

戻り値:

サーバントマネージャ

例外:

WrongPolicy - RequestProcessingPolicyがUSE_SERVANT_MANAGERに設定されていない

set_servant_manager

public void set_servant_manager(ServantManager imgr)
                         throws WrongPolicy

サーバントマネージャを設定します。

パラメータ:

imgr - サーバントマネージャ

例外:

WrongPolicy - RequestProcessingPolicyがUSE_SERVANT_MANAGERに設定されていない

get_servant

public Servant get_servant()
                    throws NoServant,
                           WrongPolicy

デフォルトサーバントを取得します。

戻り値:

デフォルトサーバント

例外:

NoServant - デフォルトサーバントが設定されていない

WrongPolicy - RequestProcessingPolicyがUSE_DEFAULT_SERVANTに設定されていない

set_servant

public void set_servant(Servant p_servant)
                 throws WrongPolicy

デフォルトサーバントとなる実装オブジェクトを設定します。

パラメータ:

p_servant -

例外:

WrongPolicy - RequestProcessingPolicyがUSE_DEFAULT_SERVANTに設定されていない

activate_object

public byte[] activate_object(Servant p_servant)
                       throws ServantAlreadyActive,
                              WrongPolicy

オブジェクトを活性化します。 POAがオブジェクトIDを自動生成し、生成したオブジェクトIDと実装オブジェクトをActive Object Mapに登録します。

パラメータ:

p_servant - 実装オブジェクト

戻り値:

オブジェクトID

例外:

ServantAlreadyActive - IdUniquenessPolicyがUNIQUE_IDに設定されている、すでに実装オブジェクトがすでに活性化されている

WrongPolicy - IdAssignmentPolicyにSYSTEM_IDおよびServantRetentionPolicyにRETAINが設定されていない

activate_object_with_id

public void activate_object_with_id(byte[] id,
                                    Servant p_servant)
                             throws ServantAlreadyActive,
                                    ObjectAlreadyActive,
                                    WrongPolicy

オブジェクトを活性化します。 指定されたオブジェクトIDと実装オブジェクトをActive Object Mapに登録します。

パラメータ:

id - オブジェクトID

p_servant - 実装オブジェクト

例外:

ServantAlreadyActive - IdUniquenessPolicyがUNIQUE_IDに設定されている、すでに実装オブジェクトがすでに活性化されている

ObjectAlreadyActive - オブジェクトIDがすでに実装オブジェクトと関連づけられている

WrongPolicy - ServantRetentionPolicyにRETAINが設定されていない

deactivate_object

public void deactivate_object(byte[] oid)
                       throws ObjectNotActive,
                              WrongPolicy

オブジェクトを非活性化します。

パラメータ:

oid - オブジェクトID

例外:

ObjectNotActive - オブジェクトが活性化されていない

WrongPolicy - ServantRetentionPolicyにRETAINが設定されていない

create_reference

public Object create_reference(java.lang.String intf)
                        throws WrongPolicy

オブジェクトリファレンスを生成します。 POAがオブジェクトIDを自動生成します。

パラメータ:

intf - リポジトリID

戻り値:

オブジェクトリファレンス

例外:

WrongPolicy - IdAssignmentPolicyにSYSTEM_IDが設定されていない

create_reference_with_id

public Object create_reference_with_id(byte[] oid,
                                       java.lang.String intf)

オブジェクトリファレンスを生成します。

パラメータ:

oid - オブジェクトID

intf - リポジトリID

戻り値:

オブジェクトリファレンス

servant_to_id

public byte[] servant_to_id(Servant p_servant)
                     throws ServantNotActive,
                            WrongPolicy

実装オブジェクトに関連付けられているオブジェクトIDを取得します。

パラメータ:

p_servant - 実装オブジェクト

戻り値:

オブジェクトID

例外:

ServantNotActive - 実装オブジェクトが活性化されていない

WrongPolicy - 適切なポリシーが設定されていない

servant_to_reference

public Object servant_to_reference(Servant p_servant)
                            throws ServantNotActive,
                                   WrongPolicy

実装オブジェクトに関連付けられているオブジェクトリファレンスを取得します。

パラメータ:

p_servant - 実装オブジェクト

戻り値:

オブジェクトリファレンス

例外:

ServantNotActive - 実装オブジェクトが活性化されていない

WrongPolicy - 適切なポリシーが設定されていない

reference_to_servant

public Servant reference_to_servant(Object reference)
                             throws ObjectNotActive,
                                    WrongAdapter,
                                    WrongPolicy

オブジェクトリファレンスに対応した実装オブジェクトを取得します。

パラメータ:

reference - オブジェクトリファレンス

戻り値:

実装オブジェクト

例外:

ObjectNotActive - 実装オブジェクトが活性化されていない、またはデフォルトサーバントが登録されていない

WrongAdapter - オブジェクトリファレンスがこのPOAで生成されていない

WrongPolicy - 適切なポリシーが設定されていない

reference_to_id

public byte[] reference_to_id(Object reference)
                       throws WrongAdapter,
                              WrongPolicy

オブジェクトリファレンスに含まれているオブジェクトIDを取得します。

パラメータ:

reference - オブジェクトリファレンス

戻り値:

オブジェクトID

例外:

WrongAdapter - オブジェクトリファレンスがこのPOAで生成されていない

WrongPolicy - 適切なポリシーが設定されていない

id_to_servant

public Servant id_to_servant(byte[] oid)
                      throws ObjectNotActive,
                             WrongPolicy

オブジェクトIDに関連付けられている実装オブジェクトを取得します。

パラメータ:

oid - オブジェクトID

戻り値:

実装オブジェクト

例外:

ObjectNotActive - 実装オブジェクトが活性化されていない、またはデフォルトサーバントが登録されていない

WrongPolicy - 適切なポリシーが設定されていない

id_to_reference

public Object id_to_reference(byte[] oid)
                       throws ObjectNotActive,
                              WrongPolicy

オブジェクトIDに対応したオブジェクトリファレンスを取得します。

パラメータ:

oid - オブジェクトID

戻り値:

オブジェクトリファレンス

例外:

ObjectNotActive - 実装オブジェクトが活性化されていない

WrongPolicy - 適切なポリシーが設定されていない