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
Red Hat logoGithubRedditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

© 2024 Red Hat, Inc.