Ukázka Address Book - technické poznámky


Diskusi týkající se webových služeb naleznete v dokumentaci IBM WebSphere Web Services v Informačním centru.

Ukázka AddressBook ilustruje několik způsobů přístupu prostřednictvím webové služby. Ukázka obsahuje dva klienty a čtyři varianty téhož objektu AddressBook typu bean. Jde o klienta J2SE (Java 2 Standard Edition) a klienta J2EE (Java 2 Enterprise Edition). Každý klient používá čtyři varianty objektu AddressBook typu bean implementované na serveru.

Vyhledání zdrojového kódu

Zdrojový kód ukázky AddressBook je umístěn v podadresářích adresáře kořen_profilu/samples/src/WebServicesSamples. Zdrojový kód pro každý ze čtyř objektů application bean ukázky AddressBook je umístěn v adresáři s názvem uvedeným v následující tabulce. Jednoduchý zdrojový kód pro klienta J2SE je umístěn v adresáři Clients/simpleClients/samples/address. Zdrojový kód aplikačního klienta J2EE je umístěn v adresáři Clients/applicationClients/AddressBookClient.

Zákazníci se systémem z/OS: Na platformě z/OS není strom zdrojového kódu ukázek k dispozici, protože ukázkové aplikace nejsou pro platformu z/OS sestaveny.

Čtyři varianty objektů application bean ilustrují různé přístupy k vývoji aplikace s podporou webových služeb. Jde o dvě sady Enterprise JavaBean (EJB), přičemž každá je sestavena jiným způsobem. Jeden z přístupů demonstruje sestavení objektu typu bean webových služeb ze souboru WSDL (Web Service Definition Language), z nějž jsou pomocí nástroje WSDL2Java vygenerovány vazby nebo kód jazyka Java.

Položky související s touto sadou EJB jsou označeny textem "W2JE", který je odlišuje od ostatních verzí. Druhý objekt enterprise bean je vytvořen z implementované sady EJB, z níž je pomocí nástroje Java2WSDL vygenerován příslušný soubor WSDL. Soubor WSDL je použit generování deskriptorů implementace. Položky související s tímto objektem enterprise bean jsou označeny textem "J2WE".

Podobně položky týkající se obou objektů obsahují text "J2WB" nebo "W2JB", který označuje příslušný přístup.

V následující tabulce jsou uvedeny názvy příslušných čtyř objektů AddressBook typu bean.

 
Port Adresář Implementační třída Demonstrace
AddressBookW2JE addrEJBTopDown AddressBookSoapBindingImpl.java Objekt enterprise bean webové služby vzniklý ze souboru WSDL použitím nástroje WSDL2Java k vygenerování kódu jazyka Java pro objekt enterprise bean.
AddressBookJ2WE addrEJBBottomUp AddressBookBeanImpl.java Objekt enterprise bean webové služby vzniklý z objektu typu bean použitím nástroje Java2WSDL k vygenerování souboru WSDL, z nějž jsou vytvořeny deskriptory implementace.
AddressBookJ2WB addrBeanBottomUp AddressBookBean.java Objekt JavaBean webové služby vzniklý z objektu typu bean použitím nástroje Java2WSDL k vygenerování souboru WSDL, z nějž jsou vytvořeny deskriptory implementace.
AddressBookW2JB addrBeanTopDown AddressBookBean.java Objekt JavaBean webové služby vzniklý ze souboru WSDL použitím nástroje WSDL2Java k vygenerování kódu jazyka Java pro objekt typu bean.

Adresáře uvedené v tabulce naleznete ve struktuře adresářů kořen_profilu/samples/src/WebServicesSamples.

Každá implementace služby AddressBook podporuje operaci getAddressFromName. Operace vyžaduje statickou odpověď klientovi. Nedochází k ukládání adres do databáze. Účelem této ukázky je demonstrace vztahu mezi objektem typu bean a webovou službou.

Všechny verze služby AddressBook jsou obsaženy v souboru WebServicesSamples.ear. Díky jedinečnému kořenovému kontextu a názvům souborů JAR je lze implementovat souběžně. Kromě toho jsou implementační třídy sady EJB jednoznačně pojmenovány a liší se od implementačních tříd objektů JavaBean. Tato jedinečnost zaručuje, že zavaděč tříd na serveru nalezne správnou implementační třídu.

Kontrola vztahů objektu AddressBook typu bean

Kód ukázky obsahuje dva klienty: klienta J2SE a klienta J2EE. Každý klient používá čtyři varianty objektu AddressBook typu bean implementované na serveru.

Vztahy mezi čtyřmi objekty typu bean implementovanými na serveru jsou patrny v souboru WSDL klienta, který je přizpůsoben pro klientský přístup ke kterémukoli ze čtyř objektů typu bean. Soubor WSDL definuje jednu službu (AddressBookService) se čtyřmi porty. Klient AddressBook.wsdl je umístěn v adresáři ukázek src/WebServicesSamples/Clients/applicationClients/META-INF.