Budowanie przykładów usług WWW JAX-WS za pomocą narzędzia Ant


Przenośność aplikacji J2EE
Odbudowywanie przykładów usług WWW JAX-WS
Pierwsze kroki
Poznawanie struktury katalogów budowanych przykładów
Odbudowywanie i reinstalowanie pliku JaxWSServicesSamples.ear

Przenośność aplikacji J2EE

Jedną z większych korzyści płynących z projektowania aplikacji na platformie J2EE jest przenośność. Wszystkie przykładowe programy z galerii przykładów są tworzone na stacji roboczej i uruchamiane w systemach z/OS bez konieczności modyfikowania ani jednego wiersza kodu Java.  Budując aplikacje J2EE na platformie Intel lub w systemach operacyjnych takich jak AIX i Linux, programista może uniknąć problemów z konwersją plików między formatami EBCDIC i ASCII lub ASCII i EBCDIC.  Dostępność narzędzi ułatwia programistom pisanie i testowanie kodu na programistycznej stacji roboczej oraz instalowanie plików Enterprise Archive (EAR) w systemach z/OS.

Odbudowywanie przykładów usług JAX-WS

Każdemu nabywcy serwera WebSphere Application Server dla platformy z/OS przysługuje prawo do korzystania z oprogramowania Application Server Media for Multiplatforms. Jeśli produkt podstawowy (serwer WebSphere Application Server) oraz przykłady zostaną zainstalowane na jednej z platform obsługiwanych przez ten pakiet, w każdej z nich będzie widoczna ta sama galeria. Istnieje jednak pewna różnica. Kliknięcie opcji nazwa_przykładu> Zbuduj przy użyciu narzędzia Ant > platforma > Odbudowywanie i instalowanie pliku powoduje, że wyświetlane instrukcje odbudowywania pliku EAR są specyficzne dla używanej platformy.  Ponieważ pliki tekstowe w pliku EAR, takie jak pliki XML, xmi lub JSP, muszą być w formacie ASCII, łatwiej jest edytować te pliki na komputerze używającym standardu ASCII. Dokonując zmian na komputerze ze standardem ASCII, można następnie zreinstalować wynikowy plik EAR na platformie z/OS bez potrzeby konwersji ze standardu EBCDIC do standardu ASCII. 

Pierwsze kroki

Podczas instalowania serwera WebSphere Application Server na wybranej platformie rozproszonej należy wybrać opcję instalowania aplikacji przykładowych. W panelu Instalowanie aplikacji przykładowych należy zaznaczyć pole wyboru Instaluj aplikacje przykładowe.

Należy utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples/src/JaxWSServicesSamples przed próbą zmodyfikowania lub ponownego zbudowania przykładów.

Poznawanie struktury katalogów budowanych przykładów

Przykłady są zainstalowane w następujących katalogach:

<katalog_główny_profilu>/samples/src/JaxWSServicesSamples Zawiera kod źródłowy przykładów Ping, Echo oraz MTOM.
<katalog_główny_profilu>/samples/lib/JaxWSServicesSamples Zawiera pliki WAR (Web archive) i JAR (Java archive) oraz końcowy plik JaxWSServicesSamples.ear dla przykładów. Ten katalog jest tworzony po odbudowaniu przykładu.
<katalog_główny_profilu>/samples/javadoc/JaxWSServicesSamples Zawiera dokumentację Javadoc przykładów. Ten katalog jest tworzony po odbudowaniu przykładu.
<katalog_główny_profilu>/samples/bld/JaxWSServicesSamples Zawiera wygenerowane pliki klas. Są one używane do generowania końcowego pliku JaxWSServicesSamples.ear. Ten katalog jest tworzony po odbudowaniu przykładu.

Odbudowywanie i reinstalowanie pliku JaxWSServicesSamples.ear

Plik EAR (Enterprise Archive) przykładów usług WWW JAX-WS jest dostępny po zainstalowaniu serwera WebSphere Application Server. Nie jest konieczne budowanie przykładów przed ich użyciem. Poniższe wskazówki opisują kroki odbudowywania przykładów. Zawarto w nich także dodatkowe informacje dotyczące modyfikacji.

Wykonywanie skryptu budowania przykładów

Przesyłanie odbudowanego pliku JaxWSServicesSamples.ear
Usuwanie i reinstalowanie pliku JaxWSServicesSamples.ear

