Ne használjon WebLogic webszolgáltatás telepítési leírót

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 web-services.xml fájl jelenléte
• Az ugyanazon mappában található weblogic-webservices.xml és webservices.xml fájl jelenléte

Gyorsjavítás
A forráselemzőben ez a szabály Ant parancsfájlt állít elő specifikus IBM(R) Ant feladatokkal. Ezen feladatok olyan JAX-RPC webszolgáltatásokat készítenek, melyek a WebLogic J2EE webszolgáltatás-telepítésleírókra épülnek. A gyorsjavítás elemzi a webszolgáltatások telepítési leíróit és Ant parancsfájlt állít elő, ha nincs IBM Ant által előállított parancsfájl a projekt gyökérmappájában. A parancsfájl IBM Ant feladatokat tartalmaz a JAX-RPC webszolgáltatások készítéséhez.

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 : 
  Az előállításra kerülő új Ant parancsfájl nevét határozza meg. A parancsfájl nevének érvényes fájlnévnek kell lennie. Az érték nem tartalmazhat sima vagy fordított osztásjeleket. Az előállított parancsfájl a projekt gyökérmappájában kerül majd elhelyezésre.
  Alapértelmezett érték: build-ibm-ws.xml
  
  
• Előállítási mappa neve:
  Azon mappának a nevét határozza meg, melyben az előállított műtermékek kerülnek elhelyezésre. Az érték nem tartalmazhat sima vagy fordított osztásjeleket. Az előállítási mappa a projekt gyökérmappájában helyezkedik majd el.
  Alapértelmezett érték: ibm-ws-gen
  

Ant osztályútvonal
Az Ant osztályútvonal az Eclipse projektből kerül meghatározásra. Fontos ellenőrizni, hogy a fordításhoz szükséges valamennyi elem szerepeljen az Eclipse osztályútvonalon.

A web-services.xml fájlban meghatározott JAX-RPC szolgáltatások
A web-services.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, valamint potenciális módon további Java kód kerül előállításra, mely a webszolgáltatás-végpont felületét ábrázolja.

• Támogatott komponensek 
  Csak az állapot nélküli munkamenet típusú EJB- (<stateless-ejb>) és Java(R) komponensek (<java-class>) ismerhetők fel és alakíthatók át.
• Állapot nélküli EJB-komponensek:
  Az <ejb-link> elem path attribútumában meghatározott Enterprise JavaBeans(TM) (EJB) JAR fájlnak léteznie kell a projektben. A gyorsjavítás elemzi az EJB JAR fájlt és a távoli EJB osztály alapján előállít egy új szolgáltatásvégpont-felület (SEI) osztályt.
  A SEI felületek abban a tekintetben különböznek a távoli EJB felületektől, hogy az osztálynak a java.rmi.Remote felületet kell kiterjesztenie, a metódusok mindegyikének pedig a java.rmi.RemoteException kivételt kell dobnia.
  A gyorsjavítás Java tükrözést használ az EJB távoli felületén az új SEI előállításához.  Ennélfogva, az Eclipse projekt osztályútvonalát be kell állítani az összes szükséges osztállyal, JAR fájllal, mappával, stb., hogy a gyorsjavítás hibátlanul betölthesse az EJB távoli osztályt.
  A SEI felület a felhasználó által a szabálytulajdonságok között megadott előállítási mappán belül, az azonos nevű sei mappában kerül előállításra.  A SEI csomag megegyezik a távoli EJB felület csomagjával, a SEI neve pedig ugyanaz lesz, mint a távoli EJB felület neve, melyhez csupán a SEI szó kerül hozzáfűzésre.  Ezenkívül az új SEI mappa hozzáadásra kerül a projekt osztályútvonalához.
  
  
• Java osztálykomponensek:
  Az EJB komponensekhez hasonlóan a gyorsjavítás a <class-name> attribútumban meghatározott Java osztályból is előállít egy szolgáltatásvégpont-felületet.
  
  
• 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 azon új SEI felület alapján történő előállítása érdekében, mely a gyorsjavítás futtatása során kerül létrehozásra.
  A WSDL előállítási cél neve genWSDL_ssss lesz, ahol ssss a <web-service> elem name attribútummezőjében megadott JAX-RPC szolgáltatás neve.
  A szolgáltatás-előállítási célok genService_pppp névvel rendelkeznek, ahol pppp a <stateless-ejb> vagy <java-class> elem name attribútumából származó komponens neve.
  A gyorsjavítás nem használja fel az egyéb elemek, így például a <handlers-chain>, <types>, <operations>, <security> stb. elem által biztosított információkat.
  

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 JAX-RPC 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 előállítási cél csak akkor kerül előállításra, ha a gyorsjavítás nem találja a WSDL fájlt a <wsdl-file> elemben szereplő meghatározás szerint.
  Ha létrehozásra kerül, akkor a WSDL előállítási cél neve genWSDL_ssss lesz, ahol ssss a szolgáltatás neve a <webservice-description-name> elemben szereplő meghatározás szerint.
  A szolgáltatás-előállítási célok genService_pppp névvel rendelkeznek majd, ahol pppp a port neve a <port-component-name> elemben szereplő meghatározás szerint.
  

IBM WebSphere Application Server Ant feladatai
A WebSphere(R) Application Server a java2wsdl és wsdl2java feladathoz hasonló Ant feladatokat tartalmaz a JAX-RPC szolgáltatások számára szükséges műtermékek előállításához. Az előállított Ant parancsfájl ezen feladatok segítségével állítja össze a szolgáltatást.
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 a gyorsjavítás előállította az Ant parancsfájlt, tekintse meg azt, majd szükség szerint végezze el benne a további egyéni beállításokat. Tekintse meg az Alkalmazáskiszolgáló dokumentációját az IBM Ant feladatok további személyre szabásáról. A parancsfájlt a WebSphere Application Server termék részét képező Ant eszközökkel kell futtatni.  Az IBM Ant parancsfájl a következőből 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

Az Ant célok futtatásakor az előállított műtermékek az előállítási mappában helyezkednek el. A felhasználó ezután megvizsgálhatja az előállított kódot és a telepítésleírókat, majd hozzáadhatja ezeket a műtermékeket azok megfelelő moduljához.