Sestavení ukázek webových služeb JAX-WS pomocí nástroje pro sestavení Ant


Přenositelnost prostředí J2EE
Opětné sestavení ukázek webových služeb JAX-WS
Zahájení práce
Určení struktury adresářů v sestavení ukázek
Opětné sestavení a přeinstalace souboru JaxWSServicesSamples.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 operačních systémech, jako je například AIX nebo Linux, 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 JAX-WS

Každý zákazník používající produkt 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. Je zde však jeden rozdíl. Při klepnutí na volbu název_ukázky > Sestavení pomocí nástroje Ant > platforma > Opětné sestavení a instalace souboru se zobrazí pokyny k opětnému sestavení souboru EAR pro příslušnou platformu. Vzhledem k tomu, že textové soubory v souboru EAR  (například soubory XML, XMI, JSP (JavaServer Pages)) 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ázkových aplikací. Na panelu Instalace ukázkových aplikací vyberte volbu Instalovat ukázkové aplikace.

Před pokusem o úpravu nebo opětné sestavení ukázek vytvořte záložní kopii adresáře <kořen_profilu>/samples/src/JaxWSServicesSamples.

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

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

Soubor podnikového archivu (EAR) ukázek webových služeb JAX-WS je k dispozici v případě, že je instalován produkt 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 JaxWSServicesSamples.ear
Odebrání a přeinstalace souboru JaxWSServicesSamples.ear

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

Chcete-li znovu sestavit soubor EAR ukázek webových služeb JAX-WS, proveďte následující kroky:

  1. Ověřte, že je v proměnné PATH obsažena cesta <kořen_profilu>/bin.
  2. Přejděte do adresáře <kořen_profilu>/samples/src/JaxWSServicesSamples.
  3. Spusťte skript pro sestavení ukázek.
    • Na platformách systému Windows zadejte na příkazový řádek příkaz buildJaxWSSamples.
    • Na platformách, jako je například AIX nebo Linux, zadejte na příkazový řádek příkaz buildJaxWSSamples.sh.

Ukázka je nyní sestavena.

Skripty buildJaxWSSamples jsou umístěny v adresáři <kořen_profilu>/bin. 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 obslužnému programu Ant naleznete na webovém serveru Apache Ant.

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 JaxWSServicesSamples.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/JaxWSServicesSamples.
  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/JaxWSServicesSamples.
  4. Odstraňte existující soubor JaxWSServicesSamples.ear. Zadejte příkaz: del JaxWSServicesSamples.ear
  5. Chcete-li soubor přenést v binárním formátu, zadejte příkaz: bin
  6. Přesuňte znovusestavený soubor JaxWSServicesSamples.ear z vývojové platformy na cílový aplikační server. Zadejte příkaz: put JaxWSServicesSamples.ear
  7. Ukončete relaci FTP. Zadejte příkaz: quit.

Odebrání a přeinstalace souboru JaxWSServicesSamples.ear

Při výchozím nastavení je ukázková aplikace webových služeb JAX-WS 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ázky webových služeb JAX-WS:
    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('JaxWSServicesSamples')" 

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

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

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

  3. Nainstalujte ukázku znovu:
    • Přejděte do adresáře <kořen_profilu>/samples/lib/JaxWSServicesSamples.
    • Vyhledejte soubor JaxWSServicesSamples.ear.
    • Zadejte následující příkaz:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<uzel>', 
                  '-server', '<server>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<uzel>', 
                  '-server', '<server>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<uzel>', 
                  '-server', '<server>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<uzel>', 
                  '-server', '<server>' ] )"
                
      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 JAX-WS. Můžete konfigurovat a spustit klienty ukázek Ping, Echo a MTOM.