WildFly 38 Model Reference

Defines a managed connection factory.

Provided capabilities(1)

Attributes (60)

  • allow-local-transactions Allow local transactions for outbond Jakarta Messaging Sessions (it does not apply to JMSContext that explicitly disallows it).
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • auto-group The autogroup.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • block-on-acknowledge True to set block on acknowledge.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • block-on-durable-send True to set block on durable send.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • block-on-non-durable-send True to set block on non durable send.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • cache-large-message-client True to cache large messages.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • call-failover-timeout The timeout to use when fail over is in process (in ms).
    • Attribute Value
    Default Value 60000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • call-timeout The call time out.
    • Attribute Value
    Default Value 30000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • client-failure-check-period The client failure check period.
    • Attribute Value
    Default Value 30000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • client-id The client id.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • compress-large-messages Whether large messages should be compressed.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • confirmation-window-size The confirmation window size.
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • connection-load-balancing-policy-class-name Name of a class implementing a client-side load balancing policy that a client can use to load balance sessions across different nodes in a cluster.
    • Attribute Value
    Default Value org.apache.activemq.artemis.api.core.client.loadbalance.RoundRobinConnectionLoadBalancingPolicy
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • connection-ttl The connection ttl.
    • Attribute Value
    Default Value 60000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • connectors Defines the connectors. These are stored in a map by connector name (with an undefined value). It is possible to pass a list of connector names when writing this attribute.
    • Attribute Value
    Capability reference org.wildfly.messaging.activemq.connector.external
    Type LIST
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • consumer-max-rate The consumer max rate.
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Unit PER_SECOND
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • consumer-window-size The consumer window size.
    • Attribute Value
    Default Value 1048576
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • credential-reference Credential (from Credential Store) to authenticate the pooled connection factory
    • Attribute Value
    Type OBJECT
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • deserialization-allow-list A list of class names (separated by whitespaces) that are allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • deserialization-black-list A list of class names (separated by whitespaces) that are not allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    • Deprecated Since 13.0.0
    Deprecated. Use deserialization-block-list instead.
    Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Stability default
  • deserialization-block-list A list of class names (separated by whitespaces) that are not allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    • Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • deserialization-white-list A list of class names (separated by whitespaces) that are allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    • Deprecated Since 13.0.0
    Deprecated. Use deserialization-allow-list instead.
    Attribute Value
    Type LIST
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Stability default
  • discovery-group The discovery group name.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • dups-ok-batch-size The dups ok batch size.
    • Attribute Value
    Default Value 1048576
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • enable-amq1-prefix Enable the use of ActiveMQ 1.5.x prefixes in the addresses.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • enlistment-trace Enables IronJacamar to record enlistment traces for this pooled-connection-factory. This attribute is undefined by default and the behaviour is driven by the presence of the ironjacamar.disable_enlistment_trace system property.
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • entries The jndi names the connection factory should be bound to.
    • Attribute Value
    Type LIST
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • failover-on-initial-connection True to fail over on initial connection.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • group-id The group id.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • ha Whether the connection factory supports High Availability.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • initial-connect-attempts The number of attempts to connect initially with this factory.
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • initial-message-packet-size The initial size of messages created through this factory.
    • Attribute Value
    Default Value 1500
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • jndi-params The JNDI params to use for locating the destination for incoming connections.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • managed-connection-pool The class name of the managed connection pool used by this pooled-connection-factory.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • max-pool-size The maximum size for the pool
    • Attribute Value
    Default Value 20
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • max-retry-interval The max retry interval.
    • Attribute Value
    Default Value 2000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • min-large-message-size The min large message size.
    • Attribute Value
    Default Value 102400
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • min-pool-size The minimum size for the pool
    • Attribute Value
    Default Value 0
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • password The default password to use with this connection factory. This is only needed when pointing the connection factory to a remote host.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • pre-acknowledge True to pre-acknowledge.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • producer-max-rate The producer max rate.
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Unit PER_SECOND
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • producer-window-size The producer window size.
    • Attribute Value
    Default Value 65536
    Type INT
    Nillable true
    Expressions Allowed true
    Unit BYTES
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • protocol-manager-factory The protocol manager factory used by this pooled connection factory.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • rebalance-connections Rebalance inbound connections when cluster topology changes.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • reconnect-attempts The reconnect attempts. By default, a pooled connection factory will try to reconnect infinitely to the messaging server(s).
    • Attribute Value
    Default Value -1
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • retry-interval The retry interval.
    • Attribute Value
    Default Value 2000
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • retry-interval-multiplier The retry interval multiplier.
    • Attribute Value
    Default Value 1.0
    Type DOUBLE
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • scheduled-thread-pool-max-size The scheduled thread pool max size.
    • Attribute Value
    Default Value 5
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • setup-attempts The number of times to set up an MDB endpoint
    • Attribute Value
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • setup-interval The interval between attempts at setting up an MDB endpoint.
    • Attribute Value
    Type LONG
    Nillable true
    Expressions Allowed true
    Unit MILLISECONDS
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • statistics-enabled Define whether runtime statistics are enabled.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Stability default
  • thread-pool-max-size The thread pool max size.
    • Attribute Value
    Default Value 30
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • transaction The type of transaction supported by this pooled connection factory (can be LOCAL, NONE or XA, default is XA).
    • Attribute Value
    Default Value xa
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Allowed Values local
    none
    xa
    Stability default
  • transaction-batch-size The transaction batch size.
    • Attribute Value
    Default Value 1048576
    Type INT
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • use-auto-recovery True to use auto recovery.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • use-global-pools True to use global pools.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • use-jndi Use JNDI to locate the destination for incoming connections
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • use-local-tx Use a local transaction for incoming sessions
    • Attribute Value
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • use-topology-for-load-balancing Whether to use topology information from the cluster to connect to it. If set to 'false', only the initial connector will be used.
    • Attribute Value
    Default Value true
    Type BOOLEAN
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
    Stability default
  • user The default username to use with this connection factory. This is only needed when pointing the connection factory to a remote host.
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required no-services
    Stability default

