The Create Router Modules wizard enables a set of web services
within an Enterprise Application Archive (EAR) file. For each web
service-enabled EJB JAR in the EAR file, it adds an HTTP router, a
JMS router, or both to the EAR. Each router module provides a web
service endpoint for a particular transport. For example, an HTTP
router module may be added so that the web service can receive requests
over the HTTP transport, and a JMS router module may be added so that
the web service can receive requests from a JMS queue or topic. The
Create Router Modules wizard was formerly known as the Endpoint Enabler.
Before you begin
To use the Create Router Modules wizard, you must have
an EAR project that contains a web service-enabled EJB project. Note
that if your EJB application is being deployed in a WAR module to
WebSphere Application Server v8, you do not need to create router
modules.
About this task
The Create Router Modules wizard creates JAX-WS or JAX-RPC
JMS Listener message-driven beans based on the type of web services
that the EJB module contains.
- If there is at least one JAX-WS web service present, a JAX-WS
router module will be generated: com.ibm.ws.websvcs.transport.jms.JMSListenerMDB
- If there are only JAX-RPC web services present, a JAX-RPC router
module will be generated: com.ibm.ws.webservices.engine.transport.jms.JMSListenerMDB
To create a router module using the Create Router Modules
wizard:
Procedure
- Select one of the following:
- The web service object under the Services folder in the Enterprise
Explorer or in the Services view
- The application.xml file or EAR file within an EAR project
- An EJB object
- A webservices.xml file
- An ejb-jar.xml file
- Right-click the selected element, select Web
Services > Create Router Modules.
- Select which type of transports you want to use: HTTP,
JMS, or both. Enter the router module names and any other
information required to enable the type of transport you want to use,
or accept the defaults. ClickOk.
Results
After running this wizard, a Web project for the HTTP router
or an EJB project for the JMS router will be created, depending on
what transports were used.
Restriction: You should not
modify the contents of the EJB module or the Web module that was generated
using the Create Router Modules wizard. If you do, an error occurs
during run time. The following is an example of the error that displays: "Error
- WSWS3142E: Error: Could not find Web services engine.]: javax.servlet.ServletException:
WSWS3142E: Error: Could not find Web services engine."