Kreator usługi Web Service prowadzi użytkownika przez utworzenie nowej usługi Web Service, skonfigurowanie jej do wdrożenia oraz wdrożenie jej na serwerze.
Po wdrożeniu usługi Web Service, kreator ułatwia wygenerowanie pośrednika klienta oraz przykładowej aplikacji w celu przetestowania usługi Web Service. Po zakończeniu testów można opublikować usługę w rejestrze biznesowym UDDI za pomocą kreatora eksportu.
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
- Utwórz lub zaimportuj komponent bean do folderu źródłowego Java™ projektu WWW. Aby go zaimportować, wybierz folder Zasoby Java: src i z menu Plik wybierz opcję: , a następnie przejdź do katalogu, w którym znajduje się pakiet.
Aby utworzyć usługę Web Service z komponentu bean 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 zaznacz utworzony lub zaimportowany do folderu źródłowego projektu WWW komponent bean.
- Kliknij opcję Plik > Nowy > Inne. Wybierz opcję
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 opcję Wstępująca usługa Web
Service komponentu Java bean, aby określić typ usługi Web service, a następnie
wprowadź identyfikator URI w pliku WSDL, WSIL lub HTML, który zostanie użyty do
wygenerowania usługi.
- 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 tożsamość komponentu Java bean usługi Web Service: zostanie wyświetlona nazwa WSDL usługi Web Service. Masz następujące opcje:
- Wybierz udostępniane metody.
- Wybierz styl kodowania. Ustawienie RPC/Encoded jest zalecanym stylem kodowania w środowisku wykonawczym Axis. Ta metoda kodowania jest niezgodna ze standardem WS-I.
- Określ ewentualne niestandardowe odwzorowania pakietu na przestrzeń nazw.
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 pakiet=przestrzeń nazw.
Niektóre znaki specjalne w plikach właściwości trzeba poprzedzić znakiem zmiany znaczenia.
Na przykład tekst przykładowyPakiet=http://przykładowaPrzestrzeńnazw powinien wyglądać następująco: przykładowyPakiet=http\://przykładowaPrzestrzeńnazw.
W przeciwnym przypadku dwukropek (:) zostałby potraktowany jako separator, co spowodowałoby próbę odwzorowania przykładowyPakiet na http.
- 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 serwera proxy usługi Web Services: w przypadku wybrania generowania serwera proxy wybierz, czy chcesz dostosować odwzorowania pakietu na przestrzeń nazw.
- 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: określ, czy chcesz opublikować tę usługę Web Service w rejestrze UDDI. Kliknij przycisk Zakończ.
Uwaga: może zostać wyświetlone ostrzeżenie Błąd podczas generowania pliku WSDL z kodu Java. Nie znaleziono klasy: <nazwa komponentu bean>. Błąd ten można bezpiecznie zignorować.
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.
Ważne: Jeśli metody zawierają typy nieobsługiwane przez przykładową aplikację, jak macierze, poindeksowane właściwości i kolekcje, metody zostaną pominięte w przykładowej aplikacji i zostanie wyświetlony komunikat ostrzegawczy.