Création d'un intercepteur z/OS Connect

Utilisez l'interface SPI de z/OS® Connect pour créer un intercepteur preInvoke et des implémentations postInvoke gérant des demandes de service, telles que l'appel de services, l'interrogation de leur statut, leur démarrage ou arrêt. Les intercepteurs sont des services OSGi qui implémentent l'interface SPI com.ibm.wsspi.zos.connect.Interceptor fournie par z/OS Connect.

A propos de cette tâche

z/OS Connect inclut plusieurs intercepteurs. L'intercepteur com.ibm.wsspi.zos.connect.Authorization fournit des contrôles d'autorisation z/OS SAF et LDAP z/OS Connect, telles que le démarrage, l'arrêt et l'appel. L'implémentation com.ibm.wsspi.zos.connect.Audit consigne l'enregistrement z/OS SMF des données de demande sur des opérations z/OS Connect.

Les intercepteurs peuvent servir à exécuter certaines actions avant et après un appel de demande. Une copie du contenu ainsi que d'autres données de la demande sont fournies pour les intercepteurs.

Un intercepteur implémenté pour z/OS Connect est un service OSGi qui se connecte et interagit avec z/OS Connect via l'infrastructure OSGi.

Procédure

  1. Créez un service OSGi qui implémente l'interface SPI z/OS Connect com.ibm.wsspi.zos.connect.Interceptor .
  2. Pour intégrer la nouvelle implémentation z/OS Connect Interceptor SPI à z/OS Connect, ajoutez ibm:objectClass="com.ibm.ws.zos.connect.interceptorType" à la définition d'élément de configuration d'intercepteur dans le métatype associé. La définition d'attribut va sous l'élément de configuration du nouvel intercepteur, dans le métatype associé.
        <OCD id="custom.banking.interceptor" ibm:alias="bankingInterceptor" name="bankingInterceptor" description="Banking Interceptor" ibm:objectClass="com.ibm.ws.zos.connect.interceptorType">
            ...
        </OCD>
    Si l'implémentation de la SPI Interceptor z/OS Connect est développée pour fonctionner sur WebSphere Application Server version 8.5.5.9 ou antérieure, ajoutez la définition d'attribut suivante à la place : <AD id="com.ibm.ws.zos.connect.interceptorType" required="false" type="String"ibm:final="true"name="internal"description="internal use only"/>. La définition d'attribut va sous l'élément de configuration du nouvel intercepteur, dans le métatype associé.
    <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>

    L'attribut ibm:final indique que la valeur ne peut pas être spécifiée dans la configuration et l'attribut name="internal" indique que les outils n'affichent pas cette propriété.

    La documentation de l'API Java™ pour chaque interface SPI Liberty est disponible dans un fichier .zip distinct dans l'un des sous-répertoires Javadoc du répertoire ${wlp.install.dir}/dev .

    Pour plus d'informations, voir la documentation sur l'extension de Liberty.

    Remarque: La documentation de l'API Java pour chaque interface SPI Liberty est détaillée dans la section Interfaces de programmation (Javadoc) de la documentation et est également disponible sous la forme d'un fichier .zip distinct dans l'un des sous-répertoires Javadoc du répertoire ${wlp.install.dir}/dev .