z/OS® Connect SPI を使用して、カスタム・データ変換プログラムを作成することができます。
データ変換プログラムは、z/OS Connect で提供される com.ibm.wsspi.zos.connect.DataXform の SPI を実装した OSGi サービスです。
このタスクについて
任意のコンポーネントが z/OS Connect データ変換プログラムを作成して提供し、フレームワークにプラグインします。
データ変換プログラムは z/OS Connect に含まれており、JSON と、z/OS 上の
COBOL、PL/I、および C のプログラムによって使用可能なバイト配列との間で相互の変換を行います。
z/OS Connect 用に実装されたデータ変換プログラムは、
OSGi フレームワークによって z/OS Connect に接続して対話する OSGi サービスです。
手順
- z/OS Connect com.ibm.ws.zos.connect.DataXform SPI を実装する OSGi サービスを作成します。
- 新規 z/OS Connect DataXform SPI 実装を z/OS Connect と統合するため、関連付けられたメタタイプのデータ変換プログラム構成エレメント定義に ibm:objectClass="com.ibm.ws.zos.connect.dataXformType" を追加します。
<OCD id="custom.banking.dataXform" ibm:alias="bankingXform" name="bankingXform" description="Banking Xform" ibm:objectClass="com.ibm.ws.zos.connect.dataXformType">
...
</OCD>
z/OS Connect DataXform 実装が WebSphere Application
Server バージョン 8.5.5.9 以前で実行するように開発されている場合、代わりに属性定義
<AD
id="com.ibm.ws.zos.connect.dataXformType" required="false" type="String" ibm:final="true"
name="internal" description="internal use only"/> を追加してください。この属性定義は、
関連付けられたメタタイプの新規データ変換プログラムの構成エレメントの下に置かれます。
<OCD id="custom.banking.dataXform" ibm:alias="bankingXform" name="bankingXform" description="Banking Xform">
<AD id="com.ibm.ws.zos.connect.dataXformType" 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 ファイルとしても入手可能です。