Kreator usługi Web Service pomaga w tworzeniu szkieletu komponentu bean z istniejącego dokumentu WSDL. Szkielet komponentu bean zawiera zbiór metod odpowiadających operacjom opisanym w dokumencie WSDL. Po utworzeniu komponentu bean każda metoda zawiera prostą implementację, którą można zastąpić, edytując komponent bean.
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.
- Utworzenie lub zaimportowanie pliku WSDL do folderu treści WWW projektu WWW.
Można użyć tylko pliku WSDL zawierającego element usługi.
Aby utworzyć usługę Web Service z pliku WSDL przy użyciu
środowiska wykonawczego Apache Axis1, wykonaj następujące czynności:
- Przejdź do perspektywy Java EE (Okna > Otwórz perspektywę
> Java EE).
- W widoku Eksploratora projektu wybierz plik WSDL, który utworzono lub
zaimportowano do folderu treści WWW danego projektu WWW.
- Kliknij opcję Plik > Nowy > Inne. Wybierz
Usługi Web Services, aby wyświetlić różne kreatory usługi
Web Service.
Wybierz kreatora Usługa Web Service. Kliknij przycisk Dalej.
- Strona Usługi Web Services: wybierz Zstępująca usługa Web Service Java
bean jako typ usługi Web Service i wybierz artefakt, z którego
zostanie utworzona usługa.
- 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 odpowiednio: wygenerowany kod, pliki WSDL, deskryptory wdrażania i pliki Java.
- 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ć usługę na innym serwerze, kliknij odsyłacz i określ inny serwer.
- Wybierz środowisko wykonawcze: wyświetlone środowisko do środowisko domyślne. Aby wdrożyć usługę w innym środowisku wykonawczym, kliknij odsyłacz i określ inne środowisko wykonawcze.
- Wybierz projekt usługi. Wyświetlony jest 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.
- Jeśli chcesz utworzyć klienta, wybierz typ serwera proxy, który zostanie wygenerowany, i powtórz powyższe kroki z klientem.
- Publikuj usługę Web Service: Opcja ta umożliwia uruchomienie Eksploratora usług Web Services, który pozwala opublikować usługę Web Service w rejestrze UDDI.
- 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 Konfiguracja Java™ szkieletu usług Web Services: Wybierz folder, w którym będzie zapisany wygenerowany
kod Java. Aby przejrzeć lub zmienić odwzorowania między pakietami i przestrzeniami
nazw, zaznacz pole wyboru Definiuj niestandardowe odwzorowanie
przestrzeni nazw na pakiet. Kliknij przycisk Dalej.
- Strona Odwzorowywanie pakietu usług Web Services na przestrzeń nazw: jeśli na poprzednim panelu została wybrana opcja
Zdefiniuj niestandardowe odwzorowanie pakietu na przestrzeń nazw, możesz na tym panelu określić 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 usługi Web Service: jeśli wybrano przetestowanie usługi Web Service,
wybierz narzędzie do testowania wygenerowanej usługi Web Service. Spowoduje to otwarcie jej w Eksploratorze usług Web Services. Wybierz operację, którą chcesz
przetestować, wprowadź wymagane informacje i kliknij przycisk
Wykonaj.
Wynik zostanie wyświetlony w panelu Status. Kliknij przycisk Dalej.
- Strona proxy usługi Web Service: jeśli wybrano wygenerowanie
proxy, ta strona pokazuje jego opcje. Strona wyświetla zawartość folderu, w którym proxy zostanie wygenerowany, można także utworzyć niestandardowe odwzorowania między przestrzeniami nazw a pakietami. Kliknij przycisk Dalej.
- Strona Test klienta usługi Web Service: służy do wybrania następujących
opcji:
- Wybierz narzędzie do testowania. Wygenerowany proxy
można przetestować w Eksploratorze usług Web Services lub wygenerować przykładową stronę JSP usługi Web Service.
- Jeśli wybrano testowanie komponentu proxy za pomocą strony JSP, można
wybrać folder, w którym zostanie umieszczona strona JSP oraz metody, które
się w niej znajdą.
- Wybierz opcję Uruchom test na serwerze, aby
automatycznie uruchomić serwer.
- Strona Publikowanie usługi Web Service: jeśli wybrano opublikowanie usługi
Web Service w rejestrze UDDI, za pomocą tej strony można uruchomić Eksplorator
usług Web Services i wybrać rejestr UDDI, w którym zostanie ona opublikowana. Kliknij przycisk
Zakończ.
Po utworzeniu
usługi Web Service, w zależności od wybranych opcji, może nastąpić jedna z poniższych sytuacji:
- 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.
- Jeśli wybrano opcję opublikowania usługi Web Service, zostanie uruchomiony Eksplorator usług Web Services wyświetlający stronę niezbędną do opublikowania usługi. Aby wykonać tę czynność, postępuj zgodnie z
instrukcjami wyświetlanymi na stronie Publikowanie usługi Web Service.