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
- Richten Sie eine Entwicklungsumgebung für Web-Services ein. Sie müssen keine Entwicklungsumgebung einrichten, wenn Sie
Rational Application Developer verwenden.
- 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.
- (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.
- (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.
- (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.
- Vervollständigen Sie die Implementierung Ihrer Web-Service-Anwendung.
- (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.
- Assemblieren Sie die Artefakte für Ihren Web-Service.
- 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.
- 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.