Przykład książki adresowej - noty techniczne


Aby zapoznać się z omówieniem usług WWW, patrz dokumentacja Usługi WWW produktu IBM WebSphere w Centrum informacyjnym.

Za pomocą przykładu AddressBook zilustrowano na wiele sposobów uzyskiwanie dostępu do usługi Web Service. W przykładzie zawarto dwa klienty i cztery rodzaje tego samego komponentu bean AddressBook. Dostępne klienty to klient J2SE (Java 2 Standard Edition) oraz klient J2EE (Java 2 Enterprise Edition). Każdy klient używa czterech rodzajów komponentów bean AddressBook wdrożonych na serwerze.

Znajdowanie kodu źródłowego

Kod źródłowy przykładu AddressBook można znaleźć w podkatalogach katalogu katalog_główny_profilu/samples/src/WebServicesSamples. Kod źródłowy każdego z czterech komponentów bean aplikacji AddressBook znajduje się w podkatalogu o nazwie pokazanej w poniższej tabeli. Kod źródłowy prostego klienta J2SE znajduje się w katalogu Clients/simpleClients/samples/address. Kod źródłowy klienta aplikacji J2EE znajduje się w katalogu Clients/applicationClients/AddressBookClient.

Użytkownicy systemu z/OS: Drzewo kodu źródłowego przykładów nie jest udostępniane na platformie z/OS, ponieważ przykładowe aplikacje nie są budowane na platformie z/OS.

Cztery rodzaje komponentów bean aplikacji ilustrują różne podejścia do pisania aplikacji obsługujących usługi WWW. Każdy z dwóch komponentów EJB został zbudowany przy użyciu innego rozwiązania. W jednym rozwiązaniu zademonstrowano budowanie komponentu bean usług WWW na podstawie pliku WSDL (Web Service Definition Language) i z użyciem narzędzia WSDL2Java do wygenerowania kodu Java lub powiązań.

Artefakty tego komponentu EJB zawierają łańcuch "W2JE" w celu odróżnienia ich od innych wersji. Drugi komponent EJB jest budowany na podstawie zaimplementowanego komponentu EJB. Następnie przy użyciu narzędzia Java2WSDL generowany jest plik WSDL. Deskryptory wdrażania są generowane przy użyciu pliku WSDL. Artefakty tego komponentu EJB są oznaczone łańcuchem "J2WE".

W podobny sposób artefakty dwóch komponentów JavaBeans zawierają łańcuch "J2WB" lub "W2JB" wskazujący odpowiednie rozwiązanie.

W poniższej tabeli przedstawiono nazwy czterech komponentów bean AddressBook.

 
Port Katalog Klasa implementacji Prezentowane rozwiązanie
AddressBookW2JE addrEJBTopDown AddressBookSoapBindingImpl.java Komponent EJB usługi Web Service opracowany na podstawie pliku WSDL. Kod Java dla komponentu EJB został wygenerowany za pomocą narzędzia WSDL2Java.
AddressBookJ2WE addrEJBBottomUp AddressBookBeanImpl.java Komponent EJB usługi Web Service opracowany na podstawie komponentu bean. Plik WSDL, z którego utworzone zostały deskryptory wdrażania, wygenerowano za pomocą narzędzia Java2WSDL.
AddressBookJ2WB addrBeanBottomUp AddressBookBean.java Komponent JavaBean usługi Web Service opracowany na podstawie komponentu bean. Plik WSDL, z którego utworzone zostały deskryptory wdrażania, wygenerowano za pomocą narzędzia Java2WSDL.
AddressBookW2JB addrBeanTopDown AddressBookBean.java Komponent JavaBean usługi Web Service opracowany na podstawie pliku WSDL. Kod Java dla komponentu bean został wygenerowany za pomocą narzędzia WSDL2Java.

Katalogi określone w tabeli można znaleźć w katalogu katalog_główny_profilu/samples/src/WebServicesSamples.

Każda implementacja usługi AddressBook obsługuje operację getAddressFromName. Operacja zwraca do klienta statyczną odpowiedź. Nie istnieje pamięć masowa bazy danych adresów. Celem tego przykładu jest pokazanie związku między komponentem bean i usługą Web Service.

Wszystkie wersje usługi AddressBook znajdują się w pliku WebServicesSamples.ear. Unikalny kontekst główny oraz nazwy plików JAR umożliwiają ich równoczesne wdrożenie. Dodatkowo klasy implementacji komponentów EJB są jednoznacznie nazwane i różnią się od klas implementacji komponentów JavaBean. Ta unikalność umożliwia znalezienie odpowiedniej klasy implementacji przez program ładujący klasy na serwerze.

Przeglądanie związków komponentów bean AddressBook

Przykład zawiera dwa klienty, klienta J2SE oraz klienta J2EE. Każdy klient używa czterech rodzajów komponentów bean AddressBook wdrożonych na serwerze.

W pliku WSDL klienta można zobaczyć związek między czterema komponentami bean wdrożonymi na serwerze. Jest on tworzony w celu uzyskania dostępu przez klienta do dowolnego z czterech komponentów bean. Plik WSDL określa jedną usługę, AddressBookService, z czterema portami. Klienta AddressBook.wsdl można znaleźć w katalogu przykładów src/WebServicesSamples/Clients/applicationClients/META-INF.