Création de liaisons de données personnalisées

L'adaptateur fournit une option permettant de créer des liaisons de données personnalisées pour répondre aux besoins de votre environnement. Une liaison de données personnalisée est une classe Java que vous écrivez pour convertir un flux de données en objet métier lors du traitement entrant et un objet métier en flux de données lors du traitement sortant. Les importations et les exportations du système d'information d'entreprise (EIS) et de JMS peuvent être configurés pour appeler les liaisons de données personnalisées.

A propos de cette tâche

Les étapes suivantes vous guideront dans le processus de création de liaisons de données personnalisées.

Comment procéder

  1. Implémentez la liaison de données personnalisée à l'aide de l'interface commonj.connector.runtime.RecordHolderDataBinding. Cette interface se trouve dans le fichier commonj.connector.jar, qui figure dans les bibliothèques d'exécution de WebSphere Process Server.
  2. Créez les liaisons de données personnalisées en utilisant les informations entrantes ou sortantes indiquées ci-dessous.
    • Pour convertir un flux de données en objet métier pour le traitement entrant, l'adaptateur appelle la méthode vide publique setRecord(Record arg0) et les méthodes publiques DataObject getDataObject() de la liaison de données personnalisée. Il appelle d'abord setRecord, puis getDataObject.
      1. La méthode setRecord utilise un enregistrement com.ibm.j2ca.base.UnstructuredRecord comme paramètre. Cette classe fait partie du fichier jar de la classe de fondation de l'adaptateur. L'enregistrement de l'objet métier, sous forme de texte ou d'octet[], est envoyé à la liaison de données personnalisées dans cette méthode. Les autres informations requises sont également envoyées.
      2. La commande getDataObject() récupère l'enregistrement de l'objet métier, défini comme mentionné ci-dessus, procède à la transformation nécessaire des données, puis retourne l'objet métier requis.
      3. La commande getRecordName() présente dans l'enregistrement non structuré récupère l'espace de nom complet avec lequel elle peut instancier l'objet métier et extraire (comme mentionné à l'étape 3) tout ASI requis présent dans l'annotation. Cet ASI est utilisé par la liaison de données. Par exemple :

        recordName = http://www.ibm.com/xmlns/prod/websphere/j2ca/ftp/customerwrapperbg/CustomerWrapperBG

        namespace = http://www.ibm.com/xmlns/prod/websphere/j2ca/ftp/customerwrapperbg

        object name = CustomerWrapperBG

    • Pour convertir un objet métier en flux de données pour le traitement sortant, l'adaptateur appelle la méthode vide publique setDataObject(DataObject dataObject) et la méthode d'enregistrement public getRecord() de la liaison de données personnalisée. Il appelle d'abord setDataObject, puis getRecord.
      1. La méthode setDataObject utilise l'objet métier comme paramètre. La sortie de getRecord doit être de type com.ibm.j2ca.base.UnstructuredRecord.
      2. Les informations spécifiques à l'application sont obtenues par l'objet métier entrant comme mentionné à l'étape 3.
      3. La méthode getRecord procède à la transformation nécessaire et retourne les données natives sous forme d'un enregistrement non structuré.

    Voici un exemple de données EIS natives avec texte délimité : Employee~Create~sarath~IBM~Bangalore~560071

    Schéma d'objet métier :
    complexType name="Employee"
    			sequence maxOccurs="1" minOccurs="1"
    				element maxOccurs="1" minOccurs="0" name="nom" type="string"/
    				element maxOccurs="1" minOccurs="0" name="société" type="string"/
    				element maxOccurs="1" minOccurs="0" name="ville" type="string"/
    				element maxOccurs="1" minOccurs="0" name="code postal" type="string"/
    			/sequence
    		/complexType
  3. Pour accéder aux informations spécifiques à la méthode dans l'annotation de l'objet métier, utilisez le fichier CWYBS_AdapterFoundation.jar, qui contient une classe nommée com.ibm.j2ca.base.AdapterBOUtil. Cette classe contient la méthode permettant d'extraire les informations spécifiques à l'application de l'objet métier.
  4. Utilisez l'interface de programmation d'application (API) de l'objet métier pour extraire chaque valeur figurant dans l'annotation. La sortie est un objet métier représentant les informations spécifiques à l'application.
    • Pour les opérations entrantes, instanciez l'objet métier, à partir de la valeur recordName dans l'enregistrement non structuré.
    • Pour les opérations sortantes, appelez getMetadataForObject() en utilisant l'objet métier comme paramètre.

Etape suivante

Configurez les liaisons de données personnalisées en utilisant les informations détaillées présentes dans WPS_install_directory\samples\doc\CustomEISDataBinding\index.html.

Conditions d'utilisation |


(c) Copyright IBM Corporation 2005, 2006.
Technologie Eclipse (http://www.eclipse.org)