Tworzenie niestandardowych powiązań danych

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

  1. 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.
  2. 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.
      1. 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.
      2. Metoda getDataObject() pobiera rekord obiektu biznesowego (ustawiony zgodnie z powyższym opisem), dokonuje niezbędnej transformacji danych i zwraca wymagany obiekt biznesowy.
      3. 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.
      1. Metoda setDataObject traktuje obiekt biznesowy jako parametr. Dane wyjściowe metody getRecord muszą być typu com.ibm.j2ca.base.UnstructuredRecord.
      2. Informacje specyficzne dla aplikacji są pobierane z wejściowego obiektu biznesowego, jak zostało to wspomniane w kroku 3.
      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
  3. 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.
  4. 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.

Warunki używania |


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