Průvodce webovými službami vám pomáhá při vytváření nové webové služby, konfiguruje ji pro implementaci a implementuje danou webovou službu na server.
Po implementaci webové služby pomáhá průvodce při generování proxy klienta a ukázkové aplikace pro testování webové služby. Po dokončení testování můžete vaši webovou službu publikovat do obchodního registru UDDI pomocí průzkumníku webových služeb.
Nezbytné předpoklady:
- Pokud používáte kontejner servletu Apache Jakarta Tomcat jako váš server, musíte jej nainstalovat, nakonfigurovat 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 naimportujte bean do zdrojové složky Java™ webového projektu. Chcete-li importovat, vyberte složku Prostředky Java: src a z nabídky souboru vyberte a přejděte na místo, kde je balík.
Postup vytvoření webové služby z objektu bean za použití běhového prostředí Apache Axis1:
- Přepněte do perspektivy Java EE (Okno > Otevřít perspektivu > Java EE).
- 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 volbu 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 tlačítko Další.
- Stránka Webové služby: Vyberte jako typ webové služby položku Webová služba využívající Java Bean - shora dolů a zadejte URI souboru WSDL, WSIL nebo HTML, který se má použít k vygenerování služby.
- Vyberte fáze vývoje webové služby, které chcete provádět, a to pomocí posuvného ovladače:
- Vyvíjet: Tato fáze vyvine definici WSDL a implementaci webové služby. Obsahuje úlohy jako například vytvoření modulů, které budou obsahovat generovaný kód, soubory WSDL, implementační deskriptory a popřípadě i soubory Java.
- Sestavit: Tato fáze kontroluje, že projekt, který bude hostitelem webové služby nebo klienta, bude přidružený k EAR, pokud to bude požadováno cílovým aplikačním serverem.
- Implementovat: Tato fáze vytvoří kód pro implementaci služby.
- Instalovat: Tato fáze na cílovém serveru nainstaluje a nakonfiguruje webový modul a EAR.
- Spustit: Tato fáze spustí server po dokončení instalace služby. Vygeneruje se soubor server-config.wsdd.
- Testovat: Tato fáze nabídne různé možnosti testování, jako například použití služby Průzkumník webových služeb nebo ukázkové stránky JSP.
- Vyberte server: Zobrazí se výchozí server. Chcete-li implementovat službu na jiném serveru, klepnutím na odkaz zadejte jiný server.
- Vyberte běhové prostředí: Zobrazí se výchozí běhové prostředí. Chcete-li implementovat službu na jiném běhovém prostředí, klepnutím na odkaz a zadejte jiné běhové prostředí.
- Vyberte projekt služby: Zobrazí se projekt, který obsahuje projekt vybraný ve vašem pracovním prostoru. Chcete-li vybrat jiný projekt a
EAR, klepněte na odkaz projektu. Zkontrolujte, 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: To spustí průzkumník webových služeb, abyste mohli publikovat webovou službu do registru UDDI.
- Monitorovat webovou službu: odesí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.
- Identita objektu Java Bean webové služby: zde 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 doporučujeme styl kódování "RPC/Encoded". Tato metoda kódování neodpovídá standardu WS-I.
- Vyberte, zda chcete upravit balík mapování oboru názvů.
Klepněte na tlačítko 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. Chcete-li importovat vlastní mapovací dvojice ze souboru .properties, můžete alternativně klepnout na volbu Import.
Obsah souboru vlastností musí být formátu package=namespace.
V souborech vlastností nebudete moci použít některé speciální znaky. Například somePackage=http://someNamespace by mělo být somePackage=http\://someNamespace. Jinak by byla dvojtečka (:) považována za oddělovač, a důsledkem by byl pokus o mapování somePackage na http.
- Stránka Testovat webovou službu: Pokud jste vybrali, že chcete testovat webovou službu, vyberte testovací zařízení pro vygenerovanou webovou službu. Tímto si 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 volbu Spustit.
Výsledek se zobrazí v podokně Stav. Klepněte na tlačítko Další.
- Stránka Proxy webové služby: Pokud jste se rozhodli vygenerovat proxy, vyberte, zda chcete upravit mapování balíku na obor názvů.
- Stránka Testování klienta webové služby: Na této stránce si můžete vybrat z následujících možností:
- Vyberte své testovací zařízení. Vygenerovaný proxy můžete otestovat v Průzkumníku webových služeb nebo si můžete vytvořit ukázkovou webovou službu JSP.
- 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.
- Chcete-li, aby se server spustil automaticky, vyberte možnost Spustit test na serveru.
- Stránka Publikace webové služby: Vyberte, zda chcete publikovat webovou službu v registru UDDI či nikoli. Klepněte na tlačítko Dokončit.
Poznámka: Možná se vám zobrazí varování Došlo k chybě při generování WSDL
z prostředí Java. ClassNotFound: <název objektu bean>. Tuto chybu můžete ignorovat.
Po vytvoření webové služby může dojít k následujícím situacím (v závislosti na možnostech, které jste vybrali):
- 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 volbu 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 volbu Spustit. Výsledek se zobrazí v podokně Stav.
- Pokud jste zvolili možnost publikování webové služby, spustí se Průzkumník webových služeb a zobrazí stránku, která je nezbytná k publikování 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.