2018-03-08 15:46:38 -05:00
|
|
|
# Core Architecture
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis core is designed simply as set of Plain Old Java Objects
|
2014-12-04 10:25:29 -05:00
|
|
|
(POJOs) - we hope you like its clean-cut design.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Each Apache ActiveMQ Artemis server has its own ultra high performance persistent
|
2014-12-04 10:25:29 -05:00
|
|
|
journal, which it uses for message and other persistence.
|
|
|
|
|
|
|
|
Using a high performance journal allows outrageous persistence message
|
|
|
|
performance, something not achievable when using a relational database
|
|
|
|
for persistence.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis clients, potentially on different physical machines interact
|
|
|
|
with the Apache ActiveMQ Artemis server. Apache ActiveMQ Artemis currently provides two APIs for
|
2014-12-04 10:25:29 -05:00
|
|
|
messaging at the client side:
|
|
|
|
|
2017-03-09 11:59:09 -05:00
|
|
|
1. Core client API. This is a simple intuitive Java API that is aligned with the Artemis internal Core. Allowing more
|
|
|
|
control of broker objects, like for example, direct creation of addresses and queues. The Core API also offers a
|
|
|
|
full set of messaging functionality without some of the complexities of JMS.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2017-03-09 11:59:09 -05:00
|
|
|
2. JMS client API. The standard JMS API is available at the client side.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis also provides different protocol implementations on the server so you can use respective clients for these protocols:
|
2015-02-25 15:29:36 -05:00
|
|
|
|
2017-03-09 11:59:09 -05:00
|
|
|
1. AMQP
|
2015-02-25 15:29:36 -05:00
|
|
|
2. OpenWire
|
2017-03-09 11:59:09 -05:00
|
|
|
3. MQTT
|
|
|
|
4. STOMP
|
|
|
|
5. HornetQ (for use with HornetQ clients).
|
|
|
|
6. CORE (Artemis CORE protocol)
|
2015-02-25 15:29:36 -05:00
|
|
|
|
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
JMS semantics are implemented by a JMS facade layer on the client side.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
The Apache ActiveMQ Artemis server does not speak JMS and in fact does not know
|
2014-12-04 10:25:29 -05:00
|
|
|
anything about JMS, it is a protocol agnostic messaging server designed
|
|
|
|
to be used with multiple different protocols.
|
|
|
|
|
|
|
|
When a user uses the JMS API on the client side, all JMS interactions
|
2015-04-27 17:32:30 -04:00
|
|
|
are translated into operations on the Apache ActiveMQ Artemis core client API before
|
|
|
|
being transferred over the wire using the Apache ActiveMQ Artemis wire format.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
|
|
|
The server always just deals with core API interactions.
|
|
|
|
|
|
|
|
A schematic illustrating this relationship is shown in figure 3.1 below:
|
|
|
|
|
2015-05-13 06:12:07 -04:00
|
|
|
![ActiveMQ Artemis architecture1](images/architecture1.jpg)
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Figure 3.1 shows two user applications interacting with an Apache ActiveMQ Artemis
|
2014-12-04 10:25:29 -05:00
|
|
|
server. User Application 1 is using the JMS API, while User Application
|
|
|
|
2 is using the core client API directly.
|
|
|
|
|
|
|
|
You can see from the diagram that the JMS API is implemented by a thin
|
|
|
|
facade layer on the client side.
|
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
## Stand-alone Broker
|
2017-03-09 11:59:09 -05:00
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
The normal stand-alone messaging broker configuration comprises a core
|
|
|
|
messaging broker and a number of protocol managers that provide support for
|
|
|
|
the various protocol mentioned earlier. Protocol managers are pluggable
|
2017-03-09 11:59:09 -05:00
|
|
|
if you
|
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
The stand-alone broker configuration uses [Airline](https://github.com/airlift/airline)
|
2017-03-09 11:59:09 -05:00
|
|
|
for bootstrapping the Broker.
|
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
The stand-alone broker architecture is shown in figure 3.3 below:
|
2017-03-09 11:59:09 -05:00
|
|
|
|
|
|
|
![ActiveMQ Artemis architecture3](images/architecture3.jpg)
|
|
|
|
|
|
|
|
For more information on server configuration files see [Server Configuration](configuration-index.md)
|
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
## Embedded Broker
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis core is designed as a set of simple POJOs so if you have an
|
2014-12-04 10:25:29 -05:00
|
|
|
application that requires messaging functionality internally but you
|
2018-03-08 15:46:38 -05:00
|
|
|
don't want to expose that as an Apache ActiveMQ Artemis broker you can directly
|
|
|
|
instantiate and embed Apache ActiveMQ Artemis brokers in your own application.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-10-05 14:22:45 -04:00
|
|
|
For more information on embedding Apache ActiveMQ Artemis, see [Embedding Apache ActiveMQ Artemis](embedding-activemq.md).
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2018-03-08 15:46:38 -05:00
|
|
|
## Integrated with a Java EE application server
|
2014-12-04 10:25:29 -05:00
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Apache ActiveMQ Artemis provides its own fully functional Java Connector Architecture
|
|
|
|
(JCA) adaptor which enables it to be integrated easily into any Java EE
|
2014-12-04 10:25:29 -05:00
|
|
|
compliant application server or servlet engine.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Java EE application servers provide Message Driven Beans (MDBs), which are a
|
2014-12-04 10:25:29 -05:00
|
|
|
special type of Enterprise Java Beans (EJBs) that can process messages
|
|
|
|
from sources such as JMS systems or mail systems.
|
|
|
|
|
|
|
|
Probably the most common use of an MDB is to consume messages from a JMS
|
|
|
|
messaging system.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
According to the Java EE specification, a Java EE application server uses a JCA
|
2014-12-04 10:25:29 -05:00
|
|
|
adapter to integrate with a JMS messaging system so it can consume
|
|
|
|
messages for MDBs.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
However, the JCA adapter is not only used by the Java EE application server
|
2014-12-04 10:25:29 -05:00
|
|
|
for *consuming* messages via MDBs, it is also used when sending message
|
|
|
|
to the JMS messaging system e.g. from inside an EJB or servlet.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
When integrating with a JMS messaging system from inside a Java EE
|
2014-12-04 10:25:29 -05:00
|
|
|
application server it is always recommended that this is done via a JCA
|
|
|
|
adaptor. In fact, communicating with a JMS messaging system directly,
|
2015-04-27 17:32:30 -04:00
|
|
|
without using JCA would be illegal according to the Java EE specification.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
|
|
|
The application server's JCA service provides extra functionality such
|
|
|
|
as connection pooling and automatic transaction enlistment, which are
|
|
|
|
desirable when using messaging, say, from inside an EJB. It is possible
|
|
|
|
to talk to a JMS messaging system directly from an EJB, MDB or servlet
|
|
|
|
without going through a JCA adapter, but this is not recommended since
|
|
|
|
you will not be able to take advantage of the JCA features, such as
|
|
|
|
caching of JMS sessions, which can result in poor performance.
|
|
|
|
|
2015-04-27 17:32:30 -04:00
|
|
|
Figure 3.2 below shows a Java EE application server integrating with a
|
|
|
|
Apache ActiveMQ Artemis server via the Apache ActiveMQ Artemis JCA adaptor. Note that all
|
2014-12-04 10:25:29 -05:00
|
|
|
communication between EJB sessions or entity beans and Message Driven
|
2015-04-27 17:32:30 -04:00
|
|
|
beans go through the adaptor and not directly to Apache ActiveMQ Artemis.
|
2014-12-04 10:25:29 -05:00
|
|
|
|
|
|
|
The large arrow with the prohibited sign shows an EJB session bean
|
2015-04-27 17:32:30 -04:00
|
|
|
talking directly to the Apache ActiveMQ Artemis server. This is not recommended as
|
2014-12-04 10:25:29 -05:00
|
|
|
you'll most likely end up creating a new connection and session every
|
|
|
|
time you want to interact from the EJB, which is an anti-pattern.
|
|
|
|
|
2015-05-13 06:12:07 -04:00
|
|
|
![ActiveMQ Artemis architecture2](images/architecture2.jpg)
|