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

Kézi megoldás
A JAX-RPC webszolgáltatások generálásához a WebLogic J2EE webszolgáltatás-telepítési leírók alapján kézzel kell létrehozni egy Ant szkriptet, amelyhez speciális IBM® Ant feladatokat. A szkriptet hozzá kell adni a projekt gyökérmappájához, ha a IBM Ant -generált fájl még nem létezik. Ezek a feladatok a JAX-RPC webszolgáltatások generálását a telepítési leírásokból.

Szabálytulajdonságok
A szabály tulajdonságainak helyes értékeit kell megadnia, hogy az elemzés során pontos eredményeket kapjon. Ezeket a tulajdonságokat felül kell vizsgálni és megfelelően konfigurálni az alkalmazás kontextusa alapján. A szabályhoz tartozó tulajdonságok a következők:

• Előállított Ant parancsfájl neve : 
  Megadja a generált új Ant szkript nevét.  A szkript 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 szkript a projekt gyökérmappájában lesz.
  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:
  A Enterprise JavaBeans (TM) (EJB) JAR-fájl, ahogyan azt az elérési út attribútumában a <ejb-link> elem által meghatározott fájlnak léteznie kell a projektben. Az automatikus javítás beolvassa az EJB JAR fájlt, és létrehoz egy új Service Endpoint Interface-t (SEI) osztályt az EJB távoli osztálya alapján.
  A SEI felületek eltérnek az EJB távoli felületektől abban, hogy az osztálynak ki kell terjednie java.rmi.Remote és az egyes metódusok kivételt kell dobniuk, java.rmi.RemoteException .
  Az automatikus javítás a Java reflexiót használja az EJB-n távoli interfészen keresztül generálja az új SEI-t . Ezért győződjön meg róla, hogy a Eclipse projektjének classpath-ja tartalmazza a következőket az összes szükséges osztályt, JAR fájlt és könyvtárat az EJB távoli osztály sikeres betöltéséhez.
  A SEI-t az sei mappában kell létrehozni, a következő mappában a generációs mappában, ahogyan azt a felhasználó a szabályban megadja properties.  A SEI csomag megfelel az EJB távoli interfészének csomaggal, és az SEI neve megegyezik az EJB távoli interfész nevével sEI szóval kiegészítve.  Ezen felül az új SEI mappa hozzáadódik a projekt osztály elérési útvonalához.
  
  
• Java osztálykomponensek:
  Az EJB komponensekhez hasonlóan az automatikus javítás is létrehoz egy Service Endpoint Interface-t a Java osztályból, amely az <class-name> attribútumban van definiálva.
  
  
• Előállított Ant célok:
  A generált Ant szkript a következő célokat tartalmazza a WSDL fájl és a JAX-RPC szolgáltatás generálására az új SEI alapján, amelyet létrehozandó SEI alapján.
  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.
  Az automatikus javítás nem használja fel a megadott információkat más elemekben, például <handlers-chain>, <types>, <operations>, <security> és így tovább.
  

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 generálási cél csak akkor generálódik, ha nem találja az elemben definiált WSDL-fájlt, <wsdl-file>.
  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 elkészítette a Ant szkriptet, tekintse meg a szkriptet, és szükség esetén adjon hozzá további testreszabá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.