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
- 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.
- 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.
- 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.
- 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.
- 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.
- Metoda setDataObject przyjmuje obiekt biznesowy jako parametr. Dane wyjściowe metody getRecord muszą być danymi typu
com.ibm.j2ca.base.UnstructuredRecord.
- Informacje specyficzne dla aplikacji są uzyskiwane z wejściowego obiektu biznesowego, tak jak opisano to w kroku 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
- 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.
- 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.