モジュール java.corba
パッケージ org.omg.PortableServer

インタフェースServantLocatorOperations

  • すべてのスーパー・インタフェース:
    ServantManagerOperations
    既知のすべてのサブインタフェース:
    ServantLocator
    既知のすべての実装クラス:
    _ServantLocatorStub, ServantLocatorPOA

    public interface ServantLocatorOperations
    extends ServantManagerOperations
    POAにNON_RETAINポリシーが指定されているときは、サーバント・マネージャとしてServantLocatorが使用されます。 POAはこのサーバント・マネージャが返すサーバントが1つの要求だけに使用されることを認識しているため、サーバント・マネージャのオペレーションに補足情報を提供でき、サーバント・マネージャのオペレーションのペアは連携してServantActivatorとは異なる処理を実行できる場合があります。 POAがpreinvokeによって返されたサーバントに対するオペレーション呼出しを実行した直後にServantLocatorインタフェースを使用したときは、そのサーバントに対してpostinvokeを呼び出し、特にObjectId値とServant値をパラメータとして渡します。 この機能は、POAに関連付けられたオブジェクトの各要求が強制的にサーバント・マネージャを介して行われるようにする場合に使用されます。
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      void postinvoke​(byte[] oid, POA adapter, String operation, Object the_cookie, Servant the_servant)
      このオペレーションは、サーバントが要求を完了したときに必ず呼び出されます。
      Servant preinvoke​(byte[] oid, POA adapter, String operation, CookieHolder the_cookie)
      このオペレーションは、preinvokeが呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。
    • メソッドの詳細

      • preinvoke

        Servant preinvoke​(byte[] oid,
                          POA adapter,
                          String operation,
                          CookieHolder the_cookie)
                   throws ForwardRequest
        このオペレーションは、preinvokeが呼び出される原因となった要求を処理するためのサーバントを取得する場合に使用されます。
        パラメータ:
        oid - リクエストの対象となったオブジェクトに関連付けられたオブジェクトID。
        adapter - オブジェクトが起動されるPOAのオブジェクト参照。
        operation - オペレーションの名前。
        the_cookie - postinvokeの呼出し時に使用されるサーバント・マネージャによって設定できる不透明な値。
        戻り値:
        着信要求を処理するためのサーバント。
        例外:
        ForwardRequest - 現在のリクエストとそれに続くリクエストをその例外のforward_referenceメンバーに示されたオブジェクトに配信する責任があることをORBに通知する。
      • postinvoke

        void postinvoke​(byte[] oid,
                        POA adapter,
                        String operation,
                        Object the_cookie,
                        Servant the_servant)
        このオペレーションは、サーバントが要求を完了したときに必ず呼び出されます。
        パラメータ:
        oid - リクエストの対象となったオブジェクトに関連付けられたオブジェクトID。
        adapter - オブジェクトがアクティブになっていたPOAの参照。
        the_cookie - preinvokeによって設定されたデータを含む不透明な値。
        the_servant - オブジェクトに関連付けられるサーバントへの参照。