Protocols and Interoperability
Apache ActiveMQ Artemis has a powerful & flexible core which provides a foundation upon which other protocols can be implemented. Each protocol implementation translates the ideas of its specific protocol onto this core.
The broker ships with a client implementation which interacts directly with this core. It uses what's called the "core" API, and it communicates over the network using the "core" protocol.
Supported Protocols & APIs
The broker has a pluggable protocol architecture. Protocol plugins come in the form of protocol modules. Each protocol module is included on the broker's class path and loaded by the broker at boot time. The broker ships with 5 protocol modules out of the box. The 5 modules offer support for the following protocols:
APIs and Other Interfaces
Although JMS is a standardized API, it does not define a network protocol. The ActiveMQ Artemis JMS 2.0 client is implemented on top of the core protocol. We also provide a client-side JNDI implementation.
The broker also ships with a REST messaging interface (not to be confused with the REST management API provided via our integration with Jolokia).
In order to make use of a particular protocol, a transport must be configured with the desired protocol enabled. There is a whole section on configuring transports that can be found here.
The default configuration shipped with the ActiveMQ Artemis distribution comes with a number of acceptors already
defined, one for each of the above protocols plus a generic acceptor that supports all protocols. To enable
protocols on a particular acceptor simply add the
protocols url parameter to the acceptor url where the value is one
or more protocols (separated by commas). If the
protocols parameter is omitted from the url all protocols are
The following example enables only MQTT on port 1883
<acceptors> <acceptor>tcp://localhost:1883?protocols=MQTT</acceptor> </acceptors>
The following example enables MQTT and AMQP on port 1883
<acceptors> <acceptor>tcp://localhost:5672?protocols=MQTT,AMQP</acceptor> </acceptors>
The following example enables all protocols on
<acceptors> <acceptor>tcp://localhost:61616</acceptor> </acceptors>
Here are the supported protocols and their corresponding value used in the
protocols url parameter.
|Core (Artemis & HornetQ native)||
|OpenWire (5.x native)||