JAX-RPC webszolgáltatások - példák összeépítése az Ant eszköz segítségével


J2EE hordozhatóság
A példatárban szereplő példák újraépítése
Kezdeti lépések
A példák könyvtárszerkezetének azonosítása
A WebServicesSamples.ear fájl újraépítése és újratelepítése

J2EE hordozhatóság

A J2EE platformon végzett alkalmazásfejlesztés egyik legnagyobb előnye a hordozhatóság. A példatárban található összes program munkaállomásokon készült, mégis egyetlen Java programsor módosítása nélkül futtatható z/OS rendszereken. J2EE alkalmazások Intel vagy UNIX rendszereken történő fejlesztésével a programozók kiküszöbölhetik az EBCDIC-ASCII fájlátalakítások nehézségeit.  Az eszközök elérhetősége a fejlesztők számára lehetővé teszi, hogy fejlesztő munkaállomáson írják és teszteljék, majd z/OS platformokra telepítsék az enterprise archive (EAR) fájlt.

A példatárban lévő példák újraépítése

Minden WebSphere Application Server (alkalmazáskiszolgáló) for z/OS vásárlóknak joga van az alkalmazáskiszolgáló használatához több platformon. Ha a WebSphere alkalmazáskiszolgáló alapterméket és a példákat a csomag által támogatott platformok bármelyikén telepíti, akkor ugyanazt a példatárat fogja látni. Ez alól az egyetlen kivétel, amikor a példa_neve > Összeépítés Ant segítségével > platform > A sample.ear fájl újraépítése és telepítése lehetőségre kattint; ilyenkor az adott platformra vonatkozó útmutatásokat kapja az EAR fájl összeépítéséhez.  Mivel az EAR fájlban található szövegfájloknak (XML, xmi, JavaServer Pages (JSP) oldalak, stb.) ASCII formátumban kell lennie, ezért egyszerűbb ezeket a fájlokat ASCII gépen szerkeszteni.  Ha módosításokat eszközöl egy ASCII gépen, akkor az eredményül kapott EAR fájlt EBCDIC-ASCII átalakítás nélkül újratelepítheti z/OS platformon. 

Kezdeti lépések

Telepítse a WebSphere Application Server kiszolgálót tetszőleges osztott platformon, és jelezze az Alkalmazáskiszolgáló példaalkalmazások telepítését is.

Készítsen biztonsági másolatot a <profil_gyökér>/samples/src/WebServicesSamples könyvtárról a példák módosításának vagy újraépítésének megkísérlése előtt.

A példa összeépítés könyvtárszerkezetének azonosítása

A példák az alábbi könyvtárakba vannak telepítve:

<profil_gyökér>/samples/src/WebServicesSamples A példa forráskódot tartalmazza az AddressBook és a Stock Quote példákhoz.
<profil_gyökér>/samples/lib/WebServicesSamples A példák Web archív (WAR) fájljait, a Java archív (JAR) fájljait és a végső WebServicesSamples.ear fájlját tartalmazza. A könyvtár a példa újraépítése után jön létre.
<profil_gyökér>/samples/javadoc/WebServicesSamples A példák Javadoc dokumentációját tartalmazza. A könyvtár a példa újraépítése után jön létre.
<profil_gyökér>/samples/bld/WebServicesSamples Az előállított osztályfájlokat tartalmazza. Ezek az osztályfájlok szükségesek a végső WebServicesSamples.ear fájl előállításához. A könyvtár a példa újraépítése után jön létre.

A WebServicesSamples.ear fájl újraépítése és újratelepítése

A JAX-RPC webszolgáltatások - példák Enterprise Archive (EAR) fájl a WebSphere alkalmazáskiszolgáló telepítésekor biztosított. A példákat nem kell összeépíteni használatuk megkezdése előtt. Az alábbi utasítások leírják a példák újraépítésének lépéseit a módosításukra vonatkozó kiegészítő információkkal együtt.

A példa-összeépítési parancsfájl futtatása

Az újraépített WebServicesSamples.ear fájl átvitele
A WebServicesSamples.ear fájl eltávolítása és újratelepítése

