Skip to content
Switch branches/tags
Go to file
Cannot retrieve contributors at this time

HazelcastMQ STOMP Server

A STOMP server which maps all SEND and SUBSCRIBE commands to HazelcastMQ Core producers and consumers. This allows non-Java components (such as C, C++, Python, Ruby, etc.) to interact with the MQ capabilities of HazelcastMQ. HazelcastMQ STOMP may be used to integrate into existing frameworks such as Apache Camel's while not requiring any of the JMS complexity.


  • STOMP 1.1 and 1.2 protocols
  • Sending and subscribing
  • Multiple clients on single server
  • Queue and Topic send/receive
  • Header encoding/decoding of special characters
  • Transactions (BEGIN, SEND, COMMIT, ABORT)

Not Implemented Yet

  • Acks (ACK, NACK)

Not Going to Work Any Time Soon

  • Transaction message reception or ACK/NACK (i.e. always auto ACK)


HazelcastMQConfig mqConfig = new HazelcastMQConfig();
HazelcastMQInstance mqInstance = HazelcastMQ
    .newHazelcastMQInstance(mqConfig); // (1)

HazelcastMQStompConfig stompConfig = new HazelcastMQStompConfig(
    mqInstance); // (2)

HazelcastMQStompInstance stompServer = HazelcastMQStomp.
    newHazelcastMQStompInstance(stompConfig); // (3)"Stomp server is now listening on port: "
    + stompConfig.getPort());

Using HazelcastMQ STOMP requires configuring a simple layer on the Core functionality:

  1. Create a HazelcastMQ instance
  2. Create a stomp configuration
  3. Create a stomp server
  4. Connect with STOMP clients

STOMP Send and STOMP Receive

Using the Stomp Server on top of HazelcastMQ Core allows Hazelcast to be used as a distributed messaging system for components written in any language. The STOMP protocol is lightweight and simple to understand.

View the example.

STOMP Send and JMS Receive

Using the Stomp Server on top of HazelcastMQ Core allows a STOMP message to be sent from a STOMP client and then consumed by a JMS consumer as a JMS Message. This allows non-Java components to produce and consumer messages while allowing Java components to use the rich JMS API and enterprise integration patterns.

View the example.