Qpid JMS event receiver is is an internal event receiver that receiver that comes with WSO2 products by default. You can configure it with map, XML, JSON, and text input mapping types.
| Table of Contents | ||
|---|---|---|
|
Prerequisites
Follow the steps below to set up the prerequisites before starting the event receiver configurations.
Install JMS-Qpid Broker and JMS-Qpid Client.
Add the following broker-specific JAR files to- <PRODUCT
Configure WSO2 CEP by adding relevant libraries to support JMS transport.
Open the
components<CEP_HOME>/repository/
lib/ directory.conf/
<ACTIVEMQ_HOME>/lib/geronimo-jms_1.1_spec-1.0.jar<QPID-CLIENT_HOME>/lib/ qpid-client-xxx.jar- Start the Qpid JMS server.
<QPID-CLIENT_HOME>/lib/ qpid-common-xxx.jar jndi.properties file and register a connection factory by entering relevant details in the register some connection factories section. Below is a sample for a connection factory named TopicConnectionFactory( the "default" is the name of the virtually hosted node in Qpid).
connectionfactory.TopicConnectionFactory=amqp://admin:admin@clientid/default?brokerlist='tcp://localhost:5672' |
...
For instructions on creating a Qpid JMS event receiver, see Receiving EventsConfiguring Event Receivers.
Configuring adapter properties
...
| Adapter Property | Description | Configuration file property | Example |
|---|---|---|---|
| Topic/Queue Name | Valid name for the JMS topic. WSO2 CEP/DAS sends and receives messages by subscribing to a topic or using named queues. | transport.jms.Destination | test-topic |
| JNDI Initial Context Factory Class | JNDI initial context factory class. The class must implement the | java.naming.factory.initial | org.apache.qpid.jndi.PropertiesFileInitialContextFactory |
| JNDI Provider URL | URL of the JNDI provider. | java.naming.provider.url | repository/conf/jndi.properties |
| The JMS connection password | A valid password for the JMS connection | transport.jms.Password | jms-password |
| The JMS connection username | A valid username for the JMS connection | transport.jms.UserName | jms-user |
| Connection Factory JNDI Name | The JNDI name of the connection factory. | transport.jms.ConnectionFactoryJNDIName | TopicConnectionFactory |
| Destination Type | Define the sort order for messages that arrive on a specific destination. | transport.jms.DestinationType | topic/queue |
| Enable Durable Subscription | Whether the subscription is durable or not. | transport.jms.SubscriptionDurable | true/false |
| Durable Subscriber Name | A valid name of a durable subscriber (Durable subscription gets enabled if you add a value here.) | transport.jms.DurableSubscriberName | subscriber |
| JMS Properties | A valid "property:value" pair of Axis2 JMS properties. (E.g. "property1: value1, property2: value2") For more information on Axis2 JMS properties, go to Apache AXIS2 Transports Documentation . | jms.properties | SessionTransacted:false |
Related samples
For more information on Qpid event receiver type, see the following sample.