A webszolgáltatás varázsló segít egy új webszolgáltatás létrehozásában,
konfigurálásában és a webszolgáltatás egy kiszolgálóra történő telepítésében. Amint a webszolgáltatás telepítésre került,
a varázsló segít az ügyfélproxy és a mintaalkalmazás előállításában a webszolgáltatás teszteléséhez. Ha befejezte
a tesztelést, akkor az Exportálás varázsló segítségével közzéteheti a webszolgáltatást
egy UDDI Üzleti nyilvántartásban.
Előfeltételek:
- Ha kiszolgálóként az Apache Jakarta Tomcat kiszolgáló kisalkalmazás
tárolóját szeretné használni, akkor telepítse, konfigurálja egy példányát, valamint
készítsen egy ráirányított webprojektet a Apache Tomcat kiszolgáló és webprojekt létrehozása részben leírtak alapján.
- Hozzon létre vagy importáljon egy komponenst a webprojekt Java™ forrásmappájába.
Webszolgáltatás létrehozása komponensből az Apache Axis futási környezet
segítségével:
- Váltson át J2EE perspektívára (Ablak
> Perspektíva megnyitása > J2EE).
- A Projektböngésző nézetben válassza ki azt a komponenst, amelyet létrehozott vagy
a webprojekt forrásmappájába importált.
- 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ás oldal: A webszolgáltatás típusaként válassza ki a Lentről felfelé haladó Java komponens webszolgáltatást, majd
adja meg az URI azonosítót a WSDL, WSIL vagy a HTML fájlhoz, amely a szolgáltatás előállításához
kerül felhasználásra.
- Válassza ki a webszolgáltatás fejlesztés azon szakaszait, amelyeket a
csúszka segítségével szeretne végrehajtani:
- Fejlesztés: a szolgáltatáskódot hozza létre
- Összeállítás:
- Elhelyezés: a szolgáltatás elhelyezési kódját hozza létre
- Telepítés: a kijelölt kiszolgálón telepíti az szolgáltatást
- Indítás: a kiszolgáló indítása, amint a szolgáltatás telepítésre került
rajta
- Tesztelés: a szolgáltatás teszteléséhez számos beállítást biztosít
- Kiszolgáló kiválasztása: az alapértelmezett kiszolgáló kerül megjelenítésre. Ha a szolgáltatást
egy másik kiszolgálón szeretné elhelyezni, akkor egy eltérő kiszolgáló megadásához
kattintson a hivatkozásra.
- Futási környezet kiválasztása: az alapértelmezett futási környezet kerül megjelenítésre. Ha a szolgáltatást
egy másik futási környezeten szeretné elhelyezni, akkor egy eltérő futási környezet megadásához
kattintson a hivatkozásra.
- Szolgáltatás projekt kiválasztása: a munkaterületen kiválasztott projektet tartalmazó
projekt kerül megjelenítésre. Egy eltérő projekt és
EAR kiválasztásához kattintson a projekt hivatkozására. Győződjön meg róla, hogy az ügyfél web
projekt nem azonos a szolgáltatás web projekttel, ellenkező esetben
ugyanis a szolgáltatást felülírják az ügyfél számára létrehozott fájlok.
- Ha egy ügyfelet szeretne létrehozni, akkor válassza ki az előállítandó proxytípust, majd
az ügyfélhez ismételje meg a fenti lépéseket.
- Webszolgáltatás közzététele: a webszolgáltatás böngészőt indítja el
a webszolgáltatás UDDI nyilvántartásban történő közzétételéhez.
- Webszolgáltatás megfigyelése: a webszolgáltatás forgalmát átküldi
a TCP/IP megfigyelőn, amely lehetővé teszi a webszolgáltatás által előállított SOAP
forgalom megtekintését és a forgalom tesztelését a WS-I szabványnak megfelelően. Felváltva
saját kezűleg is beállíthatja a TCP/IP megfigyelést a következőben leírtak alapján: TCP/IP megfigyelés használata a webszolgáltatások teszteléséhez
- Webszolgáltatás Java komponens azonosság oldal: a webszolgáltatás
WSDL neve kerül felsorolásra. Végezze el a következő beállításokat:
- Válassza ki a felfedendő 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 metódus nem felel meg a WS-I szabványnak.
- Válassza ki, hogy személyre szabja-e a csomag és a névtér közötti leképezéseket.
Kattintson a Tovább gombra
- Webszolgáltatás csomagtól névtérhez leképezések oldal: Ha az előző panelen
kiválasztotta a Névtér egyéni leképezésének meghatározása a névtérhez
lehetőséget, akkor ezen a panelen megadhatja az egyéni leképezési párokat a
Hozzáadás gombra végzett kattintással.
- Webszolgáltatás tesztelési oldala: Ha kijelölte a webszolgáltatás tesztelését, akkor
az előállított webszolgáltatáshoz válassza ki a tesztelési szolgáltatást. Ez a webszolgáltatás böngészőben megnyitja a
webszolgáltatást. Válassza ki a tesztelendő műveletet, adja meg a szükséges információkat, majd
kattintson a Mehet gombra.
Az eredmény az Állapot panelen jelenik meg. Kattintson a Tovább gombra.
- Webszolgáltatás proxy oldal: ha kijelölte a proxy előállítását, akkor
válassza ki, hogy személyre szabja-e a csomag és a névtér közötti leképezéseket.
- Webszolgáltatás ügyfél tesztelési oldal: Ezen az oldalon kiválaszthatja a következő
beállításokat:
- Tesztelési szolgáltatás kiválasztása. Az előállított proxyt tesztelheti a
webszolgáltatás böngészőben, vagy előállíthat egy minta webszolgáltatás JSP oldalt.
- Ha a proxy JSP oldalakon keresztüli tesztelését választotta ki, akkor kijelölheti a mappát, amelyben
a JSP elhelyezésre fog kerülni, valamint kiválaszthatja azokat a metódusokat, amelyek
belefoglalásra kerülnek a JSP oldalakba.
- A kiszolgáló automatikus indításához jelölje ki a Tesztelés futtatása a kiszolgálón
lehetőséget.
- Webszolgáltatás kiadvány oldala: Válassza ki, hogy közzé szeretné-e tenni
a webszolgáltatást egy UDDI nyilvántartásban. Kattintson a Befejezés gombra.
Megjegyzés: találkozhat egy figyelmeztető kijelentéssel: Hiba a WSDL előállításában
a Java-ból. ClassNotFound: <komponens neve>. Ez a hiba figyelmen kívül
hagyható.
Miután a webszolgáltatás létrehozásra került,
a kiválasztott elemektől függően a következő történhet:
- 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://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp. Ezzel a
példaalkalmazással úgy tesztelheti a webszolgáltatást, hogy kiválaszt egy
metódust, megadja a paramétereinek értéket majd a Meghív gombra kattint. A metódus által
visszaadott érték az Eredmények panelen jelenik meg.
- Ha kiválasztotta a webszolgáltatás tesztelését a Webszolgáltatás böngésző segítségével, akkor
megnyílik a böngésző. Válassza ki a tesztelendő műveletet, adja meg a szükséges információkat, majd
kattintson a Mehet gombra. Az eredmény az Állapot panelen jelenik meg.
- Ha kiválasztotta a webszolgáltatás közzétételét, akkor a webszolgáltatás böngésző elindításra kerül
megjelenítve a webszolgáltatás közzétételéhez szükséges oldalt. A feladat befejezéséhez
kövesse a Webszolgáltatás közzététele rész
utasításait.
Fontos: Ha a metódusok tartalmaznak olyan típusokat, amelyeket
a minta nem támogat, mint például tömböket, indexelt tulajdonságokat és gyűjteményeket, akkor
a metódusok kihagyásra kerülnek a mintából és figyelmeztető üzenetet fog
kapni.