JMS (The Java Message Service (JMS) transport implementation also comes from the WS-Commons Transports project. All the relevant classes are packed into the axis2-transport-jms-<version>.jar and the following classes act as the transport receiver and the sender respectively.
...
These JAR files can be obtained by downloading the latest version of Apache ActiveMQ (version 5.2.0 or later is recommended). Extract the downloaded archive and find the required dependencies in the $ACTIVEMQ_HOME/lib directory. You need to copy these JAR files over to $CARBON_HOME/repository/components/lib directory for Carbon to be able to pick them up at runtime.
...
Parameter Name | Description | RequriedRequired | Possible Values | Default Value | |
|---|---|---|---|---|---|
java.naming.factory.initial | JNDI initial context factory class. The class must implement the | Yes | A valid class name |
| |
java.naming.provider.url | URL of the JNDI provider. | Yes | A valid URL |
| |
java.naming.security.principal | JNDI Username. | No |
|
| |
java.naming.security.credentials | JNDI password. | No |
|
| |
transport.Transactionality | Desired mode of transactionality. | No | none, local, jta | none | |
transport.UserTxnJNDIName | JNDI name to be used to require user transaction. | No |
| java:comp/UserTransaction | |
transport.CacheUserTxn | Whether caching for user transactions should be enabled or not. | No | true, false | true | |
transport.jms.SessionTransacted | Whether the JMS session should be transacted or not. | No | true, false | true if transactionality is 'local' | |
transport.jms.SessionAcknowledgement | JMS session acknowledgment mode. | No | AUTO_ACKNOWLEDGE, CLIENT_ACKNOWLEDGE, DUPS_OK_ACKNOWLEDGE, SESSION_TRANSACTED | AUTO_ACKNOWLEDGE | |
transport.jms.ConnectionFactoryJNDIName | The JNDI name of the connection factory. | Yes |
|
| |
transport.jms.ConnectionFactoryType | Type of the connection factory. | No | queue, topic | queue | |
transport.jms.JMSSpecVersion | JMS API version. | No | 1.1, 1.0.2b | 1.1 | |
transport.jms.UserName | The JMS connection username. | No |
|
| |
transport.jms.Password | The JMS connection password. | No |
|
| |
transport.jms.Destination | The JNDI name of the destination. | No |
| Defaults to service name | |
transport.jms.DestinationType | Type of the destination. | No | queue, topic | queue | |
transport.jms.DefaultReplyDestination | JNDI name of the default reply destination. | No |
|
| |
transport.jms.DefaultReplyDestinationType | Type of the reply destination. | No | queue, topic | Defaults to the type of the destination | |
transport.jms.MessageSelector | Message selector implementation. | No |
|
| |
transport.jms.SubscriptionDurable | Whether the connection factory is subscription durable or not. | No | true, false | false | |
| transport.jms. | DurableSubscriberNameNameDurableSubscriberClientID | The ClientId parameter when using durable subscriptions | Required if the value specified as transport.jms.SubscriptionDurable is true. | ||
transport.jms.DurableSubscriberName | The name of the durable subscriber. | Yes Required if the subscription durable is turned onvalue specified as |
|
| |
transport.jms.PubSubNoLocal | Whether the messages should be published by the same connection they were received. | No | true, false | false | |
transport.jms.CacheLevel | JMS resource cache level. | Nonone, connection, session, consumer, producer, auto | The cache level, with which JMS objects should be cached at start up. You can configure this in the
| auto | |
transport.jms.ReceiveTimeout | Time to wait for a JMS message during polling. Set this parameter value to a negative integer to wait indefinitely. Set to zero to prevent waiting. | No | Number of milliseconds to wait | 1000 ms | |
transport.jms.ConcurrentConsumers | Number of concurrent threads to be started to consume messages when polling. | No | Any positive integer - For topics this must be always 1 | 1 | |
transport.jms.MaxConcurrentConsumers | Maximum number of concurrent threads to use during polling. | No | Any positive integer - For topics this must be always 1 | 1 | |
transport.jms.IdleTaskLimit | The number of idle runs per thread before it dies out. | No | Any positive integer | 10 | |
transport.jms.MaxMessagesPerTask | The maximum number of successful message receipts per thread. | No | Any positive integer - Use -1 to indicate infinity | -1 | |
transport.jms.InitialReconnectDuration | Initial reconnection attempts duration in milliseconds. | No | Any positive integer | 10000 ms | |
transport.jms.ReconnectProgressFactor | Factor by which the reconnection duration will be increased. | No | Any positive integer | 2 | |
transport.jms.MaxReconnectDuration | Maximum reconnection duration in milliseconds. | No |
| 3600000 ms (1 hr) | |
transport.jms.MaxJMSConnections | Maximum cached JMS connections in the producer level. | No | Any positive integer value | 10 |
JMS transport implementation has some parameters that should be configured at service level, in other words in service XML files of individual services.
Service Level JMS Configuration Parameters
Following are some of the common parameters you can set at the service level.
Parameter Name | Description | RequriedRequired | Possible Values | Default Value |
|---|---|---|---|---|
transport.jms.ConnectionFactory | Name of the JMS connection factory the service should use. | No | A name of an already defined connection factorydefault | |
transport.jms.PublishEPR | JMS EPR to be published in the WSDL. | No | A JMS EPR |
|
Please, refer Introduction to Switching Transports, Switching from HTTP/S to JMS, Pure Text/Binary and POX Message Support with JMS, Bridging from JMS to HTTP and Replying with a 202 Accepted Response that illustrate the usage of the JMS transport in a number of useful scenarios.
...
| hidden | true |
|---|
...
| transport.jms.ContentType | Specifies how the transport listener should determine the content type of received messages. | No | A simple string value, in which case the transport listener assumes that the received messages always have the specified content type, or a set of rules. For more information, see http://axis.apache.org/axis2/java/transports/jms.html#Service_configuration. |
For more information, see Java Message Service (JMS) Support.