Web-Service-Routermodule erstellen

Der Assistent "Routermodul erstellen" aktiviert eine Reihe von Web-Services innerhalb einer EAR-Datei (Enterprise Application Archive). Zur EAR-Datei wird für jede Web-Service-fähige EJB-JAR-Datei in der EAR-Datei ein HTTP-Router und/oder ein JMS-Router hinzugefügt. Jedes Routermodul enthält einen Web-Service-Endpunkt für einen bestimmten Transport. Sie können beispielsweise ein HTTP-Routermodul hinzufügen, sodass der Web-Service Anforderungen per HTTP-Transport empfangen kann, und ein JMS-Router-Modul, sodass der Web-Service Anforderungen von einer JMS-Warteschlange oder einem JMS-Thema empfangen kann. Der Assistent "Routermodule erstellen" war bisher unter der Bezeichnung Endpoint Enabler bekannt.

Vorbereitende Schritte

Für die Verwendung des Assistenten "Routermodule erstellen" benötigen Sie ein EAR-Projekt, das ein Web-Service-fähiges EJB-Projekt enthält. Wenn Ihre EJB-Anwendung in einem WAR-Modul in WebSphere Application Server Version 8 implementiert wird, müssen Sie keine Routermodule erstellen.

Informationen zu diesem Vorgang

Der Assistent "Routermodule erstellen" erstellt JAX-WS- oder JAX-RPC-JMS-Listener-MDBs (Message-driven Beans). Wenn mindestens ein JAX-WS-Web-Service vorhanden ist, wird das JAX-WS-Routermodul com.ibm.ws.websvcs.transport.jms.JMSListenerMDB generiert.

Anmerkung: Bei einer Implementierung in Liberty wird das Routermodul nicht benötigt.

Vorgehensweise

  1. Wählen Sie eines der folgenden Elemente aus:
    • Web-Service-Objekt aus dem Ordner "Services" im Enterprise-Explorer oder in der Ansicht "Services"
    • Datei application.xml oder EAR-Datei in einem EAR-Projekt
    • EJB-Objekt
    • Datei webservices.xml
    • Datei ejb-jar.xml
  2. Klicken Sie mit der rechten Maustaste auf das ausgewählte Element und wählen Sie Web-Services > Routermodule erstellen aus.
  3. Wählen Sie den zu verwendenden Transporttyp aus: HTTP und/oder JMS. Geben Sie die Routermodulnamen und alle weiteren Informationen ein, die erforderlich sind, um den gewünschten Transporttyp zu aktivieren, oder übernehmen Sie die Standardeinstellungen. Klicken Sie auf OK.

Ergebnisse

Nach Ausführung dieses Assistenten wird je nach verwendetem Transport ein Webprojekt für den HTTP-Router oder ein EJB-Projekt für den JMS-Router erstellt.
Einschränkung: Ändern Sie nicht den Inhalt des EJB-Moduls oder Webmoduls, das mit dem Assistenten "Routermodule erstellen" generiert wurde. Andernfalls tritt zur Ausführungszeit ein Fehler auf. Dann wird eine Nachricht wie die folgende angezeigt: WSWS3142E: Fehler: Web-Service-Engine wurde nicht gefunden.]: javax.servlet.ServletException: WSWS3142E: Fehler: Web-Service-Engine wurde nicht gefunden.
Symbol das den Typ des Artikels anzeigt. Taskartikel
Nutzungsbedingungen für Information Center | Feedback

Symbol für Zeitmarke Letzte Aktualisierung: 29.04.2014

Dateiname: tendenabl.html