11.4.2. JCA Adapter ra.xml Configuration

The ra.xml file contains configuration parameters for the JCA Adapter. In some application server environments this file is edited directly to change configuration, in other environments (such as JBoss EAP 5) it is overridden by configuration in a *-ds.xml file.
The following are the properties set in the ra.xml file that can be configured or overridden:

Table 11.1. ResourceAdapter Properties

Parameter Description Default Value
ClientId
Client ID for the connection
client_id
SetupAttempts
Number of setup attempts before failing
5
SetupInterval
Interval between setup attempts in milliseconds
5000
UseLocalTx
Use local transations rather than XA
false
Host
Broker host
localhost
Port
Broker port
5672
Path
Virtual Path for Connection Factory
test
ConnectionURL
Connection URL
amqp://anonymous:passwd@client/test?brokerlist='tcp://localhost?sasl_mechs='PLAIN''
UseConnectionPerHandler
Use a JMS Connection per MessageHandler
true

Table 11.2. Outbound ResourceAdapter Properties

Parameter Description Default Value
SessionDefaultType
Default session type
javax.jms.Queue
UseTryLock
Specify lock timeout in seconds
0
UseLocalTx
Use local transactions rather than XA
false
ClientId
Client ID for the connection
client_id
ConnectionURL
Connection URL
Host
Broker host
localhost
Port
Broker port
5672
Path
Virtual Path for Connection Factory
test
Inbound ResourceAdapter and AdminObjects

Additionally, the ra.xml file contains configuration for the Inbound Resource Adapter and Administered Objects (AdminObject). The configuration for these two differs from the Resource Adapter and Outbound Resource Adapter configuration. The Resource Adapter and Outbound Resource Adapter configuration sets values for configuration parameters in the ra.xml file. The Inbound Resource Adapter and Admin Object define configuration parameters, but do not set them. It is the responsibility of the Administered Object mbean definition to set the properties defined in ra.xml.

Table 11.3. AdminObject Properties

AdminObject Class Property
org.apache.qpid.ra.admin.QpidQueue
DestinationAddress
org.apache.qpid.ra.admin.QpidTopic
DestinationAddress
org.apache.qpid.ra.admin.QpidConnectionFactoryProxy
ConnectionURL