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
- 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
- Klicken Sie mit der rechten Maustaste auf das ausgewählte
Element und wählen Sie
aus.
- 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.