Creating web service router modules

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 file 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 can be added so that the web service can receive requests over the HTTP transport, and a JMS router module can 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

Important: Applicable to WebSphere® Application Server traditional

To use the Create Router Modules wizard, you must have an EAR project that contains a web service-enabled EJB project. 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 JMS Listener message-driven beans. If there is at least one JAX-WS web service present, a JAX-WS router module is generated: com.ibm.ws.websvcs.transport.jms.JMSListenerMDB

Remember: The router module is not required when you deploy to Liberty.

Procedure

  1. Select one of the following elements:
    • 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
  2. Right-click the selected element, and select Web Services > Create Router Modules.
  3. Select which type of transports you want to use: HTTP, JMS, or both.
    Enter the router module names and any other information that is required to enable the type of transport you want to use, or accept the defaults. Click OK.

Results

After you run this wizard, a web project for the HTTP router or an EJB project for the JMS router is created, depending on which transports were used.
Restriction: Do not modify the contents of the EJB module or the web module that was generated by using the Create Router Modules wizard. If you do, an error occurs during run time. An error such as the following message is displayed: Error - WSWS3142E: Error: Could not find Web services engine.]: javax.servlet.ServletException: WSWS3142E: Error: Could not find Web services engine.