Clientbindungen aus einer WSDL-Datei für einen JAX-RPC-Web-Service-Client entwickeln

Sie können aus einer WSDL-Datei (Web Services Description) Clientbindungen für einen JAX-RPC-Web-Service-Client entwickeln.

Vorbereitende Schritte

Wenn Sie aus einer WSDL-Datei die Clientbindungen für JAX-RPC-Web-Service-Anwendungen entwickeln möchten, müssen Sie den Uniform Resource Locator (URL) der zu verwenden WSDL-Datei abrufen. Sie benötigen Bindungen und Implementierungsdeskriptoren, damit ein Client einen Web-Service verwenden kann.

[Windows][z/OS]Wenn die WSDL-Datei eine lokale Datei ist, sieht der URL wie folgt aus: file:Laufwerk:\Pfad\Dateiname.wsdl.

[Linux][AIX][HP-UX][Solaris][IBM i]Wenn die WSDL-Datei eine lokale Datei ist, sieht der URL wie folgt aus: file:/Pfad/Dateiname.wsdl.

Lokale Dateien können Sie auch mit dem absoluten oder relativen Dateisystempfad angeben.

Clientbindungen werden werden mit dem Befehl WSDL2Java in Kombination mit den Optionen -role develop-client und -container generiert. Die Option -container verwendet die folgenden Parameter:
  • -container client

    Generiert Bindungen und Implementierungsdeskriptoren für einen Client im Anwendungs-Client-Container.

  • -container ejb

    Generiert Bindungen und Implementierungsdeskriptoren für einen Client, der in einer Enterprise-Bean im EJB-Modul enthalten ist.

  • -container web

    Generiert Bindungen und Implementierungsdeskriptoren für einen Client im Web-Container.

[z/OS]Das Befehlszeilentool WSDL2Java wird auf der Plattform z/OS nicht unterstützt. Diese Funktionalität wird von den Assembliertools bereitgestellt, die mit der z/OS-Version des Produkts geliefert werden. Weitere Informationen zu diesem Tool finden Sie in der Beschreibung des Befehlszeilentools WSDL2Java für JAX-RPC-Anwendungen (Java™ API for XML-based Remote Procedure Call).

Informationen zu diesem Vorgang

Führen Sie zum Generieren der Clientbindungen aus einer WSDL-Datei den entsprechenden Befehl aus.

Bewährtes Verfahren Bewährtes Verfahren: Es wird empfohlen, in der WSDL-Datei oder im WSDL-Schema absolute Namespaces zu verwenden. Standardmäßig lässt das Tool WSDL2Java die Verwendung relativer Namespaces nicht zu. Relative Namespaces sind laut XML Plenary Interest Group veraltet, und ihre Verwendung führt dazu, dass XML Digital Signature gemäß der Spezifikation Canonical XML Version 1.0 fehlschlägt. Sie können alle relativen Namespaces in absolute Namespaces konvertieren. Weitere Informationen zur Verwendung von Namespaces mit dem Tool WSDL2Java finden Sie in der Dokumentation zum Befehl WSDL2Java für JAX-RPC-Anwendungen.bprac

Vorgehensweise

Führen Sie den Befehl WSDL2Java -verbose -role develop-client -container Typ WSDL-URL aus.

Für diese Angaben gilt Folgendes: Typ ist ejb für einen EJB-Client, web für einen JavaBeans-Client oder client für einen Anwendungsclient.

Sie können die folgenden Kombinationen in der Befehlszeile verwenden:
  • -container web
  • -container ejb
  • -container client
Da die Option "verbose" verwendet wurde, wird bei der Ausführung des Befehls eine Liste aller generierten Dateien angezeigt.

Ergebnisse

Sie haben die Bindungen und Implementierungsdeskriptoren erstellt, die ein Client benötigt, um einen Web-Service verwenden zu können.

Beispiel

Das folgende Beispiel verwendet die Enterprise-Bean "AddressBook" und die WSDL-Datei AddressBook.wsdl. Nachdem Sie die Bindungen mit dem Befehl WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl generiert haben, werden die folgenden Dateien generiert:
Syntaxanalyse der XML-Datei: file:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Info: Syntaxanalyse der XML-Datei:  AddressBook.wsdl
WSWS3282I: Info: addr\Address.java wird generiert.
WSWS3282I: Info: addr\Phone.java wird generiert.
WSWS3282I: Info: addr\StateType.java wird generiert.
WSWS3282I: Info: addr\AddressBook.java wird generiert.
WSWS3282I: Info: addr\AddressBookService.java wird generiert.
WSWS3282I: Info: META-INF\ibm-webservicesclient-bnd.xmi wird generiert.
WSWS3282I: Info: META-INF\AddressBook_mapping.xml wird generiert.
WSWS3282I: Info: META-INF\ibm-webservicesclient-ext.xmi wird generiert.

Nächste Schritte

Vervollständigen Sie die Clientimplementierung, indem Sie Ihre Clientanwendung schreiben und anschließend die Clientartefakte assemblieren.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_devclientbindings
Dateiname:twbs_devclientbindings.html