Java ügyfélproxy és példaalkalmazás előállítása WSDL dokumentumból az Axis1 futási környezet használatával

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:

  1. 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.
  2. 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:
  1. Váltson a Java EE perspektívára (Ablak > Perspektíva megnyitása > Java EE).
  2. A Navigátor nézetben válassza ki, hogy melyik webprojektben kívánja létrehozni a példaalkalmazást.
  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 ügyfél varázslót. Kattintson a Tovább gombra.
  4. Webszolgáltatások oldal:
    1. 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.
    2. Válassza ki az előállítandó proxy típusát.
    3. 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.
    4. 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.
    5. 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.
    6. 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.
    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 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.
  6. 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.
  7. 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.
  8. 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.

A web projektek készítéséről részletesebben a Webalkalmazások fejlesztése című dokumentumban olvashat.

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