This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

Message Stores

A message store is used to temporarily store messages before they are delivered to their destination by a message processor. This approach is useful for serving traffic to back-end services that can only accept messages at a given rate, whereas incoming traffic to the EI arrives at different rates. To store incoming traffic in a message store, use the Store mediator, and then use a message processor to deliver messages to the back-end service at a given rate.

Multiple message processors can use the same message store. For example, in a clustered environment, each of the nodes would have an instance of the same message processor, each of which would connect to the same message store and evenly consume messages from it. The message store acts as a manager of these consumers and their connections and ensures that messages are processed by only one message processor, preventing message duplication. You can further control which nodes a message processor runs on by specifying pinned servers.

You can implement your own message store by implementing the MessageStore interface and adding the store to the configuration. The EI ships with the following message store implementations:

Message Store Configuration

<messageStore name="string" class="className">
  <parameter name="string" > "string" </parameter>\*
</messageStore>

You enable a message store in the EI configuration by adding the <messageStore> element. This element is a top-level entry in the configuration and must have a unique name. The class attribute value is the fully qualified class name of the underlying message store implementation, and the parameters section is used to configure the parameters that are needed by that implementation.

You can add, edit, and delete message stores in the Management Console.

Note

Message Store does not work in tenant mode. It is a limitation in the current implementation.

Sample

Sample 700: Introduction to Message Store