Sestavení ukázky aplikace BeenThere pomocí nástroje pro sestavení Ant


Přenositelnost prostředí J2EE
Opětné sestavení ukázek dodávaných v rámci této galerie
Zahájení práce
Určení struktury adresářů
Opětné sestavení a instalace ukázky

Přenositelnost prostředí J2EE

Jednou z významných výhod vývoje aplikací na platformě J2EE je přenositelnost. Všechny ukázkové programy v galerii ukázek byly vyvinuty na pracovní stanici a spouštěny v systémech z/OS bez nutnosti provedení jakýchkoli změn kódu. Sestavením aplikací prostředí J2EE v systémech s architekturou Intel či v systémech UNIX může vývojář eliminovat nutnost převodu souborů z formátu EBCDIC do formátu ASCII nebo z formátu ASCII do formátu EBCDIC. Dostupnost nástrojů vývojářům usnadňuje vytváření a testování na vývojové pracovní stanici a instalaci souborů podnikových archivů (EAR) v systémech z/OS.

Opětné sestavení ukázek dodávaných v rámci této galerie

Každý zákazník používající aplikační server WebSphere Application Server pro platformu z/OS má nárok na médium s aplikačním serverem pro více platforem. Pokud instalujete základní produkt WebSphere Application Server a ukázky na některé z platforem podporovaných touto sadou programů, zobrazí se stejná galerie. Jedinou výjimkou je situace, kdy se po klepnutí na odkaz název_ukázky > Sestavení pomocí nástroje Ant > platforma > Opětné sestavení a instalace souboru sample.ear zobrazí pokyny k opětnému sestavení souboru EAR pro příslušnou platformu. Vzhledem k tomu, že textové soubory v souboru EAR (soubory XML, XMI, JSP (JavaServer Pages) a další) musí být ve formátu ASCII, je jednodušší upravovat takové soubory v počítači s podporou formátu ASCII. Provedete-li změny v počítači s podporou formátu ASCII, můžete poté výsledný soubor EAR implementovat a instalovat na platformě z/OS bez nutnosti převodu z formátu EBCDIC do formátu ASCII.  



Zahájení práce

Instalujte server WebSphere Application Server na zvolené platformě a vyberte také volbu instalace ukázek aplikačního serveru.

Před pokusem o úpravu nebo opětné sestavení ukázek vytvořte záložní kopii adresáře <kořen_profilu>. Vytvořte soubor ZIP obsahující adresář samples. Extrahováním souboru ZIP můžete obnovit adresář samples v původním stavu.



Určení struktury adresářů

Struktura adresářů ukázky po sestavení je následující:


kořen_profilu/samples/src/BeenThere Obsahuje zdrojový kód ukázky aplikace BeenThere.
kořen_profilu/samples/lib/BeenThere Obsahuje soubor BeenThere.ear pro ukázku aplikace BeenThere.
kořen_profilu/samples/javadoc/BeenThere Obsahuje dokumentaci Javadoc generovanou při sestavování ukázky aplikace BeenThere.
kořen_profilu/samples/bld/BeenThere Obsahuje generované soubory tříd. Pomocí těchto souborů tříd můžete generovat konečný soubor BeenThere.ear. Adresář bld je vytvořen po opětném sestavení ukázky aplikace BeenThere.



Opětné sestavení a instalace ukázky

Následující pokyny popisují kroky opětného sestavení ukázky.


Spuštění skriptu pro sestavení ukázky

Chcete-li spustit skript pro sestavení ukázky, který ukázku znovu sestaví, postupujte podle následujících kroků:

  1. Otevřete příkazový řádek.
  2. Na příkazovém řádku přejděte do adresáře kořen_profilu/samples/src/BeenThere.
  3. Spusťte skript pro sestavení ukázky:

  4. Zadejte následující příkaz:

    kořen_profilu\samples\bin\BeenThere\buildBeenThere.bat

    Zadejte následující příkaz:

    . kořen_profilu/samples/bin/BeenThere/buildBeenThere.sh

    • Na vývojových platformách systému Windows zadejte následující příkaz:

      kořen_profilu\samples\bin\BeenThere\buildBeenThere.bat

    • Na vývojových platformách systémů UNIX a Linux zadejte následující příkaz:

      . kořen_profilu/samples/bin/BeenThere/buildBeenThere.sh
    Zadejte následující příkaz:

    . kořen_profilu/samples/bin/BeenThere/buildBeenThere.sh

Ukázka je nyní sestavena.

Skript buildBeenThere.bat nebo buildBeenThere.sh naleznete v adresáři kořen_profilu/samples/bin/BeenThere. Tyto skripty nastavují odpovídající informace o cestách ke třídám a spouštějí obslužný program pro sestavení Ant. Obslužný program Ant čte soubory build.xml s popisem postupu při sestavování ukázek. Další dokumentaci k programu Ant naleznete na webovém serveru Jakarta.

Přenos opětně sestaveného souboru BeenThere.ear

Prostřednictvím protokolu FTP (File Transfer Protocol) přeneste binární soubor EAR na server z/OS podle následujících pokynů.

  1. Vyhledejte znovusestavený soubor EAR v adresáři <kořen_profilu>/samples/lib/BeenThere.
  2. Otevřete relaci FTP z vývojové platformy na server WebSphere Application Server for z/OS.
  3. Přejděte do adresáře <kořen_profilu>/samples/lib/BeenThere.
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Odebrání a opětná instalace souboru BeenThere.ear

Nainstalujte ukázku znovu podle následujícího popisu:


  1. Spusťte administrativní konzolu otevřením okna webového prohlížeče s adresou http://<název_hostitele>:9060/ibm/console, kde parametr <název_hostitele> určuje název hostitele nebo adresu IP spuštěného správce implementace.
  2. Spusťte administrativní konzolu otevřením okna webového prohlížeče s adresou http://<název_hostitele>:9060/ibm/console, kde parametr <název_hostitele> určuje název hostitele nebo adresu IP spuštěného správce implementace.
  3. Spusťte administrativní konzolu otevřením okna webového prohlížeče s adresou http://<název_hostitele>:9080/admin, kde parametr <název_hostitele> určuje název hostitele nebo adresu IP spuštěného správce implementace.
  4. Spusťte administrativní konzolu otevřením okna webového prohlížeče s adresou http://<název_hostitele>:9060/ibm/console, kde parametr <název_hostitele> určuje název hostitele nebo adresu IP spuštěného správce implementace.
  5. Klepněte na volbu Servery > Klastry.
  6. Vyberte všechny klastry.
  7. Klepněte na tlačítko Zastavit.
  8. Klepněte na volbu Aplikace > Podnikové aplikace.
  9. Vyberte aplikaci BeenThere.
  10. Klepněte na volbu Odinstalovat.
  11. Klepněte na tlačítko Uložit v horní části hlavního panelu v administrativní konzole.
  12. Klepněte na tlačítko Uložit.
  13. Proveďte zbývající kroky postupu Instalace souboru BeenThere.ear.

Opětně sestavený soubor BeenThere.ear je nyní implementován na aplikačních serverech.