Budowanie przykładu BeenThere przy użyciu narzędzia Ant


Przenośność aplikacji J2EE
Odbudowywanie przykładów dostarczonych w tej galerii
Pierwsze kroki
Poznawanie struktury katalogów
Odbudowywanie i instalowanie przykładu

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 ASCII, można następnie wdrażać i instalować 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.

Należy wykonać kopię zapasową katalogu <instalacyjny_katalog_główny> przed próbą modyfikowania lub odbudowania przykładów. W tym celu należy utworzyć plik ZIP katalogu samples. Możliwe będzie wtedy odtworzenie katalogu samples do jego stanu pierwotnego poprzez wyodrębnienie plików z pliku ZIP.



Poznawanie struktury katalogów

Przykład ma następującą strukturę katalogów:


katalog_główny_profilu/samples/src/BeenThere Zawiera kod źródłowy przykładu BeenThere.
katalog_główny_profilu/samples/lib/BeenThere Zawiera plik BeenThere.ear przykładu BeenThere.
katalog_główny_profilu/samples/javadoc/BeenThere Zawiera dokumentację Javadoc wygenerowaną podczas budowania przykładu BeenThere.
katalog_główny_profilu/samples/bld/BeenThere Zawiera wygenerowane pliki klas. Tych plików należy użyć do wygenerowania pliku wynikowego BeenThere.ear. Katalog bld jest tworzony po odbudowaniu przykładu BeenThere.



Odbudowywanie i instalowanie przykładu

Następujące instrukcje opisują kroki odbudowywania przykładu.


Wykonywanie skryptu budowania przykładów

Aby uruchomić skrypt budowania przykładów, który odbudowuje 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/BeenThere.
  3. Uruchom skrypt budowania przykładu:

  4. Wpisz następującą komendę:

    katalog_główny_profilu\samples\bin\BeenThere\buildBeenThere.bat

    Wpisz następującą komendę:

    . katalog_główny_profilu/samples/bin/BeenThere/buildBeenThere.sh

    • W przypadku platform programistycznych Windows wpisz następującą komendę:

      katalog_główny_profilu\samples\bin\BeenThere\buildBeenThere.bat

    • W przypadku platform programistycznych UNIX i Linux wpisz następującą komendę:

      . katalog_główny_profilu/samples/bin/BeenThere/buildBeenThere.sh
    Wpisz następującą komendę:

    . katalog_główny_profilu/samples/bin/BeenThere/buildBeenThere.sh

Przykład zostanie zbudowany.

Znajdź plik buildBeenThere.bat lub skrypt buildBeenThere.sh w katalogu katalog_główny_profilu/samples/bin/BeenThere. 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ę programu Ant można znaleźć w serwisie WWW projektu Jakarta.

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

Usuwanie i reinstalowanie pliku BeenThere.ear

Reinstalowanie przykładu polega na wykonaniu następujących kroków:


  1. Uruchom Konsolę administracyjną, otwierając przeglądarkę WWW i przechodząc do adresu http://<nazwa_hosta>:9060/ibm/console, gdzie <nazwa_hosta> jest nazwą hosta lub adresem IP, pod którym działa menedżer wdrażania.
  2. Uruchom Konsolę administracyjną, otwierając przeglądarkę WWW i przechodząc do adresu http://<nazwa_hosta>:9060/ibm/console, gdzie <nazwa_hosta> jest nazwą hosta lub adresem IP, pod którym działa menedżer wdrażania.
  3. Uruchom Konsolę administracyjną, otwierając przeglądarkę WWW i przechodząc do adresu http://<nazwa_hosta>:9080/admin, gdzie <nazwa_hosta> jest nazwą hosta lub adresem IP, pod którym działa menedżer wdrażania.
  4. Uruchom Konsolę administracyjną, otwierając przeglądarkę WWW i przechodząc do adresu http://<nazwa_hosta>:9060/ibm/console, gdzie <nazwa_hosta> jest nazwą hosta lub adresem IP, pod którym działa menedżer wdrażania.
  5. Kliknij opcję Serwery > Klastry.
  6. Wybierz wszystkie klastry.
  7. Kliknij przycisk Zatrzymaj.
  8. Kliknij opcję Aplikacje > Aplikacje korporacyjne.
  9. Wybierz aplikację BeenThere.
  10. Kliknij przycisk Deinstaluj.
  11. Kliknij przycisk Zapisz w górnej części panelu głównego Konsoli administracyjnej.
  12. Kliknij przycisk Zapisz.
  13. Wykonaj kroki wymagane do zainstalowania pliku BeenThere.ear.

Odbudowany plik BeenThere.ear zostanie wdrożony na serwerach aplikacji.