Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Option

Default

Description

ssl

false

Set the default for all connections. This can be overridden by the individual broker url.

brokerlist

see below

The list of brokers to use for this connection

failover

see below

The type of failover method to use with the broker list.

cyclecount

0

The number of times to loop through the list of available brokers before failure.

Brokerlist option

No Format
brokerlist='<broker url>[;<broker url>]'

The broker list defines the various brokers that can be used for this connection. A minimum of one broker url is required additional URLs are semi-colon(';') delimited.

Broker URL format

No Format
<transport>://<host>[:<port>][?<option>='<value>'[&<option>='<value>']]

...

Option

Default

Description

retries

1

The number of times to retry connection to this Broker

ssl

false

Use ssl on the connection

connecttimeout

30000

How long in (milliseconds) to wait for the connection to succeed

connectdelay

none

How long in (milliseconds) to wait before attempting to reconnect

Brokerlist failover option

No Format
failover='<method>[?<options>]'

...

The current defaults are naturally to use the 'singlebroker' when only one broker is present and the 'roundrobin' method with multiple brokers. The '''method''' value in the URL may also be any valid class on the classpath that implements the FailoverMethod interface.

Sample URLs

No Format
amqp:///test?brokerlist='localhost'
amqp:///test?brokerlist='tcp://anotherhost:5684?retries='10''
amqp://guest:guest@/test?brokerlist='vm://:1;vm://:2'&failover='roundrobin'
amqp://guest:guest@/test?brokerlist='vm://:1;vm://:2'&cyclecount='20'
amqp://guest:guest@client/test?ssl='true'&brokerlist='tcp://localhost;tcp://redundant-server:5673?ssl='false''&failover='roundrobin'