6.10.11 AdapterActivatorオブジェクト

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

目次索引

6.10.11 AdapterActivatorオブジェクト

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

【AdapterActivatorクラスの実装形式(JDK/JRE 1.1/1.2/1.3系の場合)】

  class UserAdapterActivator extends org.omg.PortableServer.AdapterActivator {
      public boolean unknown_adapter(...){...}
  }

【AdapterActivatorクラスの実装形式(JDK/JRE 1.4系の場合)】

  class UserAdapterActivator extends org.omg.CORBA.LocalObject
        implements org.omg.PortableServer.AdapterActivator {
      public 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を返した場合はorg.omg.CORBA.OBJECT_NOT_EXIST例外がクライアントに通知されます。
```
  public boolean unknown_adapter( POA parent, String name )

  parent : 生成するPOAの親POA
  name   : 生成するPOAのアダプタ名
```

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

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

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

目次索引