Vytvoření kostry objektu Java bean z dokumentu WSDL pomocí běhového prostředí Apache Axis1

Průvodce webovými službami vám pomáhá při vytváření objektu skeleton bean ze stávajícího dokumentu WSDL. Objekt skeleton bean obsahuje sadu metod odpovídajících operacím popsaným v dokumentu WSDL. Po vytvoření objektu typu bean má každá metoda triviální implementaci, kterou nahradíte při úpravách objektu bean.

Nezbytné předpoklady:

  1. 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 Vytvoření serveru Apache Tomcat a webového projektu.
  2. Vytvořte nebo naimportujte soubor WSDL do složky Webový obsah webového projektu. Můžete použít pouze soubor WSDL, který obsahuje prvek služby.
Vytvoření webové služby ze souboru WSDL pomocí 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 soubor WSDL, který jste vytvořili či naimportovali do složky Webový obsah 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 vyberte artefakt, ze kterého se má služba vytvořit.
    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. Stránka Konfigurace kostry webových služeb využívajících Java™ Bean: Vyberte složku, kde bude uložen vygenerovaný kód Java. Chcete-li přezkoumat či upravit mapování mezi balíky a obory názvů, zaškrtněte políčko Definovat vlastní mapování oboru názvů a balíku. Klepněte na tlačítko Další.
  6. Stránka Mapování oboru názvů webové služby na balík: 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 volbu 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í mít formát namespace=package. V souborech vlastností nebudete moci použít některé speciální znaky. Například http://someNamespace=somePackage by mělo být http\://someNamespace=somePackage. Jinak by byla dvojtečka (:) považována za oddělovač, a důsledkem by byl pokus o mapování http na //someNamespace=somePackage.
  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 pro webové služby: Tato stránka zobrazuje možnosti pro proxy, pokud jste se rozhodli proxy vygenerovat. Vypíše složku, kde bude proxy vygenerováno, a vy můžete volitelně vytvářet mapování mezi obory názvů a balíky. Klepněte na tlačítko Další.
  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ých služeb: Pokud jste zvolili možnost publikovat vaši webovou službu v registru UDDI, pomocí této stránky spustíte Průzkumníka webových služeb a vyberete registr UDDI, do něhož se má webová služba publikovat. Klepněte na tlačítko Dokončit.
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.
Související koncepce
Vytvoření webových služeb pomocí běhového prostředí Apache Axis1