Sestavení ukázkové aplikace Plants by WebSphere 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 a iSeries 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 a iSeries.

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 a iSeries 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 nebo iSeries 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>/samples. 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ářů

Ukázky jsou instalovány v následujících adresářích:


<kořen_profilu>/samples/src/PlantsByWebSphere Obsahuje zdrojový kód ukázkové aplikace Plants by WebSphere.
<kořen_profilu>/samples/lib/PlantsByWebSphere Obsahuje soubory webových archivů (WAR), archivů prostředí Java (JAR) a konečný soubor PlantsByWebSphere.ear pro ukázkovou aplikaci Plants by WebSphere. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace Plants by WebSphere.
<kořen_profilu>/samples/javadoc/PlantsByWebSphere Obsahuje dokumentaci Javadoc. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace Plants by WebSphere.
<kořen_profilu>/samples/bld/PlantsByWebSphere Obsahuje generované soubory tříd. Pomocí těchto souborů tříd můžete generovat konečný soubor PlantsByWebSphere.ear. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace Plants by WebSphere.

Opětné sestavení a instalace ukázky

Ukázková aplikace Plants by WebSphere se automaticky instaluje spolu se serverem WebSphere Application Server. Ukázkovou aplikaci Plants by WebSphere není třeba před použitím sestavovat. Následující pokyny popisují kroky opětného sestavení ukázky spolu s dalšími informacemi týkajícími se úprav.


Spuštění skriptu pro sestavení ukázky
Přenos opětně sestaveného souboru PlantsByWebSphere.ear
Odebrání a opětná instalace souboru PlantsByWebSphere.ear

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

Chcete-li tuto ukázku znovu sestavit, ověřte, že je v proměnné prostředí PATH obsažena cesta kořen_profilu/bin. 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/PlantsByWebSphere.
  3. Spusťte skript pro sestavení ukázky:

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


    <kořen_profilu>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      <kořen_profilu>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      . <kořen_profilu>/samples/bin/PlantsByWebSphere/buildplantsby.sh

Ukázka je nyní sestavena.

Skript buildplantsby.bat nebo buildplantsby v adresáři kořen_profilu/samples/bin/PlantsByWebSphere nastaví příslušné informace o cestě ke třídám a spustí obslužný program pro sestavení Ant. Program Ant čte soubory build.xml s popisem postupu při sestavování ukázky. Další dokumentaci k programu Ant naleznete na webovém serveru Jakarta.

Důležité informace Během procesu sestavování jsou znovu sestaveny pouze soubory tříd, které byly změněny. Zbývající soubory tříd jsou vloženy do nového souboru EAR.

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

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

  1. Vyhledejte znovusestavený soubor EAR v adresáři <kořen_profilu>/samples/lib/PlantsByWebSphere.
  2. Otevřete relaci FTP z vývojové platformy na server WebSphere Application Server for z/OS nebo iSeries.
  3. Přejděte do adresáře <kořen_profilu>/samples/lib/PlantsByWebSphere.
    Pokud tento adresář dosud neexistuje, může být třeba jej vytvořit.
  4. V případě, že soubor PlantsByWebSphere.ear existuje, odstraňte jej, aby bylo možno zapsat aktualizovaný soubor.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

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

Při výchozím nastavení je ukázková aplikace Plants by WebSphere instalována do adresáře kořen_profilu/installedApps/<název_buňky>, kde parametr <název_buňky> určuje název buňky s instalovanou aplikací. Nainstalujte ukázku znovu podle následujícího popisu:

  1. Zastavte aplikační server.
  2. Odeberte soubor EAR ukázkové aplikace Plants by WebSphere:
    1. Zadejte následující příkazy:

      cd <kořen_profilu>\bin
      setupCmdLine

      cd <kořen_profilu>/bin
      . ./setupCmdLine.sh

      Na platformách systému z/OS:
      cd <kořen_profilu>/bin
      . ./setupCmdLine.sh

      Na platformách systému iSeries:
      cd <kořen_profilu>/bin
      . ./setupCmdLine

      kde <kořen_profilu> představuje instalační adresář profilu.
    2. Pomocí následujícího příkazu provedete odinstalaci aplikace (v proměnné prostředí PATH musí být uvedena cesta kořen_profilu/bin):

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

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

      Na platformách systému z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      Na platformách systému iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Nainstalujte ukázkovou aplikaci Plants by WebSphere znovu:
    • Přejděte do adresáře kořen_profilu/samples/lib/PlantsByWebSphere.
    • Vyhledejte soubor PlantsByWebSphere.ear.
    • Zadejte následující příkaz:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<uzel>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      kde <uzel> představuje název uzlu a <server> název serveru, na který jsou ukázky instalovány.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<uzel>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      kde <uzel> představuje název uzlu a <server> název serveru, na který jsou ukázky instalovány.

      Na platformách systému z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<uzel>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      Na platformách systému iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<uzel>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      kde <uzel> představuje název uzlu a <server> název serveru, na který jsou ukázky instalovány.
  4. Spusťte aplikační server.

 

Opětně sestavený soubor PlantsByWebsphere.ear je nyní implementován na aplikačním serveru.