SOAP frontend to JMS broker

SOAP frontend to JMS (aka soap2jms) integrates SOAP over HTTP and Message Queues allowing to access a JMS queue through a standard SOAP over HTTP web service.

It is not to be confused with "SOAP over JMS". Soap over JMS encapsulates a soap message into a JMS envelope. It has the same problems of JMS in terms of interoperability and it requires a JMS client implementation to connect to the server. (link)

Features

Main features of this library are:

  • It allows to read messages from a JMS queue using a SOAP over HTTP web service.
  • It allows to send messages to a JMS queue.
  • It is resilient to communication failure. See the design section for more information.

Clients don't have to depend on any JMS implementation libraries. They are simple JAX-WS web service clients, that can be supported by any JAX-WS implementation (Any J2EE container or Apache CXF if you are in a standalone application).

It is not to be confused with "Soap over JMS". Soap Over JMS encapsulates a soap message into a JMS envelope. It has the same problems of JMS in terms of interoperability and it requires a JMS client implementation to connect to the server. In other words the client must have the JMS client libraries of the right version (eg. "jboss-client.jar")

Requirements

Server requirements:

  • Java 7/8
  • Jms 2.0, CDI (JavaEE 6)
  • Currently tested in wildfly 10. Any JavaEE 6 container should be supported.

In order to use the pre-built client

  • Java 7/8
  • Any JAX-WS implementation (Apache CXF, or the one provided with the JDK).

Clients that don't fulfill the requirements (eg. Axis or .NET) must implement a client starting from the wsdl.

What's next?

Learn how to integrate the library:

  • Have a look at the user guide , to understand how to use the library.
  • Learn how to deploy the library into your project, and customize it to your need.
  • Post your doubts on the users forum . We will be glad to help you, and to answer your questions! The forum is moderated, and it has very few messages per year. (Please don't contact project administrators on private email, your doubts might be useful to other users.)
  • Tell us your ideas. We're ready to implement them!
  • Show us your appreciation! Like us on Google+, give us feedbacks.