2.12.4 POAManagerインタフェース

名前

PortableServer::POAManager::activate

形式

void activate(
              CORBA::Environment& = CORBA::Environment() )
              throw( CORBA::Exception );

機能説明

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

復帰値

正常終了した場合は、ありません。

異常終了時、以下の例外が発生します。

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

CORBA::SystemException: その他の要因。

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

注意事項

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

名前

PortableServer::POAManager::hold_requests

形式

void hold_requests(
              CORBA::Boolean        wait_for_completion,
              CORBA::Environment& = CORBA::Environment() )
              throw( CORBA::Exception );

機能説明

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

パラメタ

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

復帰値

正常終了した場合は、ありません。

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

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

CORBA::SystemException: その他の要因。

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

名前

PortableServer::POAManager::discard_requests

形式

void discard_requests(
              CORBA::Boolean        wait_for_completion,
              CORBA::Environment& = CORBA::Environment() )
              throw( CORBA::Exception );

機能説明

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

パラメタ

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

復帰値

正常終了した場合は、ありません。

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

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

CORBA::SystemException: その他の要因。

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

名前

PortableServer::POAManager::deactivate

形式

void deactivate(
              CORBA::Boolean        etherealize_objects,
              CORBA::Boolean        wait_for_completion,
              CORBA::Environment& = CORBA::Environment() )
              throw( CORBA::Exception );

機能説明

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

パラメタ

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

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

復帰値

正常終了した場合は、ありません。

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

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

CORBA::SystemException: その他の要因。

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

名前

PortableServer::POAManager::get_state

形式

PortableServer::POAManager::State deactivate(
              CORBA::Environment& = CORBA::Environment() )
              throw( CORBA::Exception );

機能説明

対象のPOAマネージャのstatusを取得します。

復帰値

正常終了した場合は、以下のいずれかの値（Stateオブジェクト）が返されます。

  PortableServer::POAManager::HOLDING
  PortableServer::POAManager::ACTIVE
  PortableServer::POAManager::DISCARDING
  PortableServer::POAManager::INACTIVE

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

  CORBA::SystemException

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

2.12.4 POAManagerインタフェース

2.12.4.1 PortableServer::POAManager::activate()

2.12.4.2 PortableServer::POAManager::hold_requests()

2.12.4.3 PortableServer::POAManager::discard_requests()

2.12.4.4 PortableServer::POAManager::deactivate()

2.12.4.5 PortableServer::POAManager::get_state()