Wykonywanie skryptu budowania przykładów

Aby odbudować plik EAR przykładów usług WWW JAX-WS, wykonaj następujące kroki:

  1. Sprawdź, czy katalog <katalog_główny_profilu>/bin znajduje się w zmiennej środowiskowej PATH.
  2. Przejdź do katalogu <katalog_główny_profilu>/samples/src/JaxWSServicesSamples.
  3. Uruchom skrypt budowania przykładów.
    • Na platformach Windows wpisz buildJaxWSSamples w wierszu komend.
    • Na platformach takich jak AIX i Linux wpisz buildJaxWSSamples.sh w wierszu komend.

Przykład zostanie zbudowany.

Skrypty buildJaxWSSamples znajdują się w katalogu <katalog_główny_profilu>/bin. Skrypty ustawiają odpowiednie informacje ścieżki klasy i uruchamiają budujący program narzędziowy Ant. Program narzędziowy Ant odczytuje pliki build.xml, które opisują sposób budowania przykładów. Dodatkową dokumentację dotyczącą programu narzędziowego Ant można znaleźć w serwisie WWW projektu Apache Ant.

Ważne informacjePodczas procesu budowania odbudowywane są tylko te pliki klas, które zostały zmodyfikowane. Pozostałe pliki klas są pakowane ponownie do nowego pliku EAR.

Przesyłanie odbudowanego pliku JaxWSServicesSamples.ear

Plik binarny EAR należy przekazać do serwera z/OS przy użyciu protokołu FTP, wykonując poniższe instrukcje.

  1. Znajdź odbudowany plik EAR w katalogu <katalog_główny_profilu>/samples/lib/JaxWSServicesSamples.
  2. Otwórz sesję FTP z serwerem WebSphere Application Server dla platformy z/OS z platformy programistycznej.
  3. Przejdź do katalogu <katalog_główny_profilu>/samples/lib/JaxWSServicesSamples.
  4. Usuń istniejący plik JaxWSServicesSamples.ear. Wpisz następującą komendę: del JaxWSServicesSamples.ear
  5. Aby przesłać plik w formacie binarnym, wpisz następującą komendę: bin
  6. Przenieś odbudowany plik JaxWSServicesSamples.ear z platformy programistycznej na docelowy serwer aplikacji. Wpisz następującą komendę: put JaxWSServicesSamples.ear
  7. Zakończ sesję FTP. Wpisz następującą komendę: quit.

Usuwanie i reinstalowanie pliku JaxWSServicesSamples.ear

Przykład usług WWW JAX-WS jest instalowany domyślnie w katalogu <katalog_główny_profilu>/installedApps/<nazwa_komórki>, gdzie <nazwa_komórki> to nazwa komórki, w której zainstalowano aplikację. Reinstalowanie przykładu polega na wykonaniu następujących kroków:

  1. Zatrzymaj serwer aplikacji.
  2. Usuń plik EAR przykładu usług WWW JAX-WS:
    1. Wpisz następujące komendy:

      cd <katalog_główny_profilu>\bin
      setupCmdLine

      cd <katalog_główny_profilu>/bin
      . ./setupCmdLine.sh

      cd <katalog_główny_profilu>/bin
      . ./setupCmdLine.sh

      cd <katalog_główny_profilu>/bin
      . ./setupCmdLine

      gdzie <katalog_główny_profilu> to katalog instalacyjny profilu.
    2. Wpisz następującą komendę, aby zdeinstalować aplikację (katalog <katalog_główny_profilu>/bin musi znajdować się w zmiennej środowiskowej PATH):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

  3. Zainstaluj ponownie przykład:
    • Przejdź do katalogu <katalog_główny_profilu>/samples/lib/JaxWSServicesSamples
    • Znajdź plik JaxWSServicesSamples.ear
    • Wpisz następującą komendę:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>' ] )"
                
      gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>' ] )"
                
      gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>' ] )"
                
      gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>' ] )"
                
      gdzie <węzeł> to nazwa węzła, a <serwer> to nazwa serwera, na którym ma zostać zainstalowany przykład.
  4. Uruchom serwer aplikacji.

Przykładowa aplikacja usług WWW JAX-WS została odbudowana i ponownie zainstalowana. Można teraz skonfigurować i uruchomić przykładowe klienty usług Ping, Echo i MTOM.