Chapter 12. Configuring connection factories
By default, the JBoss EAP messaging-activemq subsystem provides the InVmConnectionFactory and RemoteConnectionFactory. You can also define additional connection factories or pooled connection factories, whether connecting to the embedded broker or to a remote ActiveMQ Artemis broker.
- Basic connection factories
-
InVmConnectionFactoryreferences anin-vm-connectorand can be used only when an embedded broker is present and both the client and server run in the same JVM.
RemoteConnectionFactory references an http-connector and can be used to send and receive messages over HTTP when the client and server run in different JVMs. This factory can be defined even when no embedded broker is present, allowing applications to connect directly to a remote ActiveMQ Artemis server.
<subsystem xmlns="urn:jboss:domain:messaging-activemq:17.0">
<server name="default">
...
<connection-factory name="InVmConnectionFactory" connectors="in-vm" entries="java:/ConnectionFactory"/>
<connection-factory name="RemoteConnectionFactory" connectors="http-connector" entries="java:jboss/exported/jms/RemoteConnectionFactory"/>
...
</server>
</subsystem>
For configurations that connect only to a remote broker (no embedded broker), connection factories are defined directly under the messaging-activemq subsystem, without the server=default element:
<subsystem xmlns="urn:jboss:domain:messaging-activemq:17.0">
<connection-factory name="RemoteConnectionFactory" connectors="http-connector" entries="java:/RemoteCF"/>
</subsystem>For more information about connector types, see the Acceptors and Connectors section.
- Add a connection factory
-
When adding a connection factory, you must provide the
connectorsand the JNDIentries.
With an embedded broker:
/subsystem=messaging-activemq/server=default/connection-factory=MyConnectionFactory:add(entries=[java:/MyConnectionFactory],connectors=[in-vm])With no embedded broker (remote‑only):
/subsystem=messaging-activemq/connection-factory=MyConnectionFactory:add(entries=[java:/MyConnectionFactory],connectors=[http-connector])- Configure a connection factory
/subsystem=messaging-activemq/server=default/connection-factory=MyConnectionFactory:write-attribute(name=thread-pool-max-size,value=40)For a remote‑only configuration:
/subsystem=messaging-activemq/connection-factory=MyConnectionFactory:write-attribute(name=thread-pool-max-size,value=40)- Remove a connection factory
/subsystem=messaging-activemq/server=default/connection-factory=MyConnectionFactory:removeRemote‑only:
/subsystem=messaging-activemq/connection-factory=MyConnectionFactory:remove- Pooled connection factories
-
The JBoss EAP
messaging-activemqsubsystem provides a pooled connection factory that configures the inbound and outbound connectors of the integrated ActiveMQ Artemis resource adapter. A pooled connection factory can be defined whether you are connecting to the embedded broker or to a remote broker.
subsystem xmlns="urn:jboss:domain:messaging-activemq:17.0">
...
<server name="default">
<pooled-connection-factory name="activemq-ra" entries="java:/JmsXA java:jboss/DefaultJMSConnectionFactory" connectors="in-vm" transaction="xa"/>
</server>
</subsystem>
For remote‑only configurations, the pooled connection factory is defined without server=default:
<subsystem xmlns="urn:jboss:domain:messaging-activemq:17.0">
...
<server name="default">
<pooled-connection-factory name="activemq-ra" entries="java:/JmsXA java:jboss/DefaultJMSConnectionFactory" connectors="http-connector" transaction="xa"/>
</server>
</subsystem>Unique characteristics of a pooled connection factory:
- It is available only to local clients, though it can point to a remote server.
- It should only be used to send messages when looked up in JNDI or injected.
- It can be configured with security credentials, useful for secured remote servers.
Resources acquired from it can be automatically enlisted in any ongoing Jakarta Transactions transaction.
- Add a pooled connection factory
- Embedded broker:
/subsystem=messaging-activemq/server=default/pooled-connection-factory=MyPooledCF:add(entries=[java:/MyPooledCF],connectors=[in-vm])Remote‑only:
/subsystem=messaging-activemq/pooled-connection-factory=MyPooledCF:add(entries=[java:/MyPooledCF],connectors=[http-connector])- Configure a pooled connection factory
/subsystem=messaging-activemq/server=default/pooled-connection-factory=MyPooledCF:write-attribute(name=max-retry-interval,value=3000)Remote-only:
/subsystem=messaging-activemq/pooled-connection-factory=MyPooledCF:write-attribute(name=max-retry-interval,value=3000)- Remove a pooled connection factory
- Embedded broker:
/subsystem=messaging-activemq/server=default/pooled-connection-factory=MyPooledConnectionFactory:removeRemote‑only:
/subsystem=messaging-activemq/pooled-connection-factory=MyPooledConnectionFactory:remove
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}