Tworzenie niestandardowych wiązań danych

Adapter udostępnia opcję tworzenia niestandardowych wiązań danych na potrzeby środowiska. Niestandardowe wiązanie danych to klasa Java, która służy do przekształcania strumienia danych w obiekt biznesowy (podczas przetwarzania danych przychodzących) i przekształcania obiektu biznesowego w strumień danych (podczas przetwarzania danych wychodzących). Operacje eksportu i importu usługi JMS oraz systemu informacyjnego przedsiębiorstwa (Enterprise Information System - EIS) można skonfigurować pod kątem wywoływania niestandardowych wiązań danych.

Informacje o tej czynności

Informacje o czynności

Aby utworzyć niestandardowe wiązania danych, należy wykonać poniższe kroki.

Sposób wykonania czynności

Kroki czynności

  1. Zaimplementuj niestandardowe wiązanie danych przy użyciu interfejsu commonj.connector.runtime.RecordHolderDataBinding. Interfejs ten znajduje się w pliku commonj.connector.jar, który jest zawarty w bibliotekach środowiska wykonawczego serwera WebSphere Process Server.
  2. Utwórz niestandardowe wiązania danych przy użyciu przedstawionych poniżej informacji o danych przychodzących lub wychodzących.
    • Aby przekształcić strumień danych w obiekt biznesowy na potrzeby przetwarzania danych przychodzących, adapter wywołuje metody public void setRecord(Record arg0) i public DataObject getDataObject() niestandardowego wiązania danych. Najpierw wywoływana jest metoda setRecord, a następnie metoda getDataObject.
      1. Metoda setRecord przyjmuje klasę com.ibm.j2ca.base.UnstructuredRecord jako parametr. Ta klasa jest częścią pliku JAR klasy Adapter Foundation. W tej metodzie rekord obiektu biznesowego (typu text lub byte[]) jest wysyłany do niestandardowego wiązania danych. Wysyłane są również inne wymagane informacje.
      2. Metoda getDataObject() pobiera rekord obiektu biznesowego, który jest ustawiony tak jak opisano to powyżej, wykonuje odpowiednią transformację danych i zwraca wymagany obiekt biznesowy.
      3. Metoda getRecordName() obecna w nieustrukturyzowanym rekordzie pobiera pełną przestrzeń nazw, która umożliwia utworzenie instancji obiektu biznesowego i wyodrębnienie (jak zaznaczono w kroku 3) dowolnych wymaganych informacji specyficznych dla aplikacji (ASI) istniejących w adnotacji. Informacje te są używane przez wiązanie danych. Na przykład:

        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

    • Aby przekształcić obiekt biznesowy w strumień danych na potrzeby przetwarzania danych wychodzących, adapter wywołuje metody public void setDataObject(DataObject dataObject) i public Record getRecord() niestandardowego wiązania danych. Najpierw wywoływana jest metoda setDataObject, a następnie metoda getRecord.
      1. Metoda setDataObject przyjmuje obiekt biznesowy jako parametr. Dane wyjściowe metody getRecord muszą być danymi typu com.ibm.j2ca.base.UnstructuredRecord.
      2. Informacje specyficzne dla aplikacji są uzyskiwane z wejściowego obiektu biznesowego, tak jak opisano to w kroku 3.
      3. Metoda getRecord wykonuje odpowiednią transformację i zwraca dane rodzime w formie nieustrukturyzowanego rekordu.

    Przykład danych rodzimych systemu EIS, które zawierają tekst rozdzielany separatorem: Pracownik~Create~JanG~FirmaX~Szczecin~70-110.

    Schemat obiektu biznesowego:
    complexType name="Pracownik"
    			sequence maxOccurs="1" minOccurs="1"
    				element maxOccurs="1" minOccurs="0" name="nazwa" type="string"/
    				element maxOccurs="1" minOccurs="0" name="firma" type="string"/
    				element maxOccurs="1" minOccurs="0" name="miasto" type="string"/
    				element maxOccurs="1" minOccurs="0" name="kod pocztowy" type="string"/
    			/sequence
    		/complexType
  3. Aby uzyskać dostęp do informacji specyficznych dla aplikacji znajdujących się w adnotacji obiektu biznesowego, użyj pliku CWYBS_AdapterFoundation.jar zawierającego klasę o nazwie com.ibm.j2ca.base.AdapterBOUtil. Ta klasa zawiera metodę umożliwiającą wyodrębnianie informacji specyficznych dla aplikacji z obiektu biznesowego.
  4. Aby wyodrębnić każdą wartość zawartą w adnotacji, użyj metod aplikacyjnego interfejsu programistycznego (API) obiektu biznesowego. Danymi wyjściowymi jest obiekt biznesowy reprezentujący informacje specyficzne dla aplikacji.
    • W przypadku danych przychodzących utwórz instancję obiektu biznesowego na podstawie wartości recordName zawartej w nieustrukturyzowanym rekordzie.
    • W przypadku danych wychodzących wywołaj metodę getMetadataForObject(), przekazując obiekt biznesowy jako parametr.

Dalsze czynności

Dalsze czynności

Należy skonfigurować niestandardowe wiązania danych, korzystając ze szczegółowych instrukcji znajdujących się w pliku katalog_instalacyjny_WPS\samples\doc\CustomEISDataBinding\index.html.

Warunki używania |


(c) Copyright IBM Corporation 2005, 2006.
To Centrum informacyjne jest oparte na technologii Eclipse (http://www.eclipse.org)