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:
- Az Apache Jakarta Tomcat szervlet
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.
- 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
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:
- 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 forrás mappájában
létrehozott, illetve oda importált komponenst.
- 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: 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.
- 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 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.
- 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.
- 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 válassza ki, hogy személyre kívánja-e szabni a csomag-névtartomány
leképezéseket.
- 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: 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.