JBoss EAP 6.1 Model Reference

  1. JBoss EAP 6.1
  2. subsystem=messaging
  3. hornetq-server
  4. bridge

The function of a bridge is to consume messages from a source queue, and forward them to a target address, typically on a different HornetQ server.

Attributes (19)

  • check-period The period (in milliseconds) between client failure check.
    • Attribute Value
    Default Value 30000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • confirmation-window-size The confirmation-window-size to use for the connection used to forward messages to the target node.
    • Attribute Value
    Default Value 1048576
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • connection-ttl The maximum time (in milliseconds) for which the connections used by the bridges are considered alive (in the absence of heartbeat).
    • Attribute Value
    Default Value 60000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • discovery-group-name The name of the discovery group used by this bridge. Must be undefined (null) if 'static-connectors' is defined.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • failover-on-server-shutdown Deprecated. Has no runtime effect and a warning will be issued if an attempt is made to set the value of this attribute.
    • Deprecated Since 1.2.0
    Deprecated. Has no runtime effect and a warning will be issued if an attempt is made to set the value of this attribute.
    Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required no-services
  • filter An optional filter string. If specified then only messages which match the filter expression specified will be forwarded. The filter string follows the HornetQ filter expression syntax described in the HornetQ documentation.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • forwarding-address The address on the target server that the message will be forwarded to. If a forwarding address is not specified then the original destination of the message will be retained.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • ha Whether or not this bridge should support high availability. True means it will connect to any available server in a cluster and support failover.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • max-retry-interval The maximum interval of time used to retry connections
    • Attribute Value
    Default Value 2000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • min-large-message-size The minimum size (in bytes) for a message before it is considered as a large message.
    • Attribute Value
    Default Value 102400
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • password The password to use when creating the bridge connection to the remote server. If it is not specified the default cluster password specified by the cluster-password attribute in the root messaging subsystem resource will be used.
    • Attribute Value
    Default Value CHANGE ME!!
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • queue-name The unique name of the local queue that the bridge consumes from.
    • Attribute Value
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • reconnect-attempts The total number of reconnect attempts the bridge will make before giving up and shutting down. A value of -1 signifies an unlimited number of attempts.
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • retry-interval The period in milliseconds between subsequent reconnection attempts, if the connection to the target server has failed.
    • Attribute Value
    Default Value 2000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • retry-interval-multiplier A multiplier to apply to the time since the last retry to compute the time to the next retry. This allows you to implement an exponential backoff between retry attempts.
    • Attribute Value
    Default Value 1.0
    Type BIG_DECIMAL
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • static-connectors A list of names of statically defined connectors used by this bridge. Must be undefined (null) if 'discovery-group-name' is defined.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • transformer-class-name The name of a user-defined class which implements the org.hornetq.core.server.cluster.Transformer interface.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • use-duplicate-detection Whether the bridge will automatically insert a duplicate id property into each message that it forwards.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • user The user name to use when creating the bridge connection to the remote server. If it is not specified the default cluster user specified by the cluster-user attribute in the root messaging subsystem resource will be used.
    • Attribute Value
    Default Value HORNETQ.CLUSTER.ADMIN.USER
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services

Operations (2)

  • add Operation adding a bridge.
    Request Parameter Type Required Expressions Allowed Default value Description
    min-large-message-size INT false true 102400 The minimum size (in bytes) for a message before it is considered as a large message.
    connection-ttl LONG false true 60000 The maximum time (in milliseconds) for which the connections used by the bridges are considered alive (in the absence of heartbeat).
    failover-on-server-shutdown BOOLEAN false false Deprecated. Has no runtime effect and a warning will be issued if an attempt is made to set the value of this attribute.
    retry-interval-multiplier BIG_DECIMAL false true 1.0 A multiplier to apply to the time since the last retry to compute the time to the next retry. This allows you to implement an exponential backoff between retry attempts.
    forwarding-address STRING false true The address on the target server that the message will be forwarded to. If a forwarding address is not specified then the original destination of the message will be retained.
    transformer-class-name STRING false false The name of a user-defined class which implements the org.hornetq.core.server.cluster.Transformer interface.
    ha BOOLEAN false true false Whether or not this bridge should support high availability. True means it will connect to any available server in a cluster and support failover.
    reconnect-attempts INT false true -1 The total number of reconnect attempts the bridge will make before giving up and shutting down. A value of -1 signifies an unlimited number of attempts.
    password STRING false true CHANGE ME!! The password to use when creating the bridge connection to the remote server. If it is not specified the default cluster password specified by the cluster-password attribute in the root messaging subsystem resource will be used.
    static-connectors LIST false false A list of names of statically defined connectors used by this bridge. Must be undefined (null) if 'discovery-group-name' is defined.
    retry-interval LONG false true 2000 The period in milliseconds between subsequent reconnection attempts, if the connection to the target server has failed.
    discovery-group-name STRING false false The name of the discovery group used by this bridge. Must be undefined (null) if 'static-connectors' is defined.
    queue-name STRING true true The unique name of the local queue that the bridge consumes from.
    use-duplicate-detection BOOLEAN false true true Whether the bridge will automatically insert a duplicate id property into each message that it forwards.
    max-retry-interval LONG false true 2000 The maximum interval of time used to retry connections
    confirmation-window-size INT false true 1048576 The confirmation-window-size to use for the connection used to forward messages to the target node.
    user STRING false true HORNETQ.CLUSTER.ADMIN.USER The user name to use when creating the bridge connection to the remote server. If it is not specified the default cluster user specified by the cluster-user attribute in the root messaging subsystem resource will be used.
    filter STRING false true An optional filter string. If specified then only messages which match the filter expression specified will be forwarded. The filter string follows the HornetQ filter expression syntax described in the HornetQ documentation.
    check-period LONG false true 30000 The period (in milliseconds) between client failure check.
  • remove Operation removing a bridge.