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:
- Pokud jako svůj server používáte kontejner servletů Apache Jakarta Tomcat, musíte jej nainstalovat, zkonfigurovat jeho instanci
a vytvořit webový projekt zaměřený na tento kontejner, jak je popsáno ve Vytváření serveru Apache Tomcat a webového projektu.
- 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:
- Přepněte do perspektivy J2EE (Okno > Otevřít perspektivu > J2EE).
- V pohledu Průzkumník projektů vyberte objekt bean, který jste vytvořili či naimportovali do zdrojové složky svého webového projektu.
- 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ší.
- 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.
- 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
- 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.
- 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.
- 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.
- Chcete-li vytvořit klienta, zvolte typ proxy, který se má vygenerovat, a zopakujte výše uvedené kroky pro klienta.
- Publikovat webovou službu: Spustí se průzkumník webových služeb pro publikování vaší webové služby v registru UDDI.
- 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.
- 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ší
- 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.
- 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ší.
- 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ů.
- Stránka Testování klienta webové služby: Pomocí této stránky můžete vybírat následující volby:
- 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.
- 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.
- Vyberte Spustit test na serveru, aby se vám server automaticky spustil.
- 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.