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


J2EE hordozhatóság
A JAX-WS webszolgáltatások - példák újraépítése
Kezdeti lépések
A példák könyvtárszerkezetének azonosítása
A JaxWSServicesSamples.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, és egyetlen Java programsor módosítása nélkül futtatható z/OS rendszereken. J2EE alkalmazások Intel, AIX vagy Linux 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 JAX-WS példák újraépítése

Minden WebSphere Application Server (alkalmazáskiszolgáló) for z/OS vásárló jogosult az alkalmazáskiszolgáló többplatformos adathordozójához. 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. Van azonban egyetlen különbség. Ha a példanév > Összeépítés az Ant segítségével > platform > A fájl újraépítése és telepítése lehetőségre kattint, akkor az EAR fájl újraépítésére vonatkozó utasítások platformonként különbözők.  Mivel az EAR  fájlokban található szövegfájloknak (például XML, xmi vagy JavaServer Pages (JSP) fájlok) ASCII formátumban kell lennie, ezért szerkesztésük ASCII gépen könnyebb feladat.  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 terjesztés tetszőleges platformján és jelezze a példaalkalmazások telepítését is. A Példaalkalmazások telepítése panelen válassza a Példaalkalmazások telepítése lehetőséget.

Készítsen egy biztonsági másolatot a <profil_gyökér>/samples/src/JaxWSServicesSamples könyvtárról a példák módosításának vagy újraépítésének megkezdé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:

<profilgyökér>/samples/src/JaxWSServicesSamples A Ping, Echo és MTOM példák forráskódját tartalmazza.
<profilgyökér>/samples/lib/JaxWSServicesSamples A példák Web archív (WAR) fájljait, a Java archív (JAR) fájljait és a végső JaxWSServicesSamples.ear fájlját tartalmazza. A könyvtár a példa újraépítése után jön létre.
<profilgyökér>/samples/javadoc/JaxWSServicesSamples 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.
<profilgyökér>/samples/bld/JaxWSServicesSamples Az előállított osztályfájlokat tartalmazza. Ezek az osztályfájlok szükségesek a végső JaxWSServicesSamples.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 JaxWSServicesSamples.ear fájl újraépítése és újratelepítése

A JAX-WS webszolgáltatások - példák Enterprise Archive (EAR) fájl a WebSphere Application Server telepítésekor jön létre. A példákat nem kell összeépíteni használat 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ő parancsfájl futtatása

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

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

A JAX-WS webszolgáltatások - példák EAR fájl újraépítéséhez tegye a következőket:

  1. Ellenőrizze, hogy a <profilgyökér>/bin szerepel-e a PATH környezeti változóban.
  2. Lépjen be a <profilgyökér>/samples/src/JaxWSServicesSamples könyvtárba.
  3. Futtassa a Példák összeépítési parancsfájlját.
    • Windows platformokon írja be a parancssorba a buildJaxWSSamples parancsot.
    • AIX vagy Linux platformokon írja be a parancssorba a buildJaxWSSamples.sh parancsot.

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

A buildJaxWSSamples parancsfájlok a <profil_gyökér>/bin könyvtárban találhatók. A parancsfájlok beállítják a megfelelő osztály útvonal információkat és elindítják az Ant összeépítési segédprogramot. Az Ant segédprogram olvassa a build.xml fájlokat, amelyek leírják a példák összeépítésének módját. Az Ant segédprogrammal kapcsolatos további dokumentációért látogasson el az Apache Ant webhelyre.

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 JaxWSServicesSamples.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 <profilgyökér>/samples/lib/JaxWSServicesSamples könyvtárban.
  2. Nyisson egy FTP szekciót a WebSphere Application Server for z/OS számára a fejlesztési platformról.
  3. Lépjen be a <profilgyökér>/samples/lib/JaxWSServicesSamples könyvtárba.
  4. Törölje a meglévő JaxWSServicesSamples.ear fájlt. Írja be a parancsot: del JaxWSServicesSamples.ear
  5. A fájl bináris formátumának átviteléhez írja be a következő parancsot: bin
  6. Helyezze át az újraépített JaxWSServicesSamples.ear fájlt a fejlesztési platformról a cél-alkalmazáskiszolgálóra. Írja be a parancsot: put JaxWSServicesSamples.ear
  7. Zárja le az FTP szekciót. Írja be a quit parancsot.

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

Alapértelmezésben a JAX-WS webszolgáltatások példa a <profil_gyökér>/installedApps/<cella neve> könyvtárba települ, ahol s <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-WS 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('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. Telepítse újra a példát:
    • Váltson át a <profil_gyökér>/samples/lib/JaxWSServicesSamples könyvtárra
    • Keresse meg a JaxWSServicesSamples.ear fájlt
    • Írja be a következőket:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<csomópont>', 
                  '-server', '<kiszolgáló>' ] )"
                
      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-WS webszolgáltatások - példák alkalmazást. Konfigurálhatja és futtathatja a Ping, Echo és MTOM példaügyfeleket.