Adapter udostępnia opcję tworzenia niestandardowych powiązań danych, aby zaspokoić potrzeby środowiska użytkownika. Niestandardowe powiązanie danych jest klasą języka Java pisaną w celu przekształcenia strumienia danych w obiekt biznesowy (podczas przetwarzania danych przychodzących) i obiektu biznesowego w strumień danych (podczas przetwarzania danych wychodzących).
Globalny system informacyjny (EIS) oraz importowane i eksportowane elementy JMS mogą być tak skonfigurowane, aby wywoływały niestandardowe powiązania danych.
Informacje o tej czynności
Poniższe kroki opisują proces tworzenia niestandardowych powiązań danych.
Sposób wykonania tej czynności
- Zaimplementuj niestandardowe powiązania danych przy użyciu interfejsu commonj.connector.runtime.RecordHolderDataBinding. Ten interfejs znajduje się w pliku commonj.connector.jar w bibliotekach środowiska wykonawczego serwera WebSphere Process Server.
- Utwórz niestandardowe powiązania danych przy użyciu informacji przychodzących lub wychodzących, które zostały przedstawione poniżej.
- 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 getDataObject.
- Metoda setRecord traktuje klasę com.ibm.j2ca.base.UnstructuredRecord jako parametr. Ta klasa jest częścią pliku jar klasy Adapter Foundation.
Rekord obiektu biznesowego jest w tej metodzie przesyłany do niestandardowego wiązania danych jako tekst lub wartość byte[]. Wysyłane są również inne wymagane informacje.
- Metoda getDataObject() pobiera rekord obiektu biznesowego (ustawiony zgodnie z powyższym opisem), dokonuje niezbędnej transformacji danych i zwraca wymagany obiekt biznesowy.
- Metoda getRecordName() obecna w nieustrukturyzowanym rekordzie otrzymuje pełną przestrzeń nazw, dzięki której można utworzyć instancję obiektu biznesowego i wyodrębnić (jak zostało to wspomniane w kroku 3) wszystkie zbiory informacji ASI znajdujące się w adnotacji.
Zbiór informacji ASI jest używany w powiązaniu 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 getRecord.
- Metoda setDataObject traktuje obiekt biznesowy jako parametr. Dane wyjściowe metody getRecord muszą być typu com.ibm.j2ca.base.UnstructuredRecord.
- Informacje specyficzne dla aplikacji są pobierane z wejściowego obiektu biznesowego, jak zostało to wspomniane w kroku 3.
- Metoda getRecord dokonuje niezbędnej transformacji, a następnie zwraca rodzime dane w formie nieustrukturyzowanego rekordu.
Przykład rodzimych danych EIS z tekstem z ogranicznikami to: Employee~Create~sarath~IBM~Bangalore~560071
Schemat obiektu biznesowego:
complexType name="Employee"
sequence maxOccurs="1" minOccurs="1"
element maxOccurs="1" minOccurs="0" name="name" type="string"/
element maxOccurs="1" minOccurs="0" name="company" type="string"/
element maxOccurs="1" minOccurs="0" name="city" type="string"/
element maxOccurs="1" minOccurs="0" name="zip" type="string"/
/sequence
/complexType
- Aby uzyskać dostęp do informacji specyficznych dla aplikacji w adnotacji obiektu biznesowego, użyj pliku CWYBS_AdapterFoundation.jar
zawierającego klasę o nazwie com.ibm.j2ca.base.AdapterBOUtil. Ta klasa zawiera metodę wyodrębniania informacji specyficznych dla aplikacji z obiektu biznesowego.
- Użyj metod API obiektów biznesowych, aby wyodrębnić każdą z wartości zawartych w tej adnotacji. Dane wyjściowe są obiektem biznesowym reprezentującym informacje specyficzne dla aplikacji.
- Dla danych przychodzących utwórz instancję obiektu biznesowego na podstawie wartości recordName zawartej w nieustrukturyzowanym rekordzie.
- Dla danych wychodzących wywołaj metodę getMetadataForObject(), przekazując obiekt biznesowy jako parametr.
Dalsze czynności
Skonfiguruj niestandardowe powiązania danych przy użyciu szczegółowych instrukcji znajdujących się w pliku
katalog_instalacyjny_produktu_WPS\samples\doc\CustomEISDataBinding\index.html.