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
- 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.
- 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.
- 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.
- 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
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.
- 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 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.