Tworzenie szkieletu komponentu Java bean z dokumentu WSDL za pomocą środowiska wykonawczego Apache Axis

Kreator usługi WWW 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 z metod zawiera prostą implementację, którą można zastąpić, edytując komponent Bean.

Wymagania wstępne:

  1. W przypadku korzystania z kontenera serwletu Apache Jakarta Tomcat jako serwera należy go zainstalować,skonfigurować odpowiednią instancję, a następnie utworzyć skierowany do niego projekt WWW w sposób opisany w dokumencie Tworzenie serwera Apache Tomcat i projektu WWW.
  2. 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ę WWW z pliku WSDL za pomocą środowiska wykonawczego Apache Axis 1.0, wykonaj następujące czynności:
  1. Przełącz się na perspektywę J2EE (Okno > Otwórz perspektywę > J2EE).
  2. W widoku Eksploratora projektu wybierz plik WSDL, który utworzono lub zaimporotowano do folderu treści WWW danego projektu WWW.
  3. Kliknij Plik > Nowy > Inne. Wybierz Usługi WWW, aby wyświetlić różne kreatory usługi WWW. Wybierz kreatora Usługa WWW. Kliknij przycisk Dalej.
  4. Strona Usługi WWW: wybierz Odgórna usługa WWW Java Bean jako typ usługi WWW i wybierz artefakt, z którego zostanie utworzona usługa.
    1. Za pomocą suwaka wybierz etapy programowania usługi WWW, które chcesz zakończyć:
      • Projektuj: spowoduje utworzenie kodu usługi
      • Asemblowanie:
      • Wdróż: spowoduje utworzenie kodu wdrożenia dla usługi
      • Instaluj: spowoduje zainstalowanie usługi na wybranym serwerze
      • Uruchom: spowoduje uruchomienie serwera po zainstalowaniu na nim usługi
      • Testuj: spowoduje udostępnienie różnych opcji testowania usługi
    2. Wybierz serwer: zostanie wyświetlony serwer domyślny. Aby wdrożyć usługę na innym serwerze, kliknij odsyłacz i określ inny serwer.
    3. Wybierz środowisko wykonawcze: zostanie wyświetlone domyślne środowisko wykonawcze. Aby wdrożyć usługę w innym środowisku wykonawczym, kliknij odsyłacz i określ inne środowisko wykonawcze.
    4. Wybierz projekt usługi: 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 klienta WWW jest inny niż Projekt WWW usługi, w przeciwnym razie usługa zostanie nadpisana artefaktami wygenerowanymi dla klienta.
    5. Jeśli chcesz utworzyć klienta, wybierz typ serwera proxy, który zostanie wygenerowany, i powtórz powyższe kroki z klientem.
    6. Publikuj usługę WWW: spowoduje uruchomienie Eksploratora usług WWW, co umożliwia opublikowanie usługi WWW w rejestrze UDDI.
    7. Monitoruj usługę WWW: spowoduje wysłanie ruchu usługi WWW przez Monitor TCP/IP, który umożliwi przyjrzenie się ruchowi SOAP wygenerowanemu przez usługę WWW i przetestowanie tego ruchu pod kątem zgodności ze specyfikacją 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 WWW
  5. Strona Konfiguracja Java szkieletu usług WWW: 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.
  6. Strona Odwzorowania przestrzeni nazw usługi WWW na pakiet: jeśli na poprzedniem panelu wybrano opcję Definiuj niestandardowe odwzorowanie pakietu na przestrzeń nazw, na tym panelu można wpisać niestandardowe pary odwzorowania, klikając przycisk Dodaj. Kliknij przycisk Dalej.
  7. Strona Test usługi WWW: jeśli wybrano przetestowanie usługi WWW, wybierz narzędzie do testowania wygenerowanej usługi WWW. Spowoduje to otwarcie jej w Eksploratorze usług WWW. Wybierz operację, którą chcesz przetestować, wprowadź wymagane informacje i kliknij przycisk Wykonaj. Wynik zostanie wyświetlony w panelu Status. Kliknij przycisk Dalej.
  8. Strona proxy usługi WWW: jeśli wybrano wygenerowanie komponentu proxy, ta strona pokazuje jego opcje. Pokazuje folder, w którym komponent proxy zostanie wygenerowany, można także utworzyć niestandardowe odwzorowania między przestrzeniami nazw a pakietami. Kliknij przycisk Dalej.
  9. Strona Test klienta usługi WWW: służy do wybrania następujących opcji:
    1. Wybierz narzędzie do testowania. Wygenerowany komponent proxy można przetestować w Eksploratorze usług WWW lub wygenerować przykładową stronę JSP usługi WWW.
    2. 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ą.
    3. Wybierz opcję Uruchom test na serwerze, aby automatycznie uruchomić serwer.
  10. Strona Publikowanie usługi WWW: jeśli wybrano opublikowanie usługi WWW w rejestrze UDDI, za pomocą tej strony można uruchomić Eksplorator usług WWW i wybrać rejestr UDDI, w którym zostanie ona opublikowana. Kliknij przycisk Zakończ.
Po utworzeniu usługi WWW, 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 WWW, komponent ten zostanie uruchomiony w przeglądarce WWW pod następującym adresem: http://localhost: port/ ProjektWWWClient/sampleNazwaBean/ NazwaUsługiWWW/TestClient.jsp. Można użyć tej przykładowej aplikacji w celu przetestowania usługi WWW, 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 WWW za pomocą Eksploratora usług WWW, 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 WWW, zostanie uruchomiony Eksplorator usług WWW 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 WWW.