Sestavení ukázek webových služeb standardu JAX-RPC 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ářů v sestavení ukázek
Opětné sestavení a instalace souboru WebServicesSamples.ear

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 přeinstalovat 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>/samples/src/WebServicesSamples.

Určení struktury adresářů v sestavení ukázek

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

<kořen_profilu>/samples/src/WebServicesSamples Obsahuje zdrojový kód ukázek AddressBook a Stock Quote.
<kořen_profilu>/samples/lib/WebServicesSamples Obsahuje soubory webových archivů (WAR), archivů prostředí Java (JAR) a konečný soubor WebServicesSamples.ear pro ukázky. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace.
<kořen_profilu>/samples/javadoc/WebServicesSamples Obsahuje dokumentaci Javadoc pro ukázky. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace.
<kořen_profilu>/samples/bld/WebServicesSamples Obsahuje generované soubory tříd. Tyto soubory tříd se používají ke generování konečného souboru WebServicesSamples.ear. Tento adresář je vytvořen po opětném sestavení ukázkové aplikace.

Opětné sestavení a instalace souboru WebServicesSamples.ear

Soubor podnikového archivu (EAR) ukázek webových služeb standardu JAX-RCP je k dispozici v případě, že je instalován server WebSphere Application Server. Ukázky není třeba před použitím sestavovat. Následující pokyny popisují kroky opětného sestavení ukázek spolu s dalšími informacemi týkajícími se úprav.

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

Přenos opětně sestaveného souboru WebServicesSamples.ear
Odebrání a opětná instalace souboru WebServicesSamples.ear

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

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/WebServicesSamples.
  3. Spusťte skript pro sestavení ukázky:
  4. Zadejte na příkazový řádek příkaz buildWebServiceSamples.
    • Na vývojových platformách systému Windows zadejte na příkazový řádek příkaz buildWebServiceSamples.
    • Na vývojových platformách systémů UNIX a Linux zadejte na příkazový řádek příkaz buildWebServiceSamples.sh.

Ukázka je nyní sestavena.

Skript buildWebServicesSamples.bat nebo buildWebServicesSamples v adresáři <kořen_profilu>/samples/bin/WebServicesSamples 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 WebServicesSamples.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/WebServicesSamples.
  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/WebServicesSamples.
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

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

Při výchozím nastavení je ukázková aplikace webových služeb standardu JAX-RPC 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, ve které je aplikace instalována. Nainstalujte ukázku znovu podle následujícího popisu:

  1. Zastavte aplikační server.
  2. Odeberte soubor EAR ukázky webových služeb standardu JAX-RPC:
    1. Zadejte následující příkazy:

      cd <kořen_profilu>\bin
      setupCmdLine

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

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

      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('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. Nainstalujte ukázku znovu:
    • Přejděte do adresáře <kořen_profilu>/samples/lib/WebServicesSamples.
    • Vyhledejte soubor WebServicesSamples.ear.
    • Zadejte následující příkaz:

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

Nyní jste znovu sestavili a přeinstalovali ukázkovou aplikaci webových služeb standardu JAX-RPC. Můžete konfigurovat a spustit ukázkové klienty Address Book a Stock Quote.