Ajánlás: JAX-WS-re való áttérés megfontolása
Ha a migrációs vagy modernizációs erőfeszítések részeként már változtatásokat hajt végre a JAX-RPC webszolgáltatásokon, erősen javasoljuk, hogy vizsgálja meg az áttérést a JAX-WS ( Java API for XML Web Services).

A JAX-WS a JAX-RPC utódja, és számos előnyt kínál:

A JAX-WS-re való áttérés most csökkentheti a jövőbeli technikai adósságot, és összehangolhatja az alkalmazást a jelenlegi Java webszolgáltatási szabványokkal.

A JAX-RPC-ről a JAX-WS-re történő áttéréssel kapcsolatos útmutatást a Webszolgáltatások migrációs forgatókönyvek: JAX-RPC-ről JAX-WS-re és JAXB dokumentáció.

Ne használjon JBoss webszolgáltatás-telepítésleírót
Ez a szabály megjelöl bármely meglévő webservices.xml fájlt, hogy észlelje egy JBoss J2EE webszolgáltatás-telepítésleíró fájl jelenlétét.

JAX-RPC webszolgáltatások generálása a JBoss Java Platform, Enterprise Edition ( Java EE ) webszolgáltatás-telepítési leírások alapján, az automatikus javítás létrehoz egy Ant szkriptet, amely a megfelelő IBM Ant feladatokat használja. Ez magában foglalja a webszolgáltatások telepítésének átvizsgálását leírók és a Ant szkript konfigurálása a szükséges leletek létrehozásához.


A szabály aktiválásának feltételei:
Ez a szabály az alábbi feltételek teljesülése alapján ismeri fel a JAX-RPC webszolgáltatások jelenlétét:
a. A J2EE web services telepítési leíró fájl megléte webservices.xml
b. A bináris szkenner észleli, hogy a IBM Ant generált fájl még nem létezik a projekt gyökérmappájában.

Szabálytulajdonságok:
Helyes értéket kell megadnia a szabálytulajdonságok számára. A szabályhoz tartozó tulajdonságértékek módosításához válassza ki a szabályt a Software Analyzer konfigurációk ablakban. Ezután használja a Tulajdonságok lapon található mezőket. A szabályhoz tartozó tulajdonságok a következők:
  • Előállított Ant parancsfájl neve : 
    Ez a neve az új Ant szkriptnek, amely generálásra kerül.  A fájl névnek egy érvényes fájlnévnek kell lennie.  Az érték nem tartalmazhat előre- vagy hátrafelé irányuló írásjeleket.  A generált fájl a gyökérmappában lesz a projekt mappájában lesz.
    Alapértelmezett érték: build-ibm-ws.xml

  • Előállítási mappa neve:
    Ez annak a mappának a neve, amelybe a generált leletek kerülnek.   Az érték nem tartalmazhat előre- vagy hátrafelé irányuló írásjeleket.  A generálás mappa a projekt gyökérmappájában található.
    Alapértelmezett érték: ibm-ws-gen

Ant osztályútvonal:
A hangya osztályok elérési útvonalát a Eclipse projektből számoljuk ki.  Fontos ellenőrizni, hogy az összes szükséges elemet a fordításhoz szükséges elemek a Eclipse osztályútvonalon vannak.

A webservices.xml fájlban meghatározott JAX-RPC szolgáltatások
A webservices.xml fájlban meghatározott szolgáltatások információi és típusa alapján a JAXRPC szolgáltatás reprodukálása érdekében egy Ant parancsfájl kerül előállításra.

  • Előállított Ant célok:
    Az előállított Ant parancsfájl célokat tartalmaz a WSDL fájl és a JAX-RPC szolgáltatás előállítása érdekében.
    A WSDL generálási cél csak akkor generálódik, ha nem találja meg a WSDL fájlt, ahogyan azt az elemben <wsdl-file>.
    A WSDL generáló tagret (ha létrehozták) a neve: genWSDL_ssss, ahol ssss a szolgáltatás neve a definíció szerint a <webservice-description-name> elemben meghatározott szolgáltatás.
    A szolgáltatásgenerációs célok neve, genService_pppp, ahol pppppp a port neve, ahogyan azt a elem által meghatározott <port-komponens-név>.

IBM WebSphere Application Server Ant feladatai
Az IBM WebSphere(R) Application Server Ant feladatokat tartalmaz (mint például a java2wsdl és a wsdl2java) a JAX-RPC szolgáltatásokhoz szükséges műtermékek előállításához.  Az előállított Ant parancsfájl ezeket a feladatokat használja a szolgáltatás összeállításához. A feladatokról a WebSphere Application Server dokumentációjában talál további információkat.

Az Ant parancsfájl futtatása
Miután az automatikus javítás létrehozta a Ant szkriptet, vizsgálja felül, és adja hozzá a szükséges módosításokat. A WebSphere Application Server dokumentációban talál útmutatást a IBM Ant feladatokhoz. A szkriptet a IBM által biztosított Ant eszközökkel kell futtatnia, amelyek a következők a IBM WebSphere Application Server   A IBM Ant szkript tartalmazza futtatható:
  • Windows(R) operációs rendszereken: WAS_HOME\bin\ws_ant.bat
  • UNIX(R) operációs rendszereken: WAS_HOME\bin\ws_ant.sh
Például: c:\IBM\AppServer\bin\ws_ant.bat -f c:\eclipse\MyProject\ibm-ws-gen.xml genService_TestService

A Ant célprogramok futtatásakor a létrehozott leletek a következő helyen találhatók a generációs mappában található.  A generált kódot, a telepítési leírókat, majd hozzáadhatja ezeket a leletekhez a modulokhoz.