ActiveMQ---详解与基础应用

ActiveMQ的安装请参照：

ActiveMQ的安装与启动：http://www.cnblogs.com/donsenChen/p/8656563.html

学习总结：

一、首先activeMQ是一个MOM，而MOM是面向消息的中间件（Message-oriented middleware），指的是利用高效可靠的消息传递机制进行平台无关的数据交流，并基于数据通信来进行分布式系统的继承。用于分布式应用或系统中的异步、松耦合、可靠、可扩展的安全童心的一类软件。MOM的总体思想：作为消息发送器和消息接收器之间的消息中介，提供一个全新水平的松耦合。具体来说就是一个实现JMS规范的系统间远程通信的消息代理。而JMS（Java Message Service）叫做Java消息服务，是Java平台上有关面向MOM的技术规范，旨在通过提供标准的生产、发送、接受和处理消息的API简化企业应用的开发，类似于JDBC和关系型数据库通信方式的抽象。

二、关键词：

• Provider：纯 Java 语言编写的 JMS 接口实现（比如 ActiveMQ 就是）
• Domains：消息传递方式，包括点对点（P2P）、发布/订阅（Pub/Sub）两种
• Connection factory：客户端使用连接工厂来创建与 JMS provider 的连接
• Destination：消息被寻址、发送以及接收的对象

三、大致流程：

• 获取连接工厂
• 使用连接工厂创建连接
• 启动连接
• 从连接创建会话
• 获取 Destination
• 创建 Producer，或
  1. 创建 Producer
  2. 创建 message
• 创建 Consumer，或发送或接收message发送或接收 message
  1. 创建 Consumer
  2. 注册消息监听器（可选）
• 发送或接收 message
• 关闭资源（connection, session, producer, consumer 等)

四、ActiveMQ的存储：

ActiveMQ 在 queue 中存储 Message 时，采用先进先出顺序（FIFO）存储。同一时间一个消息被分派给单个消费者，且只有当 Message 被消费并确认时，它才能从存储中删除。

对于持久化订阅者来说，每个消费者获得 Message 的副本。为了节省存储空间，Provider 仅存储消息的一个副本。持久化订阅者维护了指向下一个 Message 的指针，并将其副本分派给消费者。以这种方式实现消息存储，因为每个持久化订阅者可能以不同的速率消费 Message，或者它们可能不是全部同时运行。此外，因每个 Message 可能存在多个消费者，所以在它被成功地传递给所有持久化订阅者之前，不能从存储中删除。

消息类型	是否持久化	是否有Durable订阅者	消费者延迟启动时，消息是否保留	Broker重启时，消息是否保留
Queue	N	-	Y	N
Queue	Y	-	Y	Y
Topic	N	N	N	N
Topic	N	Y	Y	N
Topic	Y	N	N	N
Topic	Y	Y	Y	Y

五、ActiveMQ常用存储方式：

1.KahaDB

ActiveMQ 5.3 版本起的默认存储方式。KahaDB存储是一个基于文件的快速存储消息，设计目标是易于使用且尽可能快。它使用基于文件的消息数据库意味着没有第三方数据库的先决条件。

要启用 KahaDB 存储，需要在 activemq.xml 中进行以下配置：

<broker brokerName="broker" persistent="true" useShutdownHook="false">
        <persistenceAdapter>
                <kahaDB directory="${activemq.data}/kahadb" journalMaxFileLength="16mb"/>
        </persistenceAdapter>
</broker>

2.AMQ

与 KahaDB 存储一样，AMQ存储使用户能够快速启动和运行，因为它不依赖于第三方数据库。AMQ 消息存储库是可靠持久性和高性能索引的事务日志组合，当消息吞吐量是应用程序的主要需求时，该存储是最佳选择。但因为它为每个索引使用两个分开的文件，并且每个 Destination 都有一个索引，所以当你打算在代理中使用数千个队列的时候，不应该使用它。

<persistenceAdapter>
        <amqPersistenceAdapter
                directory="${activemq.data}/kahadb"
                syncOnWrite="true"
                indexPageSize="16kb"
                indexMaxBinSize="100"
                maxFileLength="10mb" />
</persistenceAdapter>

3.JDBC

选择关系型数据库，通常的原因是企业已经具备了管理关系型数据的专长，但是它在性能上绝对不优于上述消息存储实现。事实是，许多企业使用关系数据库作为存储，是因为他们更愿意充分利用这些数据库资源。

