A Webszolgáltatás varázsló segít a váz komponens létrehozásában
egy meglévő WSDL dokumentumból. A váz komponens a WSDL dokumentumban leírt
műveleteknek megfelelő metódusokat tartalmazza. A komponens létrehozásakor
minden metódusnak egy trivális megvalósítása van, ami a komponens
szerkesztésével cserélhető le.
Előfeltételek:
- Az Apache Jakarta Tomcat kiszolgáló
kisalkalmazás tároló használata esetén ezt először telepíteni kell,
konfigurálni egy példányát és létrehozni egy ehhez készült webprojektet,
az Apache Tomcat kiszolgáló és
webprojekt létrehozása című leírás alapján.
- Hozzon létre, illetve importáljon egy WSDL fájlt a webprojekt
Webtartalom mappájába.
Csak olyan WSDL fájl használható, ami tartalmaz service elemet.
Webszolgáltatás létrehozásához a WSDL fájlból az Apache Axis1
futási környezet segítségével tegye a következőket:
- Váltson a Java EE perspektívára (Ablak > Perspektíva megnyitása
> Java EE).
- A Projektböngésző nézetben jelölje ki a webprojekt Webtartalom
mappájában létrehozott vagy oda importált WSDL fájlt.
- 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.
- Webszolgáltatások oldal: Válassza a Fentről lefelé Java
komponens webszolgáltatás lehetőséget a webszolgáltatás típusaként, majd jelölje ki a műterméket, melyből a szolgáltatás létrehozásra kerül.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Webszolgáltatás váz Java™ Bean konfiguráció oldal: Jelölje ki a mappát
az előállított Java tárolásához. Ha szeretné áttekinteni, illetve szerkeszteni a csomagok
és névtartományok közötti leképezéseket, akkor jelölje be az
Egyéni csomag-névtartomány leképezés meghatározása
jelölőnégyzetet. Kattintson a Tovább gombra.
- Webszolgáltatás névtér - csomag 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 névtér=csomag 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 http://someNamespace=somePackage esetében: http\://someNamespace=somePackage.
Máskülönben a kettőspontot (:) a rendszer határolóként kezelné, és ennek
következtében a http tulajdonságot //valamiNévtér=valamiCsomag értékre próbálná leképezni.
- 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.
- Webszolgáltatás proxy oldal: Ha kiválasztotta a proxy előállítását,
akkor ez az oldal a proxy beállításait jeleníti meg. Felsorolja azokat a mappákat, ahol a proxy előállításra kerül, és nem
kötelezően egyéni leképezéseket hozhat létre névtartományok és csomagok
között. Kattintson a Tovább gombra.
- Webszolgáltatás ügyfél teszt oldal: Az oldalon az alábbi beállításokat választhatja ki:
- 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.
- 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.
- A Teszt futtatása kiszolgálón kijelölése esetén a kiszolgáló automatikusan indításra kerül.
- Webszolgáltatás kiadása oldal: Ha közzé kívánja tenni a
webszolgáltatását egy UDDI nyilvántartásban, akkor ezt az oldalt használhatja a Webszolgáltatás böngésző
indításához és annak az UDDI nyilvántartásnak a kijelöléséhez, ahol a webszolgáltatás közzétételre kerül. Kattintson a Befejezés gombra.
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.