Webszolgáltatás létrehozása Java bean komponensből az Apache Axis1 futási környezet segítségével

A Webszolgáltatás varázsló segítséget nyújt az új webszolgáltatás létrehozásához, a telepítéshez történő konfigurálásához, valamint a webszolgáltatás telepítéséhez a kiszolgálóra. Miután telepítette a webszolgáltatást, a varázsló segít az ügyfél proxy és minta alkalmazás előállításában a webszolgáltatás teszteléséhez. Miután befejezte a tesztelést, az Exportálás varázsló segítségével közzéteheti a webszolgáltatást egy UDDI vállalati nyilvántartásba.

Előfeltételek:
  1. Komponens létrehozása vagy importálása a webprojekt Java™ forrásmappájába. Az importáláshoz válassza a Java erőforrások: src mappát, a fájl menüben pedig válassza ki az Importálás > Általános > Fájlrendszer menüpontot, majd tallózzon a csomag helyéhez.
Webszolgáltatás létrehozásához bean komponensből az Apache Axis1 futási környezet segítségével, tegye a következőket:
  1. Váltson a Java EE perspektívára (Ablak > Perspektíva megnyitása > Java EE).
  2. A Projektböngésző nézetben jelölje ki a webprojekt forrás mappájában létrehozott, illetve oda importált komponenst.
  3. Kattintson a Fájl > Új > Egyéb menüpontra. A megjelenő ablakban látható listában válassza a Webszolgáltatások elemet a különböző webszolgáltatás varázslók megjelenítéséhez. Válassza ki a Webszolgáltatás varázslót. Kattintson a Tovább gombra.
  4. Webszolgáltatások oldal: Webszolgáltatás típusaként válassza a Lentről felfelé Java komponens webszolgáltatás lehetőséget, majd adja meg az egységes erőforrás azonosítót (URI) a szolgáltatás előállításához felhasználásra kerülő WSDL, WSIL vagy HTML fájlhoz.
    1. A csúszka segítségével válassza ki azokat a webszolgáltatás fejlesztési szakaszokat, amelyeket végre kíván hajtani:
      • Fejlesztés: fejleszti a WSDL meghatározásokat és a webszolgáltatás megvalósítását. Ez olyan feladatokat foglal magában, mint például az előállított kódot, WSDL fájlokat, telepítési leírókat és megfelelő esetben Java fájlokat tartalmazó modulok létrehozása.
      • Összeállítás: biztosítja azt a projektet, mely futási környezetet nyújt az EAR számára a cél alkalmazáskiszolgáló kérése esetén társításra kerülő webszolgáltatásnak vagy ügyfélnek.
      • Bevezetés: ez létrehozza a bevezetési kódot a szolgáltatáshoz.
      • Telepítés: telepíti és beállítja a webmodult és az EAR fájlokat a célkiszolgálóra.
      • Indítás: ez elindítja a kiszolgálót, miután a szolgáltatás telepítve lett rá. A server-config.wsdd fájl előállításra kerül.
      • Tesztelés: ez különféle lehetőségeket biztosít a szolgáltatás tesztelésére, például a Webszolgáltatás böngésző vagy a minta JSP-k használatára.
    2. Válassza ki az alapértelmezett kiszolgálót: Megjelenik az alapértelmezett kiszolgáló. Ha egy másik kiszolgálóra kívánja bevezetni a szolgáltatást, akkor kattintson a hivatkozásra egy másik kiszolgáló megadásához.
    3. Válassza ki a futási környezetet: az alapértelmezett futási környezet jelenik meg. Ha egy másik futási környezetbe kívánja bevezetni a szolgáltatást, akkor kattintson a hivatkozásra egy másik futási környezet megadásához.
    4. Válassza ki a szolgáltatás projektet: a munkaterületen kijelölt projektet tartalmazó projekt jelenik meg. Másik projekt és EAR kiválasztásához kattintson a projekt hivatkozásra. Győződjön meg róla, hogy az ügyfél webprojekt nem azonos a szolgáltatás webprojekttel, ugyanis ellenkező esetben a szolgáltatást felülírják az ügyfél számára létrehozott fájlok.
    5. Ha ügyfelet kíván létrehozni, akkor válassza ki az előállítani kívánt proxy típusát,és ismételje meg a fenti lépéseket az ügyfélre.
    6. Tegye közzé a webszolgáltatást: Ez elindítja a Webszolgáltatás böngészőt a webszolgáltatás közzétételéhez egy UDDI nyilvántartásba.
    7. Figyelje meg a webszolgáltatást: ez forgalmat küld a enak a TCP/IP monitoron keresztül, ami lehetővé teszi a webszolgáltatás által előállított SOAP forgalom megfigyelését és a forgalom vizsgálatát a WS-I megfelelés szempontjából. Alternatív megoldásként kézileg beállíthat egy TCP/IP monitort a Webszolgáltatások tesztelése TCP/IP monitor segítségével részben leírtak szerint.
  5. Webszolgáltatás Java komponens azonosság oldal: a webszolgáltatás WSDL neve kerül felsorolásra. Az alábbi lehetőségei vannak:
    • Válassza ki az exponálandó metódusokat.
    • Válassza ki a kódolási stílust. Az Axis futási környezethez az RPC/Encoded az ajánlott kódolási stílus. Ez a kódolási módszer nem felel meg a WS-I szabványnak.
    • Válassza ki, hogy személyre kívánja-e szabni a csomag-névtartomány leképezéseket.
    Kattintson a Tovább gombra.
  6. Webszolgáltatás csomag - névtér leképezések oldal: ha bejelölte az Egyéni csomag-névtér leképezések meghatározása jelölőnégyzetet az előző panelen, akkor ezen a panelen írhatja be az egyéni leképezési párokat a Hozzáadás gombra kattintva. Ennek alternatívájaként az Importálás lehetőségre is kattinthat az egyéni leképezési párok .properties fájlból való importálása érdekében. A tulajdonságfájl tartalmának csomag=névtér formátumúnak kell lennie. A tulajdonságfájlokban néhány speciális karaktert vezérlőkarakterekkel kell ellátnia. Például a somePackage=http://someNamespace esetében: somePackage=http\://someNamespace. Máskülönben a kettőspontot (:) a rendszer határolóként kezelné, és ennek következtében a somePackage csomagot a http értékre próbálná leképezni.
  7. Webszolgáltatás tesztelése oldal: Ha kiválasztotta a webszolgáltatás tesztelését, akkor válassza ki a tesztelő szolgáltatást az előállított webszolgáltatáshoz. Ez megnyitja a webszolgáltatást a Webszolgáltatás böngészőben. Válassza ki a tesztelni kívánt műveletet, írja be a szükséges információkat, és kattintson a Mehet gombra. Az eredmény az Állapot panelen jelenik meg. Kattintson a Tovább gombra.
  8. Webszolgáltatás proxy oldal: Ha kiválasztotta a proxy előállítását, akkor válassza ki, hogy személyre kívánja-e szabni a csomag-névtartomány leképezéseket.
  9. Webszolgáltatás ügyfél teszt oldal: Az oldalon az alábbi beállításokat választhatja ki:
    1. Tesztszolgáltatás kijelölése. Az előállított proxy tesztelhető a Webszolgáltatás böngészőben, vagy előállíthat egy minta webszolgáltatás JSP-t.
    2. Ha a proxy JSP fájlon keresztüli tesztelését választotta, akkor megadhatja a mappát, ahová a JSP fájl kerüljön, továbbá megadhatja a JSP fájlba foglalandó metódusokat.
    3. A Teszt futtatása kiszolgálón kijelölése esetén a kiszolgáló automatikusan indításra kerül.
  10. Webszolgáltatás kiadása oldal: Válassza ki, hogy közzé akarja-e tenni ezt a webszolgáltatást egy UDDI nyilvántartásba. Kattintson a Befejezés gombra.  Megjegyzés: megjelenhet a Hiba WSDL előállítása során. ClassNotFound: <komponens neve>. Ez a hiba nyugodtan figyelmen kívül hagyható.
