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

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:
  1. 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 Import > Obecné > Systém souborů 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:
  1. Přepněte do perspektivy Java EE (Okno > Otevřít perspektivu > Java EE).
  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 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ší.
  4. 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.
    1. 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.
    2. Vyberte server: Zobrazí se výchozí server. Chcete-li implementovat službu na jiném serveru, klepnutím na odkaz zadejte jiný server.
    3. 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í.
    4. 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.
    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: To spustí průzkumník webových služeb, abyste mohli publikovat webovou službu do registru UDDI.
    7. 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.
  5. 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ší.
  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. 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.
  7. 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ší.
  8. Stránka Proxy webové služby: Pokud jste se rozhodli vygenerovat proxy, vyberte, zda chcete upravit mapování balíku na obor názvů.
  9. Stránka Testování klienta webové služby: Na této stránce si můžete vybrat z následujících možností:
    1. 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.
    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. Chcete-li, aby se server spustil automaticky, vyberte možnost Spustit test na serveru.
  10. 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.

Související koncepce
Vytvoření webových služeb pomocí běhového prostředí Apache Axis1