Budowanie przykładu Plants by WebSphere za pomocą narzędzia do budowania 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 i iSeries 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 i iSeries.

Odbudowywanie przykładów dostarczonych w tej galerii

Każdemu nabywcy serwera aplikacji WebSphere Application Server dla platformy z/OS i iSeries 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 lub iSeries 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 utworzyć kopię zapasową katalogu <katalog_główny_profilu>/samples  przed próbą zmodyfikowania lub ponownego zbudowania 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łady są zainstalowane w następujących katalogach:


<katalog_główny_profilu>/samples/src/PlantsByWebSphere Zawiera kod źródłowy dla przykładu Plants by WebSphere.
<katalog_główny_profilu>/samples/lib/PlantsByWebSphere Zawiera pliki Web Archive (WAR), pliki Java Archive (JAR) oraz wynikowy plik PlantsByWebSphere.ear przykładu Plants by WebSphere. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere.
<katalog_główny_profilu>/samples/javadoc/PlantsByWebSphere Zawiera dokumentację Javadoc. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere.
<katalog_główny_profilu>/samples/bld/PlantsByWebSphere Zawiera wygenerowane pliki klas. Tych plików klas należy użyć do wygenerowania pliku wynikowego PlantsByWebSphere.ear. Ten katalog jest tworzony po odbudowaniu przykładu Plants by WebSphere.

Odbudowywanie i instalowanie przykładu

Przykład Plants by WebSphere jest instalowany automatycznie wraz z serwerem WebSphere Application Server. Przykładu Plants by WebSphere nie trzeba budować przed użyciem. Następujące instrukcje zawierają kroki odbudowywania przykładu oraz zawierają informacje dodatkowe pomocne przy ich modyfikowaniu.


Wykonywanie skryptu budowania przykładów
Przekazywanie odbudowanego pliku PlantsByWebSphere.ear
Usuwanie i reinstalowanie pliku PlantsByWebSphere.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/PlantsByWebSphere.
  3. Uruchom skrypt budowania przykładu:

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


    <katalog_główny_profilu>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      <katalog_główny_profilu>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      . <katalog_główny_profilu>/samples/bin/PlantsByWebSphere/buildplantsby.sh

Przykład zostanie zbudowany.

Skrypty buildplantsby.bat oraz buildplantsby.sh znajdujące się w katalogu katalog_główny_profilu/samples/bin/PlantsByWebSphere 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 informacje  W procesie budowania odbudowywane są tylko pliki klas ze zmianami. Pozostałe pliki klas są pakowane ponownie do nowego pliku EAR.

Przekazywanie odbudowanego pliku PlantsByWebSphere.ear

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

  1. Znajdź odbudowany plik EAR w katalogu <katalog_główny_profilu>/samples/lib/PlantsByWebSphere.
  2. Otwórz sesję FTP z serwerem WebSphere Application Server dla platformy z/OS lub iSeries z platformy programistycznej.
  3. Przejdź do katalogu <katalog_główny_profilu>/samples/lib/PlantsByWebSphere
    Może być konieczne wcześniejsze utworzenie tego katalogu, jeśli nie istnieje.
  4. Jeśli plik PlantsByWebSphere.ear istnieje, usuń go, aby umożliwić zapisanie zaktualizowanego pliku.
    Wprowadź komendę del PlantsByWebSphere.ear.
  5. Wprowadź komendę bin.
  6. Wprowadź komendę put PlantsByWebSphere.ear.
  7. Wprowadź komendę quit.

Usuwanie i reinstalowanie pliku PlantsByWebSphere.ear

Domyślnie przykład Plants by WebSphere jest instalowany w katalogu katalog_główny_profilu/installedApps/<nazwa_komórki>, gdzie <nazwa_komórki> jest nazwą 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 Plants by WebSphere:
    1. Wpisz następujące komendy:

      cd <katalog_główny_profilu>\bin
      setupCmdLine

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

      Na platformach z/OS:
      cd <katalog_główny_profilu>/bin
      . ./setupCmdLine.sh

      Na platformach iSeries:
      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('PlantsByWebSphere')" 

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

      Na platformach z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Na platformach iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Reinstalacja przykładu Plants by WebSphere:
    • Przejdź do katalogu katalog_główny_profilu/samples/lib/PlantsByWebSphere.
    • Znajdź plik PlantsByWebSphere.ear.
    • Wpisz następującą komendę:

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

      Na platformach z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      Na platformach iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<węzeł>', '-server', '<serwer>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      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.

 

Odbudowany plik PlantsByWebsphere.ear zostanie wdrożony na serwerze aplikacji.