Vytváření webové služby z objektu Java bean pomocí běhového prostředí Apache Axis

Průvodce webovými službami vám pomůže vytvořit novou webovou službu, zkonfigurovat ji pro implementaci a implementovat ji na server. Po implementaci webové služby vám průvodce pomůže vygenerovat proxy klienta a ukázkovou aplikaci pro testování webové služby. Po dokončení testování můžete svou webovou službu pomocí průvodce exportem publikovat v obchodním registru UDDI.

Nezbytné předpoklady:
  1. Vytvořte nebo naimportuje bean do zdrojové složky Java webového projektu.
Chcete-li pomocí běhového prostředí Apache Axis vytvořit webovou službu z objektu typu bean:
  1. Přepněte do perspektivy J2EE (Okno > Otevřít perspektivu > J2EE).
  2. V pohledu Průzkumník projektů vyberte objekt bean, který jste vytvořili či naimportovali do zdrojové složky svého webového projektu.
  3. Klepněte na Soubor > Nový> Jiné. Vyberte Webové služby, aby se zobrazili různí průvodci webovými službami. Vyberte Průvodce webovými službami. Klepněte na Další.
  4. Stránka Webové služby: Jako typ své webové služby vyberte Webová služba využívající Java Bean zdola nahoru a zadejte URI souboru WSDL, WSIL nebo HTML, který bude využit k vygenerování dané služby.
    1. Pomocí posuvného ovladače vyberte fáze vývoje webových služeb, které se mají provést:
      • Vývoj: Vytvoří kód služby
      • Sestavení:
      • Implementace: Vytvoří kód implementace služby
      • Instalace: Nainstaluje službu na vybraný server
      • Spuštění: Spustí server po dokončení instalace služby
      • Testování: Nabízí nejrůznější možnosti testování služby
    2. Vyberte server: Zobrazí se výchozí server. Chcete-li svou službu implementovat na jiný server, klepněte na příslušný odkaz a určete jiný server.
    3. Vyberte běhovou komponentu: Zobrazí se výchozí běhová komponenta. Chcete-li svou službu implementovat na jinou běhovou komponentu, klepněte na příslušný odkaz a určete jinou běhovou komponentu.
    4. Vybrat projekt služby: Zobrazí se projekt obsahující projekt vybraný ve vašem pracovním prostoru. Chcete-li vybrat jiný projekt a EAR, klepněte na odkaz projektu. Ujistěte se, zda je projekt vybraný jako webový projekt klienta odlišný od webového projektu služby nebo zda bude služba přepsána vygenerovanými artefakty klienta.
    5. Chcete-li vytvořit klienta, zvolte typ proxy, který se má vygenerovat, a zopakujte výše uvedené kroky pro klienta.
    6. Publikovat webovou službu: Spustí se průzkumník webových služeb pro publikování vaší webové služby v registru UDDI.
    7. Monitorovat webovou službu: Posílá provoz webové služby přes TCP/IP Monitor, který umožňuje sledovat provoz SOAP generovaný službou a testovat, zda odpovídá WS-I. Alternativně můžete nastavit monitor TCP/IP ručně, jak popisuje Použití modulu TCP/IP Monitor k testování webových služeb.
  5. Stránka Identita objektu Java webové služby: Bude uveden název WSDL webové služby. Máte následující možnosti:
    • Vyberte metody k odkrytí.
    • Vyberte styl kódování. Pro běhové prostředí Axis se doporučuje styl kódování RPC/Kódovaný. Tato metoda kódování neodpovídá WS-I.
    • Vyberte, zda chcete přizpůsobit balíček mapování oboru názvů.
    Klepněte na Další
  6. Stránka Mapování balíčku webové služby na obor názvů: Pokud jste na předchozím panelu vybrali Definovat vlastní mapování balíčku na obor názvů, můžete na tomto panelu po klepnutí na Přidat zadávat vlastní mapovací dvojice.
  7. Stránka Testování webové služby: Pokud jste se rozhodli pro testování webové služby, vyberte pro vygenerovanou webovou službu testovací zařízení. Tím otevřete webovou službu v průzkumníku webových služeb. Vyberte operaci, kterou chcete testovat, zadejte nezbytné informace a klepněte na Spustit. Výsledek se zobrazí v podokně Stav. Klepněte na Další.
  8. Stránka Proxy webové služby: Pokud jste se rozhodli vygenerovat proxy, vyberte, zda chcete přizpůsobit mapování balíčku na obor názvů.
  9. Stránka Testování klienta webové služby: Pomocí této stránky můžete vybírat následující volby:
    1. Vyberte testovací zařízení. Vygenerované proxy můžete testovat v průzkumníku webových služeb, nebo můžete vygenerovat ukázkovou stránku JSP webové služby.
    2. Pokud jste se rozhodli testovat proxy pomocí JSP, můžete zvolit složku, kde se bude stránka JSP nacházet, a vybrat metody, které bude zahrnovat.
    3. Vyberte Spustit test na serveru, aby se vám server automaticky spustil.
  10. Stránka Publikování nových služeb: Zvolte, zda chcete či nechcete publikovat tuto webovou službu v registru UDDI. Klepněte na Dokončit. Poznámka: Může se vám zobrazit varování se slovy Chyba při generování WSDL z Javy. ClassNotFound: <název objektu bean>. Tuto chybu lze bez nebezpečí ignorovat.
Po vytvoření webové služby může v závislosti na vámi vybraných volbách dojít k následujícímu:
  • Pokud jste zvolili testování vygenerovaného proxy pomocí JSP webové služby, spustí se proxy ve webovém prohlížeči na následující adrese URL: http://localhost: port/ webový_projektClient/sampleBeanName/ název_webové_služby/TestClient.jsp. Tuto ukázkovou aplikaci můžete použít k testování webové služby výběrem metody, zadáním hodnoty metody a klepnutím na Vyvolat. Výsledek metody se zobrazí v podokně výsledků.
  • Pokud jste se rozhodli testovat webovou službu pomocí průzkumníku webových služeb, otevře se průzkumník. Vyberte operaci, kterou chcete testovat, zadejte nezbytné informace a klepněte na Spustit. Výsledek se zobrazí v podokně Stav.
  • Pokud jste se rozhodli publikovat webovou službu, spustí se průzkumník webových služeb zobrazující stránku vyžadovanou pro publikaci vaší webové služby. Úlohu proveďte podle pokynů uvedených v tématu Publikování webové služby.

Pozor: Pokud vaše metody obsahují typy nepodporované ukázkou, jako například pole, indexované vlastnosti či kolekce, budou tyto metody z ukázky vynechány a obdržíte varovnou zprávu.