Kreator Klient usługi Web Service pomaga w generowaniu komponentu proxy Java™ bean i przykładowej aplikacji. Przykładowa aplikacja WWW demonstruje sposób programowania pliku komponentu pośredniego.
Wymagania wstępne:
- W przypadku używania kontenera serwletu Apache Jakarta Tomcat jako serwera należy go zainstalować, skonfigurować jego instancję, a następnie utworzyć skierowany do niego projekt WWW w sposób opisany w sekcji Tworzenie serwera Apache Tomcat i projektu WWW.
- Wykrycie dokumentu WSDL i zaimportowanie go do projektu WWW. Można użyć tylko pliku WSDL zawierającego element usługi.
Aby wygenerować klienta proxy
Java i przykładową aplikację z dokumentu WSDL z wykrytego dokumentu WSDL:
- Przejdź do perspektywy Java EE (Okna > Otwórz perspektywę
> Java EE).
- W widoku Nawigatora wybierz projekt WWW, w którym chcesz wygenerować
przykładową aplikację.
- Kliknij opcję Plik > Nowy > Inne. Wybierz
Usługi Web Services, aby wyświetlić różne kreatory usługi
Web Service.
Wybierz kreatora Klient usługi Web Service. Kliknij przycisk Dalej.
- Strona Usługi Web Services:
- Wpisz identyfikator URI pliku WSDL, WSIL lub HTML, który zostanie
użyty do wygenerowania klienta.
- Wybierz typ komponentu proxy do wygenerowania
- Za pomocą suwaka wybierz etapy programowania usług Web Services, które chcesz
zakończyć:
- Tworzenie: obejmuje tworzenie definicji WSDL i implementacji usługi Web Service. Działanie to składa się z takich zadań, jak tworzenie modułów, które będą zawierały wygenerowany kod i pliki Java, a także kopiowanie plików JAR Axis.
- Asemblowanie: zapewnia powiązanie projektu, w którym zostaną udostępnione usługa Web Service lub klient, z plikiem EAR, o ile będzie tego wymagać docelowy serwer aplikacji.
- Wdrażanie: obejmuje tworzenie kodu wdrożenia dla usługi.
- Instalowanie: obejmuje instalację i konfigurację modułu WWW i plików EAR na serwerze docelowym.
- Uruchamianie: powoduje uruchomienie serwera po zainstalowaniu na nim usługi. Zostanie wygenerowany plik server-config.wsdd.
- Testowanie: udostępnia różne opcje testowania usługi, na przykład za pomocą „Eksploratora usług Web Services” lub przykładowych stron JSP.
- Wybierz serwer: wyświetlony serwer to serwer domyślny. Aby wdrożyć klienta
na innym serwerze, kliknij odsyłacz i określ inny serwer.
- Wybierz środowisko wykonawcze: wyświetlone środowisko do środowisko domyślne. Aby wdrożyć klienta w innym środowisku wykonawczym, kliknij
odsyłacz i określ inne środowisko wykonawcze.
- Wybierz projekt klienta: zostanie wyświetlony projekt zawierający
projekt wybrany w obszarze roboczym. Aby wybrać inny projekt i komponent
EAR, kliknij odsyłacz projektu. Upewnij się, że projekt wybrany jako projekt WWW
klienta jest inny niż projekt wybrany jako projekt WWW usługi. W przeciwnym
razie usługa zostanie nadpisana przez wygenerowane artefakty klienta.
- Monitoruj usługę Web Service: Ta opcja umożliwia przesyłanie ruchu
związanego z usługą Web Service przez monitor TCP/IP. Pozwala to obserwować ruch
protokołu SOAP generowany przez usługę Web Service i testować jego zgodność z WS-I. Innym sposobem jest ręczne skonfigurowanie monitora TCP/IP w sposób opisany w dokumencie Korzystanie z monitora TCP/IP do testowania usług Web Services
- Strona proxy usługi Web Service: ten panel pokazuje opcje komponentu proxy.
Strona wyświetla zawartość folderu, w którym proxy zostanie wygenerowany, można
także utworzyć niestandardowe odwzorowania między przestrzeniami nazw a pakietami.
- Strona Odwzorowania przestrzeni nazw usługi Web Service na pakiet: jeśli na
poprzedniej stronie wybrano opcję Definiuj niestandardowe
odwzorowanie przestrzeni nazw na pakiet, na tej stronie można
wpisać niestandardowe pary odwzorowania, klikając przycisk
Dodaj. Można też kliknąć przycisk Importuj, aby zaimportować niestandardowe pary odwzorowania dla pliku .properties.
Treść pliku właściwości musi mieć format przestrzeń nazw=pakiet.
Niektóre znaki specjalne w plikach właściwości trzeba poprzedzić znakiem zmiany znaczenia.
Na przykład tekst http://przykładowaPrzestrzeńnazw=przykładowyPakiet powinien wyglądać następująco: http\://przykładowaPrzestrzeńnazw=przykładowyPakiet.
W przeciwnym przypadku dwukropek (:) zostałby potraktowany jako separator, co spowodowałoby próbę odwzorowania http na //przykładowaPrzestrzeńnazw=przykładowyPakiet.
- Strona Test klienta usługi Web Service: wyświetla, czy wybrano opcję
przetestowania klienta.. Należy na niej wybrać narzędzie, które zostanie użyte do przetestowania komponentu proxy oraz metody, jakie mają zostać włączone do tego komponentu. Należy mieć na uwadze, że klient UTC
(Universal Test Client) jest kompatybilny tylko z klientami usług Web Services wdrożonymi na serwerach WebSphere®.
- Kliknij przycisk
Zakończ. Jeśli wybrano opcję
testowania proxy, w oknie przeglądarki zostanie otwarty klient
testowania.
Wygenerowany serwer proxy komponentu
Java bean udostępnia interfejs zdalnego wywołania procedury dla usługi Web Service. Przykładowa aplikacja WWW służy do zademonstrowania sposobu kodowania pliku klasy pośredniczącej.
Po wygenerowaniu klienta proxy
Java można przetestować metody usługi Web Service przez komponent proxy za pomocą
przykładowych stron JSP usług Web Services lub klienta Universal Test Client.
- Jeśli wybrano opcję przetestowania wygenerowanego komponentu proxy za
pomocą stron JSP usługi Web Service, komponent ten zostanie uruchomiony w
przeglądarce WWW pod następującym adresem: http://localhost:
port/
ProjektWWWClient/sampleNazwaBean/
NazwaUsługiWebService/TestClient.jsp Można użyć tej
przykładowej aplikacji w celu przetestowania usługi Web Service, wybierając
metodę, wpisując jej wartość i klikając przycisk
Wywołaj.
Rezultat metody zostanie wyświetlony w panelu wyników.
- Jeśli wybrano opcję przetestowania usługi Web Service za pomocą Eksploratora usług Web Services, zostanie on otwarty. Wybierz operację, którą chcesz
przetestować, wprowadź wymagane informacje i kliknij przycisk
Wykonaj. Wynik zostanie wyświetlony w panelu Status.
Więcej informacji na temat tworzenia projektu zawiera dokumentacja projektowa aplikacji WWW.