Web-Service-Anwendungen mit JAX-RPC implementieren

Sie können das Programmiermodell JAX-RPC (Java™ API for XML-based RPC) verwenden, um Web-Services zu entwickeln.

Vorbereitende Schritte

Bestimmen Sie die vorhandenen JavaBeans oder Enterprise-Beans, die Sie als JAX-RPC-Web-Service bereitstellen möchten.

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.

Informationen zu diesem Vorgang

Wenn Sie Web-Services auf der Basis des Programmiermodells JAX-RPC 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 Bottom-up-Entwicklungsansatz beschrieben.

Wenn Sie einen JAX-RPC-Web-Service mit vorhandenen JavaBeans oder Enterprise-Beans als Ausgangspunkt entwickeln, müssen Sie eine WSDL-Datei entwickeln. Sie können vorhandene JavaBeans oder Enterprise-Beans verwenden und anschließend die Implementierung für Web-Services aktivieren. Wenn Sie die Bean für Web-Services aktivieren möchten, müssen Sie die Serviceendpunktschnittstelle entwickeln, eine WSDL-Datei als Beschreibung für den Web-Service entwickeln, die Implementierungsdeskriptoren generieren und konfigurieren, alle für den Web-Service erforderlichen Artefakte assemblieren und die Anwendung im Anwendungsserver implementieren.

Hinweise für die Verwendung von JavaBeans

Als JAX-RPC-Web-Services bereitgestellte JavaBeans werden nur über einen HTTP-Transport unterstützt.

Hinweise für die Verwendung von Enterprise-Beans
  • Die Enterprise-Bean muss eine Stateless-Session-Bean sein.
  • Als JAX-RPC-Web-Services bereitgestellte Enterprise-Beans müssen in Modulen der EJB Version 2.1, EJB Version 3.0 oder höher gepackt werden.
  • Für JAX-RPC-Web-Services, die Endpunkte im Stil der EJB Version 2.1 verwenden, muss für die Web-Service-Methodenparameter einer der unterstützten JAX-RPC-Typen angegeben werden. Diese Anforderungen sind in der JAX-RPC-Spezifikation dokumentiert.
  • JAX-RPC-Web-Services, die Enterprise-Beans verwenden, werden über einen HTTP- oder JMS-Transport (Java Message Service) unterstützt.
Bewährtes Verfahren Bewährtes Verfahren: Es empfiehlt sich, Enterprise-Beans im Stil der EJB Version 2.1 für JAX-RPC-Anwendungen zu verwenden. bprac

Vorgehensweise

  1. Konfigurieren Sie eine Entwicklungsumgebung für Web-Services. Sie müssen keine Entwicklungsumgebung einrichten, wenn Sie Rational Application Developer verwenden.
  2. Entwickeln Sie eine Serviceendpunktschnittstelle. Die Serviceendpunktschnittstelle definiert die JavaBeans- bzw. Enterprise-Bean-Methoden für einen bestimmten Web-Service. Die JavaBean muss Methoden implementieren, die dieselbe Signatur haben wie die Methoden in der Serviceendpunktschnittstelle.
  3. Entwickeln Sie die Java-Artefakte.
    1. Entwickeln Sie die WSDL-Datei. Die WSDL-Datei ist die Beschreibung eines Java-EE-Web-Service Java Platform, Enterprise Edition (Java EE). Für JAX-RPC-Anwendungen ist eine WSDL-Datei erforderlich.
    2. Entwickeln Sie JAX-RPC-Implementierungsdeskriptoren. Verwenden Sie das Befehlszeilentool WSDL2Java, um die Implementierungsdeskriptorschablonen für die Zuordnung der Serviceimplementierung zur JavaBeans- bzw. EJB-Implementierung zu erstellen.
  4. Vervollständigen Sie die Implementierung Ihrer Web-Service-Anwendung.
  5. Konfigurieren Sie den Implementierungsdeskriptor webservices.xml. Konfigurieren Sie für JAX-RPC-Web-Services den Implementierungsdeskriptor webservices.xml so, dass der Anwendungsserver die eingehenden Web-Service-Anforderungen verarbeiten kann.
  6. Konfigurieren Sie den Implementierungsdeskriptor ibm-webservices-bnd.xmi. Konfigurieren Sie den Implementierungsdeskriptor ibm-webservices-bnd.xml so, dass der Anwendungsserver die eingehenden Web-Service-Anforderungen verarbeiten kann.
  7. Assemblieren Sie die Artefakte für Ihren Web-Service.

    Verwenden Sie die mit dem Anwendungsserver bereitgestellten Assembliertools, um Ihre Java-basierten Web-Service-Module zu assemblieren.

    Wenn Sie eine EAR-Datei assembliert haben, die Enterprise-Bean-Module enthält, die Web-Services enthalten, verwenden Sie vor der Implementierung das Befehlszeilentool endptEnabler oder ein Assembliertool, um eine WAR-Datei für den Web-Service-Endpunkt zu erzeugen. Mit diesem Tool kann auch festgelegt werden, ob die Web-Services über SOAP over Java Message Service (JMS) oder über SOAP over HTTP bereitgestellt werden.

  8. Implementieren Sie die EAR-Datei im Anwendungsserver. Sie können die EAR-Datei, die Sie für JAX-RP-Web-Services konfiguriert und aktiviert haben, jetzt im Anwendungsserver implementieren.

Ergebnisse

Sie haben eine JAX-RPC-Web-Service-Anwendung entwickelt.

Nächste Schritte

Nach der Implementierung der EAR-Datei testen Sie den Web-Service, um sicherzustellen, dass er mit dem Anwendungsserver funktioniert.


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_devwbsjaxrpc
Dateiname:twbs_devwbsjaxrpc.html