z/OS Connect-Datentransformator erstellen

Sie können die z/OS® Connect-SPI verwenden, um einen angepassten Datentransformator zu erstellen. Datentransformer sind OSGi-Services, die die von z/OS Connect bereitgestellte SPI com.ibm.wsspi.zos.connect.DataXform implementieren.

Informationen zu diesem Vorgang

z/OS Connect-Datentransformer werden von allen Komponenten geschrieben und bereitgestellt, die in das Framework integriert werden sollen. Ein Datentransformer ist im Lieferumfang von z/OS Connect enthalten und bietet eine Transformation in und aus JSON-Byte-Arrays, die von COBOL-, PL/I- und C-Programmen unter z/OS verwendet werden können.

Ein für z/OS Connect implementierter Datentransformer ist ein OSGi-Service, der über das OSGi-Framework eine Verbindung zu z/OS Connect herstellt und mit z/OS Connect interagiert.

Vorgehensweise

  1. Erstellen Sie die z/OS Connect-SPI com.ibm.ws.zos.connect.DataXform im Service.
  2. Wenn Sie die neue z/OS Connect-DataXform-SPI-Implementierung mit z/OS Connect integrieren möchten, fügen Sie ibm:objectClass="com.ibm.ws.zos.connect.dataXformType" der Konfigurationselementdefinition im zugehörigen Metatyp hinzu.
      <OCD id="custom.banking.dataXform" ibm:alias="bankingXform" name="bankingXform" description="Banking Xform" ibm:objectClass="com.ibm.ws.zos.connect.dataXformType">
        ...
      </OCD>
    Wenn die z/OS Connect-DataXform-Implementierung für die Ausführung in WebSphere Application Server Version 8.5.5.9 oder früher entwickelt wird, fügen Sie stattdessen die folgende Attributdefinition hinzu: <AD id="com.ibm.ws.zos.connect.dataXformType" required="false" type="String" ibm:final="true" name="internal" description="internal use only"/>. Die Attributdefinition wird unterhalb des neuen Konfigurationselements des Datentransformators im zugehörigen Metatyp angeordnet.
      <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>

    Das Attribut ibm:final gibt an, dass der Wert nicht in der Konfiguration angegeben werden kann. Das Attribut name="internal" gibt an, dass Tools diese Eigenschaft nicht anzeigen.

    Die Java™-API-Dokumentation für jede Liberty-SPI ist in einer separaten ZIP-Datei (.zip) in einem der Javadoc-Unterverzeichnisse des Verzeichnisses ${wlp.install.dir}/dev verfügbar.

    Weitere Informationen finden Sie in der Dokumentation zur Erweiterung von Liberty.

    Anmerkung: Die Java-API-Dokumentation für jede Liberty-SPI ist im Abschnitt mit den Programmierschnittstellen (Javadoc) der Dokumentation detailliert beschrieben und außerdem als separate ZIP-Datei (.zip) in einem der Unterverzeichnisse des Verzeichnisses ${wlp.install.dir}/dev verfügbar.

Symbol das den Typ des Artikels anzeigt. Taskartikel

Dateiname: twlp_zconnect_create_datatrans.html