A példa-összeépítő parancsfájl végrehajtása

A példa újraépítéséhez ellenőrizze, hogy a <profil_gyökér>/bin szerepel a PATH környezeti változóban. Tegye a következőket a példa-összeépítési parancsfájl futtatásához, amely így összeépíti a példát:

  1. Parancssor megnyitása.
  2. A parancssorban váltson a <profil_gyökér>/samples/src/WebServicesSamples könyvtárra.
  3. Futtassa le a példaösszeépítési parancsfájlt:
  4. Írja be a buildWebServiceSamples utasítást a parancssorba.
    • Windows fejlesztési környezetben írja be a buildWebServiceSamples.bat utasítást a parancssorba.
    • UNIX és Linux fejlesztési környezetben írja be a buildWebServiceSamples utasítást a parancssorba.

Ekkor a példa összeépítésre kerül.

A buildWebServicesSamples.bat és a buildWebServicesSamples.sh parancsfájl a <profil_gyökér>/samples/bin/WebServicesSamples könyvtárban beállítja a megfelelő osztályútvonal információkat és végrehajtja az Ant összeépítési segédprogramot. Az Ant beolvassa a build.xml fájlokat, amelyek leírják hogyan kell a példát összeépíteni. Az Ant további leírása a Jakarta webhelyen található.

Fontos információk Az összeépítési folyamat alatt csak a változtatásokat tartalmazó osztályfájlok épülnek újra. A hátralévő osztályfájlok újra lesznek csomagolva az új EAR fájlba.

Az újraépített WebServicesSamples.ear fájl átvitele

Használja a Fájlátviteli protokollt (FTP) a bináris EAR fájl átvitelére a z/OS kiszolgálóra az alábbi útmutatások segítségével.

  1. Keresse meg az újraépített EAR fájlt a <profil_gyökér>/samples/lib/WebServicesSamples könyvtárban
  2. Nyisson meg egy FTP szekciót a WebSphere Application Server for z/OS számára a fejlesztési platformról
  3. Váltson át a <profil_gyökér>/samples/lib/WebServicesSamples könyvtárra
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

A WebServicesSamples.ear fájl eltávolítása és újratelepítése

Alapértelmezésben a JAX-RPC webszolgáltatások példa a <profil_gyökér>/installedApps/<cella neve> könyvtárba települ, ahol a <cella neve> annak a cellának a neve, ahova az alkalmazás telepítve van. A példa újratelepítésének lépeseit az alábbi leírás tartalmazza:

  1. Állítsa le az alkalmazáskiszolgálót.
  2. Távolítsa el a JAX-RPC webszolgáltatások példa EAR fájlját:
    1. Írja be a következő parancsokat:

      cd <profil_gyökér>\bin
      setupCmdLine

      cd <profil_gyökér>/bin
      . ./setupCmdLine.sh

      cd <profil_gyökér>/bin
      . ./setupCmdLine.sh

      cd <profil_gyökér>/bin
      . ./setupCmdLine

      ahol a <profil_gyökér> a profil telepítési könyvtárát jelenti.
    2. Írja be a következő parancsot az alkalmazás eltávolításához (a <profil_gyökér>/bin elérési útnak szereplenie kell a PATH változóban):

      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. Telepítse újra a példát:
    • Váltson át a <profil_gyökér>/samples/lib/WebServicesSamples könyvtárra
    • Keresse meg az WebServicesSamples.ear fájlt
    • Írja be a következőket:

      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>', '-deployejb' ] )"
                
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>', '-deployejb' ] )"
                
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>', '-deployejb' ] )"
                
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.
      wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>', '-deployejb' ] )"
                
      ahol a <csomópont> a csomópont neve, a <kiszolgáló> pedig annak a kiszolgálónak a neve, ahova a példát telepíteni kell.
  4. Indítsa el az alkalmazáskiszolgálót.

Ezzel újraépítette és újratelepítette a JAX-RPC webszolgáltatások - példák alkalmazást. Beállíthatja és futtathatja az Address Book és a Stock Quote példa ügyfeleket.