A webszolgáltatás létrehozása után az alábbiak történhetnek a kiválasztott beállításoktól függően:
  • Ha a létrehozott proxy teszteléséhez a webszolgáltatás JSP oldalakat választotta, akkor a proxy indításához írja be böngészőjébe a következő címet: http://helyihoszt: port/ WebProjektClient/sampleKomponensNeve/ WebSzolgáltatásNeve/TestClient.jsp. Ezzel a példaalkalmazással úgy tesztelheti a webszolgáltatást, hogy kiválaszt egy metódust, megad neki egy értéket, majd a Meghívás gombra kattint. A metódus által visszaadott érték az Eredmények panelen jelenik meg.
  • Ha a webszolgáltatás teszteléséhez a Webszolgáltatás böngészőt választotta, akkor megnyílik a böngésző. Válassza ki a tesztelni kívánt műveletet, írja be a szükséges információkat, és kattintson a Mehet gombra. Az eredmény az Állapot panelen jelenik meg.
  • Ha a webszolgáltatás közzétételét választotta, akkor elindul a Webszolgáltatás böngésző és megjelenik a webszolgáltatás közzétételéhez szükséges oldal. Kövesse a Webszolgáltatás közzététele útmutatásait a feladat végrehajtásához.

Fontos: Ha a metódusok a minta által nem támogatott típusokat, például tömböket, indexelt tulajdonságokat és kollekciókat tartalmaznak, akkor a metódusok kimaradnak a mintából és figyelmeztető üzenetet kap.

Kapcsolódó fogalmak
Webszolgáltatások létrehozása Apache Axis1 futási környezettel