Operations (2)

  • add Adds a managed connection factory.
    Request Parameter Type Required Expressions Allowed Default value Description
    auto-group BOOLEAN false true false The autogroup.
    block-on-acknowledge BOOLEAN false true false True to set block on acknowledge.
    block-on-durable-send BOOLEAN false true true True to set block on durable send.
    block-on-non-durable-send BOOLEAN false true false True to set block on non durable send.
    cache-large-message-client BOOLEAN false true false True to cache large messages.
    call-failover-timeout LONG false true 60000 The timeout to use when fail over is in process (in ms).
    call-timeout LONG false true 30000 The call time out.
    client-failure-check-period LONG false true 30000 The client failure check period.
    client-id STRING false true The client id.
    compress-large-messages BOOLEAN false true false Whether large messages should be compressed.
    confirmation-window-size INT false true -1 The confirmation window size.
    connection-load-balancing-policy-class-name STRING false false org.apache.activemq.artemis.api.core.client.loadbalance.RoundRobinConnectionLoadBalancingPolicy Name of a class implementing a client-side load balancing policy that a client can use to load balance sessions across different nodes in a cluster.
    connection-ttl LONG false true 60000 The connection ttl.
    connectors LIST true false Defines the connectors. These are stored in a map by connector name (with an undefined value). It is possible to pass a list of connector names when writing this attribute.
    consumer-max-rate INT false true -1 The consumer max rate.
    consumer-window-size INT false true 1048576 The consumer window size.
    credential-reference OBJECT false false Credential (from Credential Store) to authenticate the pooled connection factory
    deserialization-allow-list LIST false true A list of class names (separated by whitespaces) that are allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    deserialization-black-list LIST false true A list of class names (separated by whitespaces) that are not allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    deserialization-block-list LIST false true A list of class names (separated by whitespaces) that are not allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    deserialization-white-list LIST false true A list of class names (separated by whitespaces) that are allowed to be used in serialization of Jakarta Messaging ObjectMessage.
    discovery-group STRING false false The discovery group name.
    dups-ok-batch-size INT false true 1048576 The dups ok batch size.
    enable-amq1-prefix BOOLEAN false true true Enable the use of ActiveMQ 1.5.x prefixes in the addresses.
    enlistment-trace BOOLEAN false true Enables IronJacamar to record enlistment traces for this pooled-connection-factory. This attribute is undefined by default and the behaviour is driven by the presence of the ironjacamar.disable_enlistment_trace system property.
    entries LIST true true The jndi names the connection factory should be bound to.
    failover-on-initial-connection BOOLEAN false true false True to fail over on initial connection.
    group-id STRING false true The group id.
    ha BOOLEAN false true true Whether the connection factory supports High Availability.
    initial-connect-attempts INT false true -1 The number of attempts to connect initially with this factory.
    initial-message-packet-size INT false true 1500 The initial size of messages created through this factory.
    managed-connection-pool STRING false true The class name of the managed connection pool used by this pooled-connection-factory.
    max-pool-size INT false true 20 The maximum size for the pool
    max-retry-interval LONG false true 2000 The max retry interval.
    min-large-message-size INT false true 102400 The min large message size.
    min-pool-size INT false true 0 The minimum size for the pool
    password STRING false true The default password to use with this connection factory. This is only needed when pointing the connection factory to a remote host.
    pre-acknowledge BOOLEAN false true false True to pre-acknowledge.
    producer-max-rate INT false true -1 The producer max rate.
    producer-window-size INT false true 65536 The producer window size.
    protocol-manager-factory STRING false false The protocol manager factory used by this pooled connection factory.
    reconnect-attempts INT false true -1 The reconnect attempts. By default, a pooled connection factory will try to reconnect infinitely to the messaging server(s).
    retry-interval LONG false true 2000 The retry interval.
    retry-interval-multiplier DOUBLE false true 1.0 The retry interval multiplier.
    scheduled-thread-pool-max-size INT false true 5 The scheduled thread pool max size.
    statistics-enabled BOOLEAN false true false Define whether runtime statistics are enabled.
    thread-pool-max-size INT false true 30 The thread pool max size.
    transaction STRING false true xa The type of transaction supported by this pooled connection factory (can be LOCAL, NONE or XA, default is XA).
    transaction-batch-size INT false true 1048576 The transaction batch size.
    use-auto-recovery BOOLEAN false true true True to use auto recovery.
    use-global-pools BOOLEAN false true true True to use global pools.
    use-topology-for-load-balancing BOOLEAN false true true Whether to use topology information from the cluster to connect to it. If set to 'false', only the initial connector will be used.
    user STRING false true The default username to use with this connection factory. This is only needed when pointing the connection factory to a remote host.
    jndi-params STRING false true The JNDI params to use for locating the destination for incoming connections.
    rebalance-connections BOOLEAN false true false Rebalance inbound connections when cluster topology changes.
    setup-attempts INT false true The number of times to set up an MDB endpoint
    setup-interval LONG false true The interval between attempts at setting up an MDB endpoint.
    use-jndi BOOLEAN false true Use JNDI to locate the destination for incoming connections
    use-local-tx BOOLEAN false true Use a local transaction for incoming sessions
    allow-local-transactions BOOLEAN false true false Allow local transactions for outbond Jakarta Messaging Sessions (it does not apply to JMSContext that explicitly disallows it).
  • remove Removes managed connection factory.