<beans>
        <broker brokerName="test-broker" persistent="true" xmlns="http://activemq.apache.org/schema/core">
                <persistenceAdapter>
                        <jdbcPersistenceAdapter dataSource="#mysql-ds"/>
                </persistenceAdapter>
        </broker>
        <bean id="mysql-ds" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
                <property name="driverClassName" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost/activemq?relaxAutoCommit=true"/>
                <property name="username" value="activemq"/>
                <property name="password" value="activemq"/>
                <property name="maxActive" value="200"/>
                <property name="poolPreparedStatements" value="true"/>
        </bean>
</beans>

4.内存存储

内存消息存储器将所有持久消息保存在内存中。在仅存储有限数量 Message 的情况下，内存消息存储会很有用，因为 Message 通常会被快速消耗。在 activema.xml 中将 broker 元素上的 persistent 属性设置为 false 即可。

<broker brokerName="test-broker" persistent="false" xmlns="http://activemq.apache.org/schema/core">
        <transportConnectors>
                <transportConnector uri="tcp://localhost:61635"/>
        </transportConnectors>
</broker>

六、ActiveMQ 的部署模式

1.单例模式：略过

2.无共享主从模式：

这是最简单的 Provider 高可用性的方案，主从节点分别存储 Message。从节点需要配置为连接到主节点，并且需要特殊配置其状态。

所有消息命令（消息，确认，订阅，事务等）都从主节点复制到从节点，这种复制发生在主节点对其接收的任何命令生效之前。并且，当主节点收到持久消息，会等待从节点完成消息的处理（通常是持久化到存储），然后再自己完成消息的处理（如持久化到存储）后，再返回对 Producer 的回执。

从节点不启动任何传输，也不能接受任何客户端或网络连接，除非主节点失效。当主节点失效后，从节点自动成为主节点，并且开启传输并接受连接。这是，使用 failover 传输的客户端就会连接到该新主节点。

Broker 连接配置如下：

failover://(tcp://masterhost:61616,tcp://slavehost:61616)?randomize=false

但是，这种部署模式有一些限制，

• 主节点只会在从节点连接到主节点时复制其活动状态，因此当从节点没有连接上主节点之前，任何主节点处理的 Message 或者消息确认都会在主节点失效后丢失。不过你可以通过在主节点设置 waitForSlave 来避免，这样就强制主节点在没有任何一个从节点连接上的情况下接受连接。
• 就是主节点只能有一个从节点，并且从节点不允许再有其他从节点。
• 把正在运行的单例配置成无共享主从，或者配置新的从节点时，你都要停止当前服务，修改配置后再重启才能生效。

在可以接受一些故障停机时间的情况下，可以使用该模式。

从节点配置：

<services>
        <masterConnector remoteURI="tcp://remotehost:62001" userName="Rob" password="Davies"/>
</services>

此外，可以配置 shutdownOnMasterFailure 项，表示主节点失效后安全关闭，保证没有消息丢失，允许管理员维护一个新的从节点。

3.共享存储主从模式

允许多个代理共享存储，但任意时刻只有一个是活动的。这种情况下，当主节点失效时，无需人工干预来维护应用的完整性。另外一个好处就是没有从节点数的限制。

有两种细分模式：

（1）基于数据库

它会获取一个表上的排它锁，以确保没有其他 ActiveMQ 代理可以同时访问数据库。其他未获得锁的代理则处于轮询状态，就会被当做是从节点，不会开启传输也不会接受连接。

（2）基于文件系统

需要获取分布式共享文件锁，linux 系统下推荐用 GFS2。

===========================================================================================================================
简单应用：

创建一个activeMQ的生产者JMSProducer类：

具体可以看代码中的注释，其中ObjectMessage为对象消息，TextMessage为文本消息。

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;

import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MessageProducer;
import javax.jms.ObjectMessage;
import javax.jms.Session;

import org.apache.activemq.ActiveMQConnection;
import org.apache.activemq.ActiveMQConnectionFactory;

/**
 * @title JMSProducer.java
 * @author DonsenChen
 * @Date 2018年3月27日 下午3:12:00
 * @Description
 */
public class JMSProducer {

    // 默认连接用户名
    private static final String USERNAME = ActiveMQConnection.DEFAULT_USER;
    // 默认连接密码
    private static final String PASSWORD = ActiveMQConnection.DEFAULT_PASSWORD;
    // 默认连接地址
    private static final String BROKEURL = ActiveMQConnection.DEFAULT_BROKER_URL;
    // 发送的消息数量
    private static final int SENDNUM = 10;

    public static void main(String[] args) {
        System.out.println(BROKEURL);
        // 连接工厂
        ConnectionFactory connectionFactory;
        // 连接
        Connection connection = null;
        // 会话 接受或者发送消息的线程
        Session session;
        // 消息的目的地
        Destination destination;
        // 消息生产者
        MessageProducer messageProducer;
        // 实例化连接工厂
        connectionFactory = new ActiveMQConnectionFactory(JMSProducer.USERNAME, JMSProducer.PASSWORD,
                JMSProducer.BROKEURL);
        try {
            // 通过连接工厂获取连接
            connection = connectionFactory.createConnection();
            // 启动连接
            connection.start();
            // 创建session
            session = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);
            // 创建一个名称为HelloWorld的消息队列
            destination = session.createQueue("HelloWorld");
            // 创建消息生产者
            messageProducer = session.createProducer(destination);
            // 发送消息
            sendMessage(session, messageProducer);
            session.commit();
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (connection != null) {
                try {
                    connection.close();
                } catch (JMSException e) {
                    e.printStackTrace();
                }
            }
        }
    }

    /**
     * 发送消息
     * 
     * @param session
     * @param messageProducer
     *            消息生产者
     * @throws Exception
     */
    public static void sendMessage(Session session, MessageProducer messageProducer) throws Exception {
        // for (int i = 0; i < JMSProducer.SENDNUM; i++) {
        // // 创建一条文本消息
        // TextMessage message = session.createTextMessage("ActiveMQ 发送消息" + i);
        // System.out.println("发送消息：Activemq 发送消息" + i);
        // // 通过消息生产者发出消息
        // messageProducer.send(message);
        // }
        BillInfo1007 b1007 = new BillInfo1007();
        b1007.setNo("test001");
        String fileName = "C:\Users\DELL\Desktop\123.txt";
        b1007.setImgFrntContent(readStringByByte(fileName));
        ObjectMessage message = session.createObjectMessage(b1007);
        messageProducer.send(message);
    }

    // 从文件中读取字符串
    private static String readStringByByte(String fileName) {
        String str = "";
        File file = new File(fileName);
        if (!file.exists() && !file.isFile()) {
            System.out.println("Can't Find " + fileName);
        } else {
            try {
                FileInputStream in = new FileInputStream(file);
                // size 为字串的长度 ，这里一次性读完
                int size = in.available();
                byte[] buffer = new byte[size];
                in.read(buffer);
                in.close();
                str = new String(buffer, "GBK");
            } catch (IOException e) {
                return null;
                // e.printStackTrace();
            }
        }
        return str;
    }

}

再创建一个activeMQ的消费者JMSConsumer类：

import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MessageConsumer;
import javax.jms.ObjectMessage;
import javax.jms.Session;

import org.apache.activemq.ActiveMQConnection;
import org.apache.activemq.ActiveMQConnectionFactory;

/**
 * @title JMSConsumer.java
 * @author DonsenChen
 * @Date 2018年3月27日 下午3:13:43
 * @Description
 */
public class JMSConsumer {
    private static final String USERNAME = ActiveMQConnection.DEFAULT_USER;// 默认连接用户名
    private static final String PASSWORD = ActiveMQConnection.DEFAULT_PASSWORD;// 默认连接密码
    private static final String BROKEURL = ActiveMQConnection.DEFAULT_BROKER_URL;// 默认连接地址

    public static void main(String[] args) {
        ConnectionFactory connectionFactory;// 连接工厂
        Connection connection = null;// 连接
        Session session;// 会话 接受或者发送消息的线程
        Destination destination;// 消息的目的地
        MessageConsumer messageConsumer;// 消息的消费者
        // 实例化连接工厂
        connectionFactory = new ActiveMQConnectionFactory(JMSConsumer.USERNAME, JMSConsumer.PASSWORD,
                JMSConsumer.BROKEURL);
        try {
            // 通过连接工厂获取连接
            connection = connectionFactory.createConnection();
            // 启动连接
            connection.start();
            // 创建session
            session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
            // 创建一个连接HelloWorld的消息队列
            destination = session.createQueue("HelloWorld");
            // 创建消息消费者
            messageConsumer = session.createConsumer(destination);
            while (true) {
                ObjectMessage objMessage = (ObjectMessage) messageConsumer.receive(100000);
                if (null != objMessage) {
                    BillInfo1007 b1007 = (BillInfo1007) objMessage.getObject();
                    System.out.println(b1007.getNo());
                    System.out.println(b1007.getImgFrntContent());
                } else {
                    break;
                }
            }
        } catch (JMSException e) {
            e.printStackTrace();
        }

    }
}

在浏览器中输入：http://localhost:8161/admin/，Run As Java Application即可完成生产个和消费的动作，可以在控制台上查看打印的相关信息，也可以在ActiveMQ服务器上，查看Queues内容的具体信息。

***********************

心得之谈：欢迎指正，一起学习。

***********************