z/OS Connect インターセプターの作成

z/OS® Connect SPI を使用して、起動、状況、開始、停止などのサービス要求を管理するインターセプター preInvokepostInvoke の実装を作成します。 インターセプターは、z/OS Connect で提供される com.ibm.wsspi.zos.connect.Interceptor の SPI を実装した OSGi サービスです。

このタスクについて

z/OS Connect には、いくつかのインターセプターが含まれています。 com.ibm.wsspi.zos.connect.Authorization インターセプターは、 開始、停止、起動などの z/OS Connect 操作に対して z/OS SAF および LDAP 許可検査を行います。 com.ibm.wsspi.zos.connect.Audit の実装は、z/OS Connect 操作での要求データの z/OS SMF レコーディングをログに記録します。

要求起動の前または後に何らかのアクションを実行するためにインターセプターを使用できます。ペイロードのコピーが他の要求データと共にインターセプターに提供されます。

z/OS Connect 用に実装されたインターセプターは、OSGi フレームワークによって z/OS Connect に接続して対話する OSGi サービスです。

手順

  1. z/OS Connect com.ibm.wsspi.zos.connect.Interceptor SPI を実装する OSGi サービスを作成します。
  2. 新規 z/OS Connect Interceptor SPI 実装を z/OS Connect と統合するため、関連付けられたメタタイプのインターセプター構成エレメント定義に ibm:objectClass="com.ibm.ws.zos.connect.interceptorType" を追加します。この属性定義は、関連付けられたメタタイプの新規インターセプターの構成エレメントの下に置かれます。
        <OCD id="custom.banking.interceptor" ibm:alias="bankingInterceptor" name="bankingInterceptor" description="Banking Interceptor" ibm:objectClass="com.ibm.ws.zos.connect.interceptorType">
            ...
        </OCD>
    z/OS Connect Interface 実装が WebSphere Application Server 8.5.5.9 以前で実行するように開発されている場合、代わりに属性定義 <AD id="com.ibm.ws.zos.connect.interceptorType" required="false" type="String"ibm:final="true"name="internal"description="internal use only"/> を追加してください。この属性定義は、関連付けられたメタタイプの新規インターセプターの構成エレメントの下に置かれます。
    <OCD id="custom.banking.interceptor" ibm:alias="bankingInterceptor" name="bankingInterceptor" description="Banking Interceptor">
       <AD id="com.ibm.ws.zos.connect.interceptorType" required="false" type="String"ibm:final="true"name="internal"description="internal use only"/>
       ...
    </OCD>

    ibm:final 属性は、その値を構成で指定できないことを示します。 name="internal" 属性は、このプロパティーがツールで表示されないことを示します。

    Liberty SPI の Java™ API ドキュメンテーションは、${wlp.install.dir}/dev ディレクトリーのいずれかの Javadoc サブディレクトリー内の個別 .zip ファイル内にあります。

    詳しくは、Liberty の拡張に関する資料を参照してください。

    注:Liberty SPI の Java API ドキュメンテーションは、資料のプログラミング・インターフェース (Javadoc) のセクションに詳述されていて、${wlp.install.dir}/dev ディレクトリーのいずれかの Javadoc サブディレクトリー内の個別 .zip ファイルとしても入手可能です。

トピックのタイプを示すアイコン タスク・トピック

ファイル名: twlp_zconnect_create_interceptor.html