Java komponensváz létrehozása WSDL dokumentumból, Apache Axis futási környezet használatával

A webszolgáltatás varázsló segít egy vázkomponens létrehozásában a 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. 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.
  2. Hozzon létre vagy 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ása WSDL fájlból az Apache Axis 1.0 futási környezet segítségével:
  1. Váltson át J2EE perspektívára (Ablak > Perspektíva megnyitása > J2EE).
  2. A Projektböngésző nézetben válassza ki azt a WSDL fájlt, amelyet létrehozott vagy importált a webprojekt webtartalom mappájába.
  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ás oldal: a webszolgáltatás típusaként válassza ki a Fentről lefelé haladó Java komponens webszolgáltatást, majd válassza ki azt a műterméket, amelyből a szolgáltatás létrehozásra kerül.
    1. 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
    2. 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.
    3. 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.
    4. 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.
    5. 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.
    6. 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.
    7. 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
  5. Webszolgáltatás váz Java™ komponens konfigurációs oldal: Válassza ki azt a mappát, amelyben az előállított Java tárolásra kerüljön. Ha a leképezéseket át szeretné tekinteni vagy tárolni kívánja a csomagok és a névterek között, akkor jelölje be a Egyéni leképezés meghatározása a névtér és a csomag között jelölőnégyzetet. Kattintson a Tovább gombra.
  6. Webszolgáltatás névtere a csomagleképezések oldalhoz: 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. Kattintson a Tovább gombra.
  7. 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.
  8. Webszolgáltatás proxy oldal: Ha kijelölte a proxy előállítását, akkor ez az oldal megjeleníti a proxy beállításait. Azokat a mappákat sorolja fel, amelyekben a proxy előállításra kerül, és Ön tetszés szerint készíthet egyéni leképezéseket a névterek és a csomagok között. Kattintson a Tovább gombra.
  9. Webszolgáltatás ügyfél tesztelési oldal: Ezen az oldalon kiválaszthatja a következő beállításokat:
    1. 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.
    2. 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.
    3. A kiszolgáló automatikus indításához jelölje ki a Tesztelés futtatása a kiszolgálón lehetőséget.
  10. Webszolgáltatás kiadvány oldala: Ha kiválasztotta a webszolgáltatás közzétételét egy UDDI nyilvántartásban, akkor ezen az oldalon indítsa el a webszolgáltatás böngészőt, majd válassza ki azt az UDDI nyilvántartást, amelybe a webszolgáltatást közzé szeretné tenni. Kattintson a Befejezés gombra.
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.