Generování proxy klienta Java a ukázkové aplikace z dokumentu WSDL pomocí běhového prostředí Axis1

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:

  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. 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:
  1. Přepněte do perspektivy Java EE (Okno > Otevřít perspektivu > Java EE).
  2. V pohledu Navigátor vyberte webový projekt, ve kterém chcete vygenerovat ukázkovou aplikaci.
  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 Klient webové služby. Klepněte na tlačítko Další.
  4. Stránka Webové služby:
    1. Zadejte URI souboru WSDL, WSIL nebo HTML, který se má použít je generování klienta.
    2. Vyberte typ proxy, který se má vygenerovat.
    3. 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.
    4. Vyberte server: Zobrazí se výchozí server. Chcete-li implementovat vašeho klienta na jiný server, klepněte na odkaz a zadejte jiný server.
    5. 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.
    6. 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.
    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 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.
  6. 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.
  7. 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.
  8. 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.

Další informace o vytváření webového projektu viz dokumentace k vývoji webových aplikací.

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