Web-Service-Anwendungen aus vorhandenen WSDL-Dateien mit JAX-WX implementieren

Wenn Sie eine vorhandene WSDL-Datei (Web Services Description Language) als Ausgangspunkt verwenden, können Sie einen Top-down-Ansatz für die Entwicklung von Web-Services auf der Basis des Programmiermodells Java™ API for XML-Based Web Services (JAX-WS) verwenden.

Vorbereitende Schritte

Bewährte Verfahren: IBM® WebSphere Application Server unterstützt das Programmiermodell Java API for XML-Based Web Services (JAX-WS) und das Programmiermodell Java API for XML-based RPC (JAX-RPC). JAX-WS ist das Web-Service-Programmiermodell der nächsten Generation, das die vom Programmiermodell JAX-RPC bereitgestellte Grundlage erweitert. Durch die Verwendung des strategischen Programmiermodells JAX-WS, das ein auf Standards basierendes Annotationsmodell unterstützt, vereinfacht sich die Entwicklung von Web-Services und -Clients. Obwohl das Programmiermodell JAX-RPC und JAX-RPC-Anwendungen weiterhin unterstützt werden, sollten Sie das einfach zu implementierende Programmiermodell JAX-WS für die Entwicklung neuer Web-Service-Anwendungen und -Clients nutzen.

Suchen Sie die WSDL-Datei, die den zu implementierenden Web-Service definiert. Sie können die WSDL-Datei entwickeln oder per E-Mail, Download bzw. URL von einem vorhandenen Web-Service anfordern.

Informationen zu diesem Vorgang

Wenn Sie Web-Services auf der Basis des Programmiermodells JAX-WS entwickeln möchten, können Sie einen Bottom-up-Entwicklungsansatz, ausgehend von vorhandenen JavaBeans oder Enterprise-Beans, verwenden, oder Sie können sich für einen Top-down-Entwicklungsansatz, ausgehend von einer vorhandenen WSDL-Datei (Web Services Description Language), entscheiden. In dieser Task werden die Schritte für den Top-down-Entwicklungsansatz beschrieben.

Hinweise für die Verwendung von JavaBeans
  • Als JAX-WS-Web-Services bereitgestellte JavaBeans werden nur über einen HTTP-Transport unterstützt.
  • JavaBeans kann Contexts and Dependency Injection (CDI, Kontext- und Abhängigkeitsinjektion) verwenden. Beachten Sie, dass die Konstruktorinjektion nicht unterstützt wird.
Hinweise für die Verwendung von Enterprise-Beans
  • Die Enterprise-Bean muss eine Stateless- oder Singleton-Session-Bean sein.
  • Als JAX-WS-Web-Services bereitgestellte Enterprise-Beans müssen in Modulen der EJB Version 3.0 oder höher gepackt werden.
  • JAX-WS-Serviceanwendungen, die Enterprise-Beans enthalten, müssen mit dem Befehl endptEnabler implementiert werden.
  • JAX-WS-Web-Services, die Enterprise-Beans verwenden, werden über einen HTTP- oder JMS-Transport (Java Message Service) unterstützt.
  • Enterprise-Beans können CDI nutzen. Beachten Sie, dass die Konstruktorinjektion nicht unterstützt wird.

Vorgehensweise

  1. Richten Sie eine Entwicklungsumgebung für Web-Services ein. Sie müssen keine Entwicklungsumgebung einrichten, wenn Sie Rational Application Developer verwenden.
  2. Entwickeln Sie Java-Artefakte für JAX-WS-Anwendungen mit dem Befehlszeilentool wsimport. Das Tool wsimport verarbeitet eine WSDL-Datei und generiert portierbare Java-Artefakte, die zum Erstellen eines Web-Service verwendet werden.
  3. (Optional) Aktivieren Sie MTOM für JAX-WS-Web-Services. Sie können SOAP Message Transmission Optimization Mechanism (MTOM) verwenden, um die Übertragung binärer Anhänge, wie z. B. Bildern oder Dateien, zusammen mit Web-Service-Anforderungen zu optimieren.
  4. (Optional) Setzen Sie die Einhaltung von WSDL-Bindungen in JAX-WS-Web-Services durch. Mit RespectBindingFeature können Sie steuern, ob eine JAX-WS-Implementierung erforderlich ist, damit der Inhalt des Elements "wsdl:binding", das einem Endpunkt zugeordnet ist, berücksichtigt wird.
  5. (Optional) Entwickeln und konfigurieren Sie einen Implementierungsdeskriptor webservices.xml für JAX-WS-Anwendungen. Optional können Sie den Implementierungsdeskriptor webservices.xml verwenden, um Anwendungsmetadaten zu erweitern oder zu überschreiben, die in Annotationen in Ihren JAX-WS-Web-Services angegeben sind.
  6. Vervollständigen Sie die Implementierung Ihrer Web-Service-Anwendung.
  7. (Optional) Passen Sie URL-Muster in der Datei "web.xml" an. Wenn JavaBeans als JAX-WS-Endpunkte bereitgestellt werden, können Sie optional die URL-Muster in dem in der WAR-Datei enthaltenen Implementierungsdeskriptor "web.xml" anpassen.
  8. Assemblieren Sie die Artefakte für Ihren Web-Service.
  9. Implementieren Sie die EAR-Datei im Anwendungsserver. Sie können die EAR-Datei, die Sie für Web-Services konfiguriert und aktiviert haben, jetzt im Anwendungsserver implementieren.
  10. Testen Sie den Web-Service, um sicherzustellen, dass er mit dem Anwendungsserver funktioniert.

Ergebnisse

Sie haben einen JAX-WS-Web-Service aus einer vorhandenen WSDL-Datei erstellt.


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_devwbsjaxwswsdl
Dateiname:twbs_devwbsjaxwswsdl.html