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


Przenośność aplikacji J2EE
Odbudowywanie przykładów dostarczonych w tej galerii
Pierwsze kroki
Poznawanie struktury katalogów budowanych przykładów
Odbudowywanie i reinstalowanie pliku WebServicesSamples.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. Poprzez budowanie aplikacji J2EE w systemach Intel lub UNIX programista może wyeliminować problemy z konwersją pliku ze standardu EBCDIC do standardu ASCII lub ze standardu ASCII do standardu 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 dostarczonych w tej galerii

Każdemu nabywcy serwera aplikacji 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 instalowane są na jednej z platform obsługiwanych przez ten pakiet, w każdej z nich widoczna będzie ta sama galeria. Jedynym wyjątkiem jest sytuacja, gdy kliknięto opcję nazwa_przykładu > Budowanie za pomocą narzędzia Ant > platforma > Odbudowywanie i instalowanie pliku sample.ear - wtedy podawane są instrukcje dotyczące odbudowywania pliku EAR na tej platformie. Ponieważ pliki tekstowe w pliku EAR (XML, xmi, JSP itd.) muszą być w formacie ASCII, łatwiej jest edytować te pliki na komputerze 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

Należy zainstalować serwer WebSphere Application Server na wybranej rozproszonej platformie i wskazać, że zainstalowane mają zostać również przykładowe aplikacje serwera aplikacji.

Przed próbą modyfikacji lub odbudowania przykładów należy utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples/src/WebServicesSamples.

Poznawanie struktury katalogów budowanych przykładów

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

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

Odbudowywanie i reinstalowanie pliku WebServicesSamples.ear

Plik EAR (Enterprise Archive) przykładów usług WWW JAX-RPC jest udostępniany 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

Przekazywanie odbudowanego pliku WebServicesSamples.ear
Usuwanie i reinstalowanie pliku WebServicesSamples.ear

Wykonywanie skryptu budowania przykładów

W celu odbudowania przykładu sprawdź, czy katalog <katalog_główny_profilu>/bin znajduje się w zmiennej środowiskowej PATH. Aby uruchomić skrypt budowania przykładu, który odbuduje przykład, wykonaj następujące kroki:

  1. Otwórz wiersz komend.
  2. W wierszu komend przejdź do katalogu <katalog_główny_profilu>/samples/src/WebServicesSamples.
  3. Uruchom skrypt budowania przykładu:
  4. Wpisz buildWebServiceSamples w wierszu komend.
    • Na platformach programistycznych Windows wpisz buildWebServiceSamples w wierszu komend.
    • Na platformach programistycznych UNIX i Linux wpisz buildWebServiceSamples.sh w wierszu komend.

Przykład zostanie zbudowany.

Skrypty buildWebServicesSamples.bat oraz buildWebServicesSamples.sh znajdujące się w katalogu <katalog_główny_profilu>/samples/bin/WebServicesSamples ustawiają odpowiednie informacje ścieżki klasy i uruchamiają program narzędziowy budowania Ant. Narzędzie Ant odczytuje pliki build.xml, które opisują sposób budowania przykładu. Dodatkową dokumentację programu Ant można znaleźć w serwisie WWW projektu Jakarta.

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.

Przekazywanie odbudowanego pliku WebServicesSamples.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/WebServicesSamples.
  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/WebServicesSamples.
  4. Wprowadź komendę del WebServicesSamples.ear.
  5. Wprowadź komendę bin.
  6. Wprowadź komendę put WebServicesSamples.ear.
  7. Wprowadź komendę quit.

Usuwanie i reinstalowanie pliku WebServicesSamples.ear

Przykład usług WWW JAX-RPC 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-RPC:
    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('WebServicesSamples')" 

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

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

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

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

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>', '-deployejb' ] )"
                
      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('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<węzeł>', 
                  '-server', '<serwer>', '-deployejb' ] )"
                
      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-RPC została odbudowana i ponownie zainstalowana. Można teraz konfigurować i uruchamiać klienty przykładów Address Book i Stock Quote.