A Webszolgáltatás ügyfél varázsló segítséget nyújt Java™ bean proxy és mintaalkalmazás előállításában. A minta webalkalmazás
bemutatja a proxy fájl kódolásának módját.
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.
- Keressen egy WSDL dokumentumot, és importálja a webprojektbe. Csak
olyan WSDL fájl használható, ami tartalmaz service elemet.
Java ügyfél proxy és példaalkalmazás előállítása
WSDL dokumentumból:
- Váltson a Java EE perspektívára (Ablak > Perspektíva megnyitása
> Java EE).
- A Navigátor nézetben válassza ki, hogy melyik webprojektben kívánja
létrehozni a példaalkalmazást.
- 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 ügyfél varázslót. Kattintson a Tovább gombra.
- Webszolgáltatások oldal:
- Adja meg annak a WSDL, WSIL vagy HTML dokumentumnak az URI címét,
amiből a létre kívánja hozni az ügyfelet.
- Válassza ki az előállítandó proxy típusát.
- 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 és Java fájlokat tartalmazó modulok létrehozása, valamint
az Axis JAR fájlok másolá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 az ügyfelet, 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 az
ügyfelet, akkor kattintson a hivatkozásra egy másik futási környezet
megadásához.
- Válassza ki az ügyfélprojektet: 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.
- 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 Proxy oldal: A panel 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évtér és csomagok
között.
- Webszolgáltatás névtér - csomag leképezések oldal: ha bejelölte
az Egyéni névtér-csomag leképezések meghatározása jelölőnégyzetet az előző oldalon, akkor ezen az
oldalon í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 ügyfél teszt oldal: Akkor jelenik meg, ha kijelölte az
ügyfél tesztelését. Válassza ki a proxy
teszteléséhez használni kívánt szolgáltatást és a proxyban tartalmazandó
metódusokat. Vegye figyelembe, hogy az Általános tesztügyfél (UTC) csak
WebSphere® kiszolgálókra telepített webszolgáltatás ügyfelekkel kompatibilis.
- Kattintson a Befejezés gombra. Ha
kiválasztotta a proxy tesztelését, akkor egy böngészőablakban megnyílik a
teszt ügyfél.
Az előállított Java komponens proxy távoli eljáráshívási
felületet biztosít a webszolgáltatás számára. A proxyfájl kódolását a minta webalkalmazás mutatja be.
A Java ügyfélproxyt létrehozása után a webszolgáltatás példa JSP
oldalai vagy az Általános teszt ügyfél segítségével tesztelheti a
webszolgáltatás metódusait.
- 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ő
URL 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.
A web projektek készítéséről részletesebben a Webalkalmazások
fejlesztése című dokumentumban olvashat.