Generowanie serwera proxy klienta Java oraz przykładowej aplikacji z dokumentu WSDL przy użyciu środowiska wykonawczego Axis1

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:

  1. 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.
  2. 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:
  1. Przejdź do perspektywy Java EE (Okna > Otwórz perspektywę > Java EE).
  2. W widoku Nawigatora wybierz projekt WWW, w którym chcesz wygenerować przykładową aplikację.
  3. 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.
  4. Strona Usługi Web Services:
    1. Wpisz identyfikator URI pliku WSDL, WSIL lub HTML, który zostanie użyty do wygenerowania klienta.
    2. Wybierz typ komponentu proxy do wygenerowania
    3. 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.
    4. Wybierz serwer: wyświetlony serwer to serwer domyślny. Aby wdrożyć klienta na innym serwerze, kliknij odsyłacz i określ inny serwer.
    5. 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.
    6. 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.
    7. 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
  5. 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.
  6. 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.
  7. 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®.
  8. 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.

Więcej informacji na temat tworzenia projektu zawiera dokumentacja projektowa aplikacji WWW.

Pojęcia pokrewne
Tworzenie usług Web Services przy użyciu środowiska wykonawczego Apache Axis1