Java bean komponens váz létrehozása WSDL dokumentumból az Apache Axis1 futási környezet segítségével

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:

  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. 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:
  1. Váltson a Java EE perspektívára (Ablak > Perspektíva megnyitása > Java EE).
  2. A Projektböngésző nézetben jelölje ki a webprojekt Webtartalom mappájában létrehozott vagy oda importált WSDL fájlt.
  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 varázslót. Kattintson a Tovább gombra.
  4. 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.
    1. 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.
    2. 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.
    3. 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.
    4. 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.
    5. 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.
    6. 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.
    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 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.
  6. 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.
  7. 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.
  8. 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.
  9. Webszolgáltatás ügyfél teszt oldal: Az oldalon az alábbi beállításokat választhatja ki:
    1. 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.
    2. 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.
    3. A Teszt futtatása kiszolgálón kijelölése esetén a kiszolgáló automatikusan indításra kerül.
  10. 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.
Kapcsolódó fogalmak
Webszolgáltatások létrehozása Apache Axis1 futási környezettel