Running the Listeners
Install OpenJMS and Axis. Unzip the download.zip into a windows folder named, say, A. Modify the setclasspath.bat to give the correct value for Axis Home and openjms home. Put the server-config.wsdd in your Axis installation's (the axis zone of your web server's webapp) WEB-INF folder if there is none already. If you already have this file then copy the two service element entries in full to the already existing server-config.wsdd. Define three queues in openjms.xml, i.e., one for each Web Service given in jmswebsvcs.xml and one for "replyq," which is the reply queue used by the client. Change the GenericJMSSOAPListenerForAxis code line at the top to specify the full path of your Axis installation's server-config.wsdd file. Compile the source code to create .class files. Put the .class files in folder A with the right package structure. Now start openjms. Go to folder A in the DOS command prompt. Run setclasspath.bat. Then start the JMS listeners using the command java jms.AxisJMSListenersStarter.

Now, to run the test client, open another command prompt window. Go to folder A. Run setclasspath.bat. Use the command java invoker.jms.JMSTestClientRPC to run the JMS RPC client. Then use the command java invoker.jms.JMSTestClientMessageStyle to run the JMS message service client. Make sure that folder A contains the client-config.wsdd and that folder A is first in the class path order.

Summary
This article has introduced a working JMS listener for use with Apache Axis 1.x and has shown how clients can uniquely address Axis Web Services for invocation over JMS and how they invoke them over JMS using a combination of this listener and custom-written JMS transport handlers.

The source code for this solution can be downloaded from the online version of this article at http://java.sys-con.com.

Resources

• Axis: http://ws.apache.org/axis/java/index.html
• Openjms: http://openjms.sourceforge.net/
• Web Services Description Language (WSDL) 1.1 - March 15, 2001 www.w3.org/TR/2001/NOTE-wsdl-20010315
• JMS: http://java.sun.com/products/jms/
• Some articles on JMS with Axis:
  - "Programming JMS Applications using Axis" (IBM developerworks) www-128.ibm.com/developerworks/webservices/library/ws-jms/
  - "Axis meets MOM" (javaworld.com) www.javaworld.com/javaworld/jw-02-2006/jw-0220-axis.html