JMS Message Store persists messages in a JMS queue inside a JMS Broker. It can be configured by giving the class value as org.apache.synapse.message.store.impl.jms.JmsStore
. Since they persist messages in a JMS queue in an ordered manner, JMS message stores can be used to implement a store-and-forward pattern that has quality-of-service parameters like guaranteed delivery and reliability.
Configuration to connect to a broker is provided as parameter values.
JMS Message Store Parameters
Parameter Name | Value | Required |
---|---|---|
java.naming.factory.initial | Initial Context Factory to use to connect to the JMS broker | YES |
java.naming.provider.url | Url of the naming provider to be used by the context factory | YES |
store.jms.destination | JNDI Name of the Queue Name that message store is connecting | NO but for some JMS clients this will be needed |
store.jms.connection.factory | JNDI name of the Connection factory which is used to create jms connections | NO but for some JMS clients this will be needed |
store.jms.username | User Name that is used to create the connection with the broker | NO |
store.jms.password | Password that is used to create the connection with the broker | NO |
store.jms.JMSSpecVersion | 1.1 or 1.0 JMS API specification to be used (Default 1.1) | NO |
store.jms.cache.connection | true/false Enable Connection caching | NO |
For more information about message stores, see Message Stores .
UI Configuration
- On the Management Console, click Message Stores on the left navigator. This opens the Manage Message Stores page.
- Click the Add Message Stores tab and then click Add JMS Message Store. This opens the JMS Message Store page.
The following parameters are specific to the JMS Message Store:- Name - The unique name of the message store.
- Initial Context Factore - The initial context factory to be used to connect to the JMS broker.
- Provider URL - The url of the naming provider to be used by the context factory.
- If you want to configure the additional parameters, click Show Additional Parameters.
Then the page with all the available JMS Message Store options appears.
Additional JMS Message Store parameter details are as follows:
- JNDI Queue Name - JNDI Name of the Queue Name that message store is connecting
- Connection factory - JNDI name of the Connection factory which is used to create jms connections
- User Name - User Name that is used to create the connection with the broker
- Password - Password that is used to create the connection with the broker
- JMS API specification Version - 1.1 or 1.0 JMS API specification to be used (Default 1.1)
- Enable Connection caching - true/false Enable Connection caching
Eg:- Value can be 0-9 for ActiveMQ