目錄
《ActiveMQ 基本使用》中已經介紹了 ActiveMQ 命令行啓動,本文詳細介紹 ActiveMQ 的啓動方式。
命令行啓動
1、下載解壓 ActiveMQ 後,進入 bin 目錄下,命令行啓動:
1)activemq start:此時將默認使用 conf 目錄下的 activemq.xml 配置文件進行啓動
2)activemq start xbean:file:../conf/activemq.xml:使用指定的配置文件進行啓動
2、ActiveMQ 默認採用 61616 端口提供 JMS 服務,使用 8161 端口提供管理控制檯服務
3、ActiveMQ 的 web 管理頁面:http://localhost:8161/admin;默認賬號密碼是 admin/admin
4、關閉 ActiveMQ:進入 %ActiveMQ_HOME%/bin目錄下,執行:activemq stop
嵌入式啓動
1、如同 Tomcat 可以內嵌在 Java 應用中一樣,ActiveMQ 也可以內嵌在 Java 應用中使用,作爲獨立的消息服務器,無縫集成 Java 應用。
2、環境:Maven 3.6.1 + Java JDK 1.8 + ActiveMQ 5.15.9 + IDEA 2018 ,Mava 管理的 Java SE 應用,進行編碼演示。使用非常簡單:
1)導入 activemq-all 依賴。(json 數據轉換需要依賴 jackjson)
2)使用 BrokerService 啓動 ActiveMQ 服務。(內嵌啓動默認是沒有提供 8161 的 web 管理界面的)
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.wmx</groupId>
<artifactId>activeMQ1</artifactId>
<version>1.0-SNAPSHOT</version>
<dependencies>
<dependency>
<groupId>org.apache.activemq</groupId>
<artifactId>activemq-all</artifactId>
<version>5.15.9</version>
</dependency>
<!--ActiveMQ 內嵌啓動時,json 數據轉換需要依賴 jackjson-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.9</version>
</dependency>
</dependencies>
</project>
3、pom.xml 文件內容如上所示,BrokerService 啓動 ActiveMQ 服務如下:
import org.apache.activemq.broker.BrokerService;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 嵌入式 ActiveMQ 啓動
*/
public class EmbedActiveMQStart {
private static Logger logger = LoggerFactory.getLogger(EmbedActiveMQStart.class);
/**
* 嵌入式 ActiveMQ 啓動方式1
* java.lang.NoClassDefFoundError: com/fasterxml/jackson/databind/ObjectMapper
*/
public static void main(String[] args) {
try {
/**設置 ActiveMQ 消息服務器用於被客戶端連接的 url 地址
* 實際開發中,地址應該在配置文件中可配置,不要寫死
*/
String serviceURL = "tcp://localhost:61616";
/**BrokerService 表示 ActiveMQ 服務,每一個 BrokerService 表示一個消息服務器實例
* 如果想啓動多個,只需要 start 多個不同端口的 BrokerService 即可*/
BrokerService brokerService = new BrokerService();
brokerService.setUseJmx(true);//設置是否應將代理的服務公開到jmx中。默認是 true
brokerService.addConnector(serviceURL);//爲指定地址添加新的傳輸連接器
/**啓動 ActiveMQ 服務,此時客戶端便可以使用提供的地址進行連接,然後發送消息過來,或者從這裏消費消息。
* 注意:這裏內嵌啓動後,默認是沒有提供 8161 端口的 web 管理界面的,照樣能做消息中間件使用
* */
brokerService.start();
logger.info(" ActiveMQ Broker Service Start Finish...");
} catch (Exception e) {
logger.error("啓動 ActiveMQ BrokerService 失敗,cause by:" + e.getMessage(), e);
}
}
}
4、應用啓動之後,可以查看端口檢查 ActiveMQ 服務是否已經運行,也可以通過發送與接收消息來檢驗,生產者與消費者代碼如下:
import org.apache.activemq.ActiveMQConnectionFactory;
import javax.jms.*;
import java.util.UUID;
/**
* 消息發送者
*/
@SuppressWarnings("all")
public class Producer {
public static void main(String[] args) {
Connection connection = null;
Session session = null;
try {
String brokerURL = "tcp://127.0.0.1:61616";//ActiveMQ 中間件連接地址
/**
* 創建 javax.jms.ConnectionFactory 連接工廠
* org.apache.activemq.ActiveMQConnectionFactory 中默認設置了大量的參數,還有幾個重載的構造器可以選擇
*/
ConnectionFactory mqConnectionFactory = new ActiveMQConnectionFactory(brokerURL);
//如果 ActiveMQ 連不上,則拋異常:java.net.ConnectException: Connection refused: connect
connection = mqConnectionFactory.createConnection();//通過連接工廠獲取連接 javax.jms.Connection
connection.start();//啓動連接,同理還有 stop、close
/**Session createSession(boolean transacted, int acknowledgeMode) 創建會話*/
session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
/**
* createQueue(String queueName):創建消息隊列,指定隊列名稱,消費者可以根據隊列名稱獲取消息
* Destination 目的地,重點,interface Queue extends Destination
*/
Destination destination = session.createQueue("queue-app");
//createProducer(Destination destination):根據目的地創建消息生產者
MessageProducer producer = session.createProducer(destination);
int massageTotal = 5;
for (int i = 0; i < massageTotal; i++) {
//創建一個文本消息
TextMessage textMessage = session.createTextMessage("密鑰:" + UUID.randomUUID());
producer.send(textMessage);//生產者發送消息
session.commit();//會話提交
}
} catch (JMSException e) {
e.printStackTrace();
} finally {
try {
if (session != null) {
session.close();//關閉會話
}
if (connection != null) {
connection.close();//關閉連接
}
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}
import org.apache.activemq.ActiveMQConnectionFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.jms.*;
/**
* 消息消費者
*/
@SuppressWarnings("all")
public class Consumer {
private static Logger logger = LoggerFactory.getLogger(EmbedActiveMQStart.class);
public static void main(String[] args) {
Connection connection = null;
Session session = null;
try {
String brokerURL = "tcp://127.0.0.1:61616";//ActiveMQ 中間件連接地址
/**
* 創建 javax.jms.ConnectionFactory 連接工廠
* org.apache.activemq.ActiveMQConnectionFactory 中默認設置了大量的參數,還有幾個重載的構造器可以選擇
*/
ConnectionFactory mqConnectionFactory = new ActiveMQConnectionFactory(brokerURL);
//如果 ActiveMQ 連不上,則拋異常:java.net.ConnectException: Connection refused: connect
connection = mqConnectionFactory.createConnection();//通過連接工廠獲取連接 javax.jms.Connection
connection.start();//啓動連接,同理還有 stop、close
/**Session createSession(boolean transacted, int acknowledgeMode) 創建會話*/
session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
/**
* createQueue(String queueName):創建消息隊列,指定隊列名稱,消費者可以根據隊列名稱獲取消息
* Destination 目的地,重點,interface Queue extends Destination
*/
Destination destination = session.createQueue("queue-app");
logger.info("消費者客戶啓動完畢,開始接收消息...");
//createProducer(Destination destination):根據目的地創建消息消費者
MessageConsumer consumer = session.createConsumer(destination);
Message message = consumer.receive();
while (message != null) {
if (message instanceof TextMessage) {
TextMessage textMessage = (TextMessage) message;
System.out.println(textMessage.getText());
}
session.commit();
message = consumer.receive();
}
} catch (JMSException e) {
e.printStackTrace();
} finally {
try {
if (session != null) {
session.close();//關閉會話
}
if (connection != null) {
connection.close();//關閉連接
}
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}
MessageListener 監聽消息
1、consumer.receive() 是一個線程阻塞的方法,更加推薦使用異步的消息監聽器 MessageListener ,使用非常簡單,只需要consumer.receive() 改爲 consumer.setMessageListener() 即可。
import org.apache.activemq.ActiveMQConnectionFactory;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import javax.jms.*;
import java.io.IOException;
/**
* 消息消費者 · 使用非阻塞的監聽器方式
*/
@SuppressWarnings("all")
public class ListenerConsumer {
private static Logger logger = LoggerFactory.getLogger(EmbedActiveMQStart.class);
public static void main(String[] args) {
Connection connection = null;
Session session = null;
try {
String brokerURL = "tcp://127.0.0.1:61616";//ActiveMQ 中間件連接地址
/**
* 創建 javax.jms.ConnectionFactory 連接工廠
* org.apache.activemq.ActiveMQConnectionFactory 中默認設置了大量的參數,還有幾個重載的構造器可以選擇
*/
ConnectionFactory mqConnectionFactory = new ActiveMQConnectionFactory(brokerURL);
//如果 ActiveMQ 連不上,則拋異常:java.net.ConnectException: Connection refused: connect
connection = mqConnectionFactory.createConnection();//通過連接工廠獲取連接 javax.jms.Connection
connection.start();//啓動連接,同理還有 stop、close
/**Session createSession(boolean transacted, int acknowledgeMode) 創建會話*/
session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
/**
* createQueue(String queueName):創建消息隊列,指定隊列名稱,消費者可以根據隊列名稱獲取消息
* Destination 目的地,重點,interface Queue extends Destination
* 無論是消息隊列還是訂閱主題 (Topic),MessageListener 寫法都是一樣的。
*/
Destination destination = session.createQueue("queue-app");
MessageConsumer consumer = session.createConsumer(destination);//創建消息消費者
/** consumer.receive() 是一個線程阻塞的方法,更加推薦使用異步的消息監聽器
* 爲了方便直接使用了匿名內部類,正式開發建議單獨作爲一個類
* */
logger.info("開始監聽消息...");
final Session finalSession = session;
consumer.setMessageListener(new MessageListener() {
public void onMessage(Message message) {
try {
if (message instanceof TextMessage) {
TextMessage textMessage = (TextMessage) message;
logger.info("接收到消息--> " + textMessage.getText());
}
finalSession.commit();//消息確認
} catch (JMSException e) {
e.printStackTrace();
}
}
});
/**
* 特別提醒:正因爲 consumer.setMessageListener 是線程非阻塞的,所以如果不加處理,則 mian 會直接運行結束
* 這裏故意使用 System.in.read() 讓 mian 線程阻塞停下來,實際開發中如果是 web 應用,或者是其它的不會馬上結束
* 的 Java SE 應用,則是不需要這樣處理的
*/
System.in.read();//控制檯隨便輸入字符,回車後,程序運行結束
} catch (JMSException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
} finally {
try {
if (session != null) {
session.close();//關閉會話
}
if (connection != null) {
connection.close();//關閉連接
}
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}