3.15.3 POAManagerインタフェース

名前

org.omg.PortableServer.POAManager.activate

形式

public void activate() 
throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;

機能説明

対象のPOAマネージャを「active状態」に遷移させます。POAマネージャがactive状態に入ると、関連付けられたPOAはリクエストの処理が可能となります。

復帰値

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

org.omg.PortableServer.POAManagerPackage.AdapterInactive: 対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。

org.omg.CORBA.SystemException: その他の要因。

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

注意事項

サーバアプリケーションは本メソッドの発行時点でリクエスト受信のための待機状態となります。

3.15.3.2 org.omg.PortableServer.POAManager.hold_requests()

名前

org.omg.PortableServer.POAManager.hold_requests

形式

public void hold_requests(boolean wait_for_completion) 
throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;

機能説明

対象のPOAマネージャを「holding状態」に遷移させます。POAマネージャがholding状態に入ると、関連付けられたPOAは入ってくるリクエストをキューに入れます。

パラメタ

wait_for_completion: true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるか、POAマネージャの状態がholding以外に変更されるまで、本メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。

復帰値

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

org.omg.PortableServer.POAManagerPackage.AdapterInactive: 対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。

org.omg.CORBA.SystemException: その他の要因。

3.15.3.3 org.omg.PortableServer.POAManager.discard_requests()

名前

org.omg.PortableServer.POAManager.discard_requests

形式

public void discard_requests(boolean wait_for_completion) 
throws org.omg.PortableServer.POAManagerPackage.AdapterInactive

機能説明

対象のPOAマネージャを「discarding状態」に遷移させます。POAマネージャがdiscarding状態に入ると、関連付けられたPOAは、入ってくるリクエストを破棄します。また、すでにキューに入っており実行されていないリクエストもすべて破棄されます。リクエストが破棄された際には、TRANSIENT例外がクライアントに返されます。

パラメタ

wait_for_completion: true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるか、POAマネージャの状態がdiscarding以外に変更されるまで、本メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。

復帰値

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

org.omg.PortableServer.POAManagerPackage.AdapterInactive: 対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。

org.omg.CORBA.SystemException: その他の要因。

3.15.3.4 org.omg.PortableServer.POAManager.deactivate()

名前

org.omg.PortableServer.POAManager.deactivate

形式

public void deactivate(boolean etherealize_objects,
                       boolean wait_for_completion) 
throws org.omg.PortableServer.POAManagerPackage.AdapterInactive;

機能説明

対象のPOAマネージャを「inactive状態」に遷移させます。POAマネージャがinactive状態に入ると、関連付けられたPOAは、新しいリクエストとまだ実行されていないリクエストを拒否します。

パラメタ

etherealize_objects: true：
対象のPOAマネージャに関連付けられたPOAに、RETAINポリシおよびUSER_SERVANT_MANAGERポリシを持つものがある場合、それらのPOAに関連付けられたServantManagerはアクティブなオブジェクトに対し、org.omg.PortableServer.ServantActivator.etherealize()オペレーションを実行します。
false：
上記のetherealize()オペレーションの実行は行われません。

wait_for_completion: true：
対象のPOAマネージャに関連付けられたすべてのPOA内の実行中リクエストがなくなるまで、本メソッドは復帰しません。
false：
POAマネージャの状態が遷移した時点で、本メソッドは即時復帰します。

復帰値

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

org.omg.PortableServer.POAManagerPackage.AdapterInactive: 対象のPOAマネージャが「inactive状態」のときに、本メソッドが発行されました。

org.omg.CORBA.SystemException: その他の要因。