Tworzenie niestandardowych powiązań danych

Adapter udostępnia opcję tworzenia niestandardowych powiązań danych na potrzeby środowiska. Niestandardowe powią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 powiązań danych.

Informacje o tej czynności

Informacje o tej czynności

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

Sposób wykonania tej czynności

Kroki czynności

  1. Zaimplementuj niestandardowe powią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 powią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 powią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 powią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 powią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 powią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 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 powią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)