Při generování proxy objektu Java™ bean a ukázkové aplikace vám pomůže průvodce klientem webových služeb. Ukázková webová aplikace znázorňuje kódování souboru proxy.
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 Vytvoření serveru Apache Tomcat a webového projektu.
- Zjistěte a naimportujte dokument WSDL do webového projektu. Můžete použít pouze soubor
WSDL, který obsahuje prvek služby.
Abyste mohli vygenerovat proxy klienta Java a ukázkové aplikace ze zjištěného dokumentu WSDL:
- Přepněte do perspektivy Java EE (Okno > Otevřít perspektivu > Java EE).
- V pohledu Navigátor vyberte webový projekt, ve kterém chcete vygenerovat ukázkovou aplikaci.
- 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 Klient webové služby. Klepněte na tlačítko Další.
- Stránka Webové služby:
- Zadejte URI souboru WSDL, WSIL nebo HTML, který se má použít je generování klienta.
- Vyberte typ proxy, který se má vygenerovat.
- 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, a soubory Java, a také kopírování souborů JAR prostředí AXIS.
- 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 vašeho klienta na jiný server, klepněte na odkaz a zadejte jiný server.
- Vyberte běhové prostředí: Zobrazí se výchozí běhové prostředí. Chcete-li implementovat vašeho klienta na jiné běhové prostředí, klepněte na odkaz a zadejte jinou běhovou komponentu.
- Vyberte projekt klienta: 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.
- 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.
- Stránka Proxy pro webové služby: Tento panel zobrazuje možnosti pro proxy.
Je zde vypsána složka, v níž bude proxy vygenerován a můžete si vytvořit vlastní mapování oborů názvů na balíky.
- Stránka Mapování oboru názvů webové služby na balík: Pokud jste na předchozí stránce vybrali Definovat vlastní mapování oboru názvů na balík, můžete na této stránce 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.
- Stránka Testování klienta webové služby: Na této stránce se zobrazí, zda jste se rozhodli pro testování vašeho klienta. Vyberte testovací zařízení, které budete používat k testování proxy a metody, které se mají do proxy zahrnout. Pamatujte, že klient Universal Test Client (UTC) je kompatibilní pouze s klienty webových služeb implementovanými na serverechWebSphere® servers.
- Klepněte na tlačítko Dokončit. Pokud jste vybrali, že chcete proxy testovat, otevře se v okně prohlížeče testovací klient.
Generovaný proxy Java bean poskytuje rozhraní pro volání vzdálené procedury na webovou službu. Ukázková webová aplikace nabízí příklad kódování souboru proxy.
Jakmile vygenerujete vaše proxy klienta Java,
můžete otestovat metody webové služby prostřednictvím proxy s použitím
ukázkových JSP webových služeb nebo klienta Universal test client.
- 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.
Další informace o vytváření webového projektu viz dokumentace k vývoji webových aplikací.