Interstage Application Server アプリケーション作成ガイド （CORBAサービス編）

5.3.2.11 AdapterActivatorオブジェクト

　AdapterActivatorオブジェクトは、リクエストを受信時にPOAオブジェクトを生成するために使用します。POAオブジェクトが生成したオブジェクトリファレンスには、オブジェクトIDに加え、生成元POAオブジェクトを示すPOAidが埋め込まれています。クライアントからのリクエストが送られてきた際、POA idに対応するPOAオブジェクトが検索され、そのPOAオブジェクトがリクエストに対する処理を行います。もし、みつからない場合、検索対象のPOAの親POAオブジェクトにAdapterActivatorオブジェクトが設定されているならば、そのAdapterActivatorオブジェクトに子POAオブジェクトの生成を依頼します。親POAにAdapterActivatorオブジェクトが設定されていない場合は、CORBA::StExcep::OBJ_ADAPTER例外がクライアントに通知されます。
　AdapterActivatorオブジェクトは、ユーザが作成し、POAに登録する必要があります。
　作成するAdapterActivatorクラスは、PortableServer::AdapterActivatorクラスを継承させる必要があります。また、メソッドとしてunknown_adapter()を実装している必要があります。

【AdapterActivatorクラスの実装形式】

  class UserAdapterActivator : public PortableServer::AdapterActivator {
  public :
      CORBA::Boolean unknown_adapter(...){...}
  }

• unknown_adapter
  　POAidに対応するPOAが検出できなかった場合はAdapterActivatorオブジェクトのunknown_adapter()メソッドが呼び出されます。unknown_adapter()にはパラメタとしてPOAオブジェクトと、Stringオブジェクトが渡されます。
  　unknown_adapter()内では、渡されたPOAオブジェクトの子POAをcreate_POA()を使用して生成します。その際のアダプタ名として、渡されたStringオブジェクトを使用します。
  　子POAに対するポリシ設定や、その他必要な処理（ServantやServantManagerの生成・登録など）もこのメソッド内に記述することが可能です。
  　子POAの生成およびその他の実装した処理が成功した場合は、戻り値としてtrueを返します。そうでない場合はfalseを返します。trueを返した場合は、生成した子POAからServantのオペレーションが起動されます。falseを返した場合はCORBA::StExcep::OBJECT_NOT_EXIST例外がクライアントに通知されます。

    CORBA::Boolean unknown_adapter(
        PortableServer::POA_ptr  parent,
        CORBA::Char*             name,
        CORBA::Environment&      env );
  
    parent : 生成するPOAの親POA
    name   : 生成するPOAのアダプタ名

　AdapterActivatorオブジェクトのunknown_adapterメソッドは、PortableServer::POA::find_POAメソッド発行時に呼び出すことも可能です。

　以下にAdapterActivatorの処理の流れを示します。

1. クライアントからのリクエストを受信します。リクエストの対象となるオブジェクトリファレンスは、POAidを内包しています。
2. POAidに対応するPOAオブジェクトを検索します。存在しない場合は、既存のPOAから対象のPOAの親POAを検索します。
3. 親POAオブジェクトに設定されているAdapterActivatorクラスのインスタンスに対し、unknown_adapeter()メソッドが発行されます。
4. unknown_adapeter()の実装部では、パラメタで渡されたPOA（親POA）の子POAオブジェクトを生成します。以降、同じオブジェクトリファレンスに対するリクエストの処理は、このPOAが行います。
5. 生成した子POAに対する設定等を行います（ここでは、直接Servantを生成して子POAに登録することも可能であり、ServantManagerを生成し登録しておくことも可能です）。
6. 子POAの生成に成功した場合は、trueを返します。
7. Servantの生成、登録を行います（ServantManager使用時）。
8. Servantのオペレーションを起動します。
9. オペレーションの実行結果を返します。