ActiveMQ开发与简介

1.概述与介绍

ActiveMQ是Apache出品，最流行的、功能强大的即时通讯和集成模式的开源服务器。ActiveMQ是一个完全支持JMS1.1和J2EE1.4规范的JMSProvider实现。提供客户端支持跨语言和协议，带有易于在充分支持JMS1.1和1.4使用J2EE企业集成模式和许多先进的功能。

2.特性

（1）多种语言和协议编写客户端（语言：Java、C、C++、C#、Ruby、Perl、Python、PHP。应用协议：OpenWire、StompREST、WSNotification、XMPP、AMQP）。

（2）完全支持JMS1.1和J2EE1.4规范（持久化，XA消息，事务）。

（3）对Spring的支持。ActiveMQ可以很容易内嵌到使用Spring的系统里面去，而且也支持Spring2.0的特性。

（4）通过了常见J2EE服务器（如Geronimo、JBoss4、GlassFish、WebLogic）的测试，其中通过JCA1.5 resource adaptors的配置，可以让ActiveMQ自动部署到任何兼容J2EE1.4 的商业服务器上。

（5）支持多种传送协议：in-VM、TCP、SSL、NIO、UDP、JGroups、JXTA。

（6）支持通过JDBC和journal提供高速的消息持久化。

（7）从设计上保证了高性能的集群，客户端-服务器，点对点。

（8）支持Ajax。

（9）支持与Axis的整合。

（10）可以很容易的调用内嵌JMSprovider，进行测试。

3. 安装部署

3.1 开发环境

   System：Windows

JDK：1.6+

IDE：VS2010 C#，Eclipse

apache ActiveMQ5.9.0

3.2 安装与启动

（1）下载ActiveMQ：地址http://activemq.apache.org/download.html

（2）配置JAVA环境变量（若安装的是自动配置的JDK版本，则无需配置）：

JAVA_HOME=D:\Program Files\Java\jdk1.7.0

CLASSPATH=.

PATH=%JAVA_HOME%\bin;

（3）解压压缩文件（如：apache-activemq-5.9.0）到D盘，解压后的目录如下图所示：

+bin (windows下面的bat和unix/linux下面的sh) 启动ActiveMQ的启动服务就在这里；

+conf (activeMQ配置目录，包含最基本的activeMQ配置文件）；

+data（默认是空的）；

+docs（index,replease版本里面没有文档）；

+example（几个例子）；

+lib（activeMQ使用到的lib）；

+webapps（系统管理员控制台代码）；

+webapps-demo（系统示例代码）；

-activemq-all-5.9.0.jar(ActiveMQ的binary)；

-user-guide.html（部署指引）；

-LICENSE.txt（许可条款）；

-NOTICE.txt（广告事项）；

-README.txt（用前必读）；

（4）启动

进入bin目录，使用activemq.bat双击启动ActiveMQ（Windows用户可以选择系统位数，如果是Linux的话，就用命令行的发送去启动），如果启动顺利，会出现类似下图的信息：

启动成功就可以访问管理员界面，如下图：http://localhost:8161/admin，默认用户名和密码admin/admin。可以在conf/jetty-realm.properties中修改用户名和密码。

在上图的导航菜单中，Queues是队列方式消息。Topics是主题方式消息。Subscribers是消息订阅监控查询。Connections可以查看链接数，分别可以查看xmpp、ssl、stomp、openwire、ws和网络链接。Network是网络链接数监控。Send可以发送消息数据。

3.3 测试

（1）添加环境变量

添加ACTIVEMQ_HOME，指向安装目录：D:\apache-activemq-5.9.0\

Path加入%ACTIVEMQ_HOME%\bin\;

CLASSPATH加入%ACTIVEMQ_HOME%\conf\;

（2）运行ActiveMQ

在cmd下执行：activemq。若正常启动，会出现类似下图的信息：

（3）测试安装是否成功：

ActiveMQ的默认端口是61616，另外开一个console，用netstat命令搜索61616端口：netstat -an|find "61616"，如下图所示。

（4）监控ActiveMQ：

可以通过Web界面来监控ActiveMQ，用浏览器访问：http://localhost:8161/admin。

如果ActiveMQ的版本是5.9，则需要输入默认账号admin/admin,该账号可以在conf/jetty-real.properties中配置。

（5）停止ActiveMQ：

直接到运行ActiveMQ的console中执行CTRL+C键。

4.消息实例

4.1 ActiveMQ架构

ActiveMQ的架构如下图所示：

4.2 消息模式

      ActiveMQ消息有3种形式，如下图所示：

（1）点对点方式（point-to-point，PTP）

点对点的消息发送方式主要建立在Message Queue, Sender, Receiver上，Message Queue存储消息，Sender发送消息，Receiver接收消息。具体点就是Sender Client发送Message Queue ，而Receiver Client从Queue中接收消息和“发送消息已接受”到Queue，确认消息接收。消息发送客户端与接收客户端没有时间上的依赖，发送客户端可以在任何时刻发送信息到Queue，而不需要知道接收客户端是不是在运行。

（2）发布/订阅方式（Publish/Subscribe Messaging）

发布/订阅方式用于多接收客户端的方式，通过消息主题（Topic）实现。消息由一个JMS客户机（Publisher）发布到服务器上的一个主题（Topic），可有多个订阅者（Subscriber）去访问该消息。消息将一直维持在主题中，直到这个主题的所有订阅者都取走了该消息的一个副本。消息也包括了一个参数，用于定义该消息的耐久性（它能够在服务器上等待订阅者多长时间）。作为Subscriber ，在接收消息时有两种方法，Destination的Receive方法，和实现Message Listener接口的onMessage 方法。

发送消息的基本步骤：

①创建连接使用的工厂类JMS ConnectionFactory；

②使用管理对象JMS ConnectionFactory建立连接Connection，并启动；

③使用连接Connection建立会话Session；

④使用会话Session和管理对象Destination创建消息生产者MessageSender；

⑤使用消息生产者MessageSender发送消息。

消息接收者从JMS接受消息的步骤：

①创建连接使用的工厂类JMS ConnectionFactory；

②使用管理对象JMS ConnectionFactory建立连接Connection，并启动；

③使用连接Connection建立会话Session；

④使用会话Session和管理对象Destination创建消息接收者MessageReceiver；

⑤使用消息接收者MessageReceiver接受消息，需要用setMessageListener将MessageListener接口绑定到MessageReceiver消息接收者必须实现了MessageListener接口，需要定义onMessage事件方法。

5.开发实例

5.1 准备工作

     建立发送和接收两部分，来实现MQ。首先在http://activemq.apache.org/nms/download.html下载Apache.NMS API Releases和Apache.NMS.ActiveMQ Releases两个动态链接库文件，进入后如下图所示：

    

通过页面内容可以看到，Apache.NMS API Releases和Apache.NMS.ActiveMQ Releases版本存在对应关系，在Apache.NMS.ActiveMQ Releases的右侧可以看到NMS API REV一栏表示的Apache.NMS API Releases的版本号，如Apache.NMS.ActiveMQ Releases的V1.6.2、V1.6.1和V1.6.0对应的Apache.NMS API Releases版本是V1.6.0，如果版本不一致，在VS编译过程中会出现版本不兼容的问题。

选择好版本进入后，界面如下图所示：

如果想研究源代码可以下载src文件，如果只想获得所调用的DLL文件，只需下载bin文件即可。下载完成分别解压，可以看到对应不同的.NET版本有不同的DLL文件，复制所需要的DLL文件到新建工程下的debug文件夹下，在程序中进行引用。

5.2 实例

A. C#版：该实例是基于发布/订阅方式的，由发布者程序producer和订阅者程序consumer（该订阅者程序可以有多个）分别实现消息的发送和消息的监听接受。

（1）发布者程序

发布者程序主要实现ActiveMQ的连接和消息的发送，程序运行界面如下图所示。

在发布者程序的实现过程中，contentMQ函数实现activeMQ的连接和消息的发送。其中的obtain函数连接数据库获取数据库数据。send的函数实现消息的发送。在发布者程序中调用timer控件，实现每隔一段时间读取数据库数据并发送。

 public void contentMQ(int i)
   {
     try
       {
         //开始连接，用户名密码
         using(connection=     factory.CreateConnection(textBox_UserName.Text,  textBox_PassWord.Text))  

        //如果要持久“订阅”，则需要设置ClientId，这样程序运行当中被停止，   恢复运行时，能收到没接收到的消息，连接的客户端名称标识
        connection.ClientId = textBox_demolistener.Text;
        connection.Start();

       //创建Session
        using (session = connection.CreateSession())
        {
          //发布/订阅模式，适合一对多的情况; //创建消息制作者
            destination = SessionUtil.GetDestination(session, "topic://" + textBox_topicname.Text);
          //给topic创建一个producer; // 创建消息制作者
            producer = session.CreateProducer(destination);
            //设置持久化模式MsgDeliveryMode.Persistent //ActiveMQ服务器停止工作后，消息不再保留MsgDeliveryMode.NonPersistent ;
            producer.DeliveryMode = MsgDeliveryMode.Persistent;
            string source = "orcl";
            string user = "sunzhongwei1";
            string password = "";
            string sql = "";
            sql = "select * from testdata t where t.id =" + i;
            string str;
            str = obtain(source, user, password, sql);
            send(str);
                    }
                }
            }
            catch (Exception e1)
            {
              throw e1;
            }
            finally
            {
              if (session != null)
                  session.Close();
              if (connection != null)
                  connection.Close();
            }
        }

 public String obtain(string source,string user,string password ,string sql)
 {
    string str=null;
    string ConnectionString = "Data Source=" + source + ";user=" + user + ";password=" + password + ";";//写连接串
    OracleConnection conn = new OracleConnection(ConnectionString);//创建一个新连接
    try
    {
      conn.Open();
      OracleCommand cmd = conn.CreateCommand();
      cmd.CommandText = sql;//在这儿写sql语句
      //创建一个OracleDateReader对象
      OracleDataReader odr = cmd.ExecuteReader();
      //读取数据，如果odr.Read()返回为false的话，就说明到记录集的尾部
      while (odr.Read())
             {
         //输出字段2，这个数是字段索引
              str=odr.GetOracleString().ToString();               }
              odr.Close();
             }
             catch (Exception ee)
             {
                 MessageBox.Show(ee.Message); //如果有错误，输出错误信息
             }
             finally
             {
                 conn.Close(); //关闭连接
             }
             return str;
         }

 public void send(string str)
         {
          request = session.CreateTextMessage(DateTime.Now.ToLocalTime() +"    "+str);
             producer.Send(request);
         }

（2）订阅者程序

订阅者程序主要实现ActiveMQ的初始化、ActiveMQ的连接和启动监听。其程序运行主要界面图如下图所示。

在订阅者程序中，先调用init函数，实现与activeMQ的初始化和启动监听，点击connect按钮即可实现activeMQ的连接和启动监听。

 private void init()
  {
    //创建连接工厂
    factory = new ConnectionFactory("tcp://" + textBox_URL.Text);
    //开始连接.用户名密码
    connection = factory.CreateConnection(textBox_UserName.Text, textBox_PassWord.Text);
    //如果你要持久“订阅”，则需要设置ClientId，这样程序运行当中被停止，恢复运行时，能拿到没接收到的消息！
        connection.ClientId = textBox_demolistener.Text;
    // 启动连接
    connection.Start();
    // 创建一个session会话
   session = connection.CreateSession();
   // 创建一个消息队列
   destination = SessionUtil.GetDestination(session, "topic://" + textBox_topicname.Text);
  //Create the Consumer
  consumer = session.CreateDurableConsumer(new Apache.NMS.ActiveMQ.Commands.ActiveMQTopic(textBox_topicname.Text), textBox_demolistener.Text, null, false);
 // 接收数据的时间（等待）100 ms
 consumer.Listener += new MessageListener(consumer_Listener);
 MessageBox.Show("初始化成功！");
    }
     监听程序如下，把监听到的消息存入一位数组中
  static void consumer_Listener(IMessage message)
  {
      try
      {
        str = "";
        ITextMessage msg = (ITextMessage)message;
        str = "Receive: " + msg.Text;
        s[j++] = str;
      }
      catch (System.Exception e)
      {
        Console.WriteLine(e.Message);
      }
  }

当点击Receive按钮时，可以获取监听中的疑问数组信息并进行显示。

B. Java版：读取表Action_Type中atid，description两项内容。

MQClient：MQ客户端工程。

MQClient依赖的包如下：

activemq-broker-5.9.0， activemq-client-5.9.0，

geronimo-j2ee-management_1.1_spec-1.0.1， geronimo-jms_1.1_spec-1.1.1，

slf4j-api-1.7.7， slf4j-nop-1.7.7。

① MQRev类代码：

 package ouc;

 import javax.jms.Destination;
 import javax.jms.JMSException;
 import javax.jms.Message;
 import javax.jms.MessageConsumer;
 import javax.jms.MessageListener;
 import javax.jms.Session;
 import javax.jms.TextMessage;

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

 public class MQRev implements MessageListener{
        public  void receiveMsg()
        {
         ActiveMQConnectionFactory connectionFactory;
         ActiveMQConnection connection;
         Session session;
         Destination destination;
         MessageConsumer messageConsumer;
         connectionFactory=new ActiveMQConnectionFactory(ActiveMQConnection.DEFAULT_USER, ActiveMQConnection.DEFAULT_PASSWORD, "tcp://localhost:61618");
         try {
             connection=(ActiveMQConnection) connectionFactory.createConnection();
             connection.start();
             session=connection.createSession(false, ActiveMQSession.AUTO_ACKNOWLEDGE);
             destination=session.createQueue("ouc");
             messageConsumer=session.createConsumer(destination);
             TextMessage textMessage=(TextMessage) messageConsumer.receiveNoWait();
             messageConsumer.setMessageListener(this);
         }
         catch (Exception e) {
             e.printStackTrace();
         }
     }
     public void onMessage(Message arg0) {
         if(arg0 instanceof TextMessage)
         {
             TextMessage txtMessage=(TextMessage) arg0;
             try {
                 String str=txtMessage.getText();
                 System.out.println(str);
             }
             catch (JMSException e) {
                 e.printStackTrace();
             }
         }
     }
 }

②Receive主类代码：

 package ouc;

 public class Receive {
     public static void main(String[] args) {
         MQRev mqRevMsg=new MQRev();
         mqRevMsg.receiveMsg();
     }
 }

MQServer：MQ服务端工程。

MQServer依赖的包如下：

activemq-broker-5.9.0， activemq-client-5.9.0，

geronimo-j2ee-management_1.1_spec-1.0.1， geronimo-jms_1.1_spec-1.1.1，

slf4j-api-1.7.7， slf4j-nop-1.7.7，ojdbc6。

TrainMQServer类代码:

 package training;

 import java.sql.Connection;
 import java.sql.DriverManager;
 import java.sql.ResultSet;
 import java.sql.SQLException;
 import java.sql.Statement;

 import javax.jms.ConnectionFactory;
 import javax.jms.Destination;
 import javax.jms.JMSException;
 import javax.jms.MessageProducer;
 import javax.jms.Session;
 //import javax.jms.TextMessage;

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

 public class TrainMQServer {
     public static ConnectionFactory connectionFactory;
     public static ActiveMQConnection connection=null;
     public static ActiveMQSession session;
     public static Destination destination;
     public static MessageProducer producer;

     public static void main(String[] args){
          initMQ();
          try {
                 Class.forName("oracle.jdbc.driver.OracleDriver");
             }
          catch (ClassNotFoundException e) {
                 e.printStackTrace();
             }
              Connection conn=null;
             Statement statement=null;
             ResultSet resultSet=null;
             String url;
             String user;
             String password;
             url="jdbc:oracle:thin:@192.168.1.1:1521:orcl";
             user="ocean";
             password="ouc,123";
             try {
                 conn=DriverManager.getConnection(url, user, password);
                 statement=conn.createStatement();
                 resultSet=statement.executeQuery("select atid,description from Action_Type");
                 while(resultSet.next())
                 {
                     System.out.println("Atid="+resultSet.getInt("atid")+"  Description="+resultSet.getString("Description"));
                     try {
                         producer.send(session.createTextMessage("Atid="+resultSet.getInt("atid")+"+    Description="+resultSet.getString("Description")));
                     }
                     catch (JMSException e) {
                         e.printStackTrace();
                     }
                 }
             }
             catch (SQLException e) {
                 e.printStackTrace();
             }
             finally
             {
                 try{
                     resultSet.close();
                 }
                 catch(SQLException e1){
                     e1.printStackTrace();
                 }
                 try{
                     statement.close();
                 }
                 catch(SQLException e2){
                     e2.printStackTrace();
                 }
                 try{
                     conn.close();
                 }
                 catch(SQLException e3){
                     e3.printStackTrace();
                 }
             }
     }
     public static void initMQ(){
         connectionFactory=new ActiveMQConnectionFactory(ActiveMQConnection.DEFAULT_USER, ActiveMQConnection.DEFAULT_PASSWORD,"tcp://localhost:61618");
         try{
             connection=(ActiveMQConnection) connectionFactory.createConnection();
             connection.start();
             session=(ActiveMQSession) connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
             destination=session.createQueue("ouc");
             producer=session.createProducer(destination);
             }
         catch (Exception e)
         {
             e.printStackTrace();
         }
     }
 }

6.可能遇到的问题

6.1 无法正常启动ActiveMQ

在使用activemq.bat双击启动ActiveMQ时，可能会出现如下图所示的界面，提示JVM exited while loading the application，启动一段时间后ActiveMQ自动关闭。

这可能是由于安装了自动配置的JDK，然后又进行手动配置JAVA环境变量造成的，将手动配置的JAVA环境变量清除即可。

6.2 引用DLL文件后可能出现的问题

将DLL文件复制到新建工程的debug文件夹下，在程序中进行引用后，在建立连接时采用IConnectionFactory factory = newConnectionFactory("tcp://localhost:61616/");，编译过程中出现了版本不对应提示的错误，改为IConnectionFactory factory = newNMSConnectionFactory(newUri("activemq:failover:(tcp://"+textBox_URL.Text.Trim()));后可以通过，也许是因为引用的DLL版本与原来的版本对连接方式进行了修改吧，后续再测。

附录（参考资料）

A. ActiveMQ消息特性

（1）延迟和定时消息投递（Delay and Schedule Message Delivery）

有时候我们不希望消息马上被broker投递出去，而是想要消息60秒以后发给消费者，或者我们想让消息每隔一定时间投递一次，一共投递指定的次数。

类似这种需求，ActiveMQ提供了一种broker端消息定时调度机制。

我们只需把几个描述消息定时调度方式的参数作为属性添加到消息，broker端的调度器就会按照我们想要的行为去处理消息。

一共有四个属性：

Property name	type	description
AMQ_SCHEDULED_DELAY	long	延迟投递的时间
AMQ_SCHEDULED_PERIOD	long	重复投递的时间间隔
AMQ_SCHEDULED_REPEAT	int	重复投递次数
AMQ_SCHEDULED_CRON	String	Cron表达式

ActiveMQ也提供了一个封装的消息类型：org.apache.activemq.ScheduledMessage.

使用示例，延迟60秒：

MessageProducer producer = session.createProducer(destination);
TextMessage message = session.createTextMessage("test msg");
long time =  * ;
  message.setLongProperty(ScheduledMessage.AMQ_SCHEDULED_DELAY, time);
producer.send(message);

延迟30秒，投递10次，间隔10秒:

MessageProducer producer = session.createProducer(destination);
TextMessage message = session.createTextMessage("test msg");
long delay =  * ;
long period =  * ;
int repeat = ;

message.setLongProperty(ScheduledMessage.AMQ_SCHEDULED_DELAY, delay);

message.setLongProperty(ScheduledMessage.AMQ_SCHEDULED_PERIOD, period);

message.setIntProperty(ScheduledMessage.AMQ_SCHEDULED_REPEAT, repeat);

producer.send(message);

使用 CRON 表达式的例子：

MessageProducer producer = session.createProducer(destination);
TextMessage message = session.createTextMessage("test msg");

message.setStringProperty(ScheduledMessage.AMQ_SCHEDULED_CRON, "0 * * * *");
producer.send(message);

CRON表达式的优先级高于另外三个参数，如果在设置了CRON的同时，也有repeat和period参数，则会在每次CRON执行的时候，重复投递repeat次，每次间隔为period。就是说设置是叠加的效果。例如每小时都会发生消息被投递10次，延迟1秒开始，每次间隔1秒:

MessageProducer producer = session.createProducer(destination);
TextMessage message = session.createTextMessage("test msg");

message.setStringProperty(ScheduledMessage.AMQ_SCHEDULED_CRON, "0 * * * *");

message.setLongProperty(ScheduledMessage.AMQ_SCHEDULED_DELAY, );

message.setLongProperty(ScheduledMessage.AMQ_SCHEDULED_PERIOD, );

message.setIntProperty(ScheduledMessage.AMQ_SCHEDULED_REPEAT, );

producer.send(message);

B. ActiveMQ基本介绍

（1）ActiveMQ服务器工作模型

通过ActiveMQ消息服务交换消息。消息生产者将消息发送至消息服务，消息消费者则从消息服务接收这些消息。这些消息传送操作是使用一组实现 ActiveMQ应用编程接口 (API) 的对象来执行的。

ActiveMQ客户端使用 ConnectionFactory 对象创建一个连接，向消息服务发送消息以及从消息服务接收消息均是通过此连接来进行。Connection 是客户端与消息服务的活动连接。创建连接时，将分配通信资源以及验证客户端。这是一个相当重要的对象，大多数客户端均使用一个连接来进行所有的消息传送。  连接用于创建会话。Session 是一个用于生成和使用消息的单线程上下文。它用于创建发送的生产者和接收消息的消费者，并为所发送的消息定义发送顺序。会话通过大量确认选项或通过事务来支持可靠传送。

客户端使用 MessageProducer 向指定的物理目标（在 API 中表示为目标身份对象）发送消息。生产者可指定一个默认传送模式（持久性消息与非持久性消息）、优先级和有效期值，以控制生产者向物理目标发送的所有消息。

同样，客户端使用 MessageConsumer 对象从指定的物理目标（在 API 中表示为目标对象）接收消息。消费者可使用消息选择器，借助它，消息服务可以只向消费者发送与选择标准匹配的那些消息。  消费者可以支持同步或异步消息接收。异步使用可通过向消费者注册 MessageListener 来实现。当会话线程调用 MessageListener 对象的 onMessage 方法时，客户端将使用消息。

（2）ActiveMQ消息传送模型

ActiveMQ 支持两种截然不同的消息传送模型：PTP（即点对点模型）和Pub/Sub（即发布 /订阅模型），分别称作：PTP Domain 和Pub/Sub Domain。

PTP（使用Queue 即队列目标） 消息从一个生产者传送至一个消费者。在此传送模型中，目标是一个队列。消息首先被传送至队列目标，然后根据队列传送策略，从该队列将消息传送至向此队列进行注册的某一个消费者，一次只传送一条消息。可以向队列目标发送消息的生产者的数量没有限制，但每条消息只能发送至、并由一个消费者成功使用。如果没有已经向队列目标注册的消费者，队列将保留它收到的消息，并在某个消费者向该队列进行注册时将消息传送给该消费者。

Pub/Sub（使用 Topic即主题目标）消息从一个生产者传送至任意数量的消费者。在此传送模型中，目标是一个主题。消息首先被传送至主题目标，然后传送至所有已订阅此主题的活动消费者。可以向主题目标发送消息的生产者的数量没有限制，并且每个消息可以发送至任意数量的订阅消费者。主题目标也支持持久订阅的概念。持久订阅表示消费者已向主题目标进行注册，但在消息传送时此消费者可以处于非活动状态。当此消费者再次处于活动状态时，它将接收此信息。如果没有已经向主题目标注册的消费者，主题不保留其接收到的消息，除非有非活动消费者注册了持久订阅。

（3）ActiveMQ消息选择器

ActiveMQ提供了一种机制，使用它，消息服务可根据消息选择器中的标准来执行消息过滤。生产者可在消息中放入应用程序特有的属性，而消费者可使用基于这些属性的选择标准来表明对消息是否感兴趣。这就简化了客户端的工作，并避免了向不需要这些消息的消费者传送消息的开销。然而，它也使得处理选择标准的消息服务增加了一些额外开销。消息选择器是用于MessageConsumer的过滤器，可以用来过滤传入消息的属性和消息头部分（但不过滤消息体），并确定是否将实际消费该消息。消息选择器是一些字符串，它们基于某种语法，而这种语法是SQL-92的子集。可以将消息选择器作为MessageConsumer 创建的一部分。

（4）ActiveMQ消息签收

在不带事务的 Session 中，一条消息何时和如何被签收取决于Session的设置。

①Session.AUTO_ACKNOWLEDGE

当客户端从 receive 或 onMessage成功返回时，Session 自动签收客户端的这条消息的收条。在AUTO_ACKNOWLEDGE的 Session 中，同步接收 receive是上述三个阶段的一个例外，在这种情况下，收条和签收紧随在处理消息之后发生。

②Session.CLIENT_ACKNOWLEDGE

客户端通过调用消息的 acknowledge 方法签收消息。在这种情况下，签收发生在 Session 层面：签收一个已消费的消息会自动地签收这个 Session 所有已消费消息的收条。

③Session.DUPS_OK_ACKNOWLEDGE

此选项指示 Session 不必确保对传送消息的签收。它可能引起消息的重复，但是降低了 Session 的开销，所以只有客户端能容忍重复的消息，才可使用（如果ActiveMQ 再次传送同一消息，那么消息头中的JMSRedelivered 将被设置为 true）。客户端成功接收一条消息的标志是这条消息被签收。成功接收一条消息一般包括如下三个阶段：

客户端接收消息；

客户端处理消息；

消息被签收。签收可以由 ActiveMQ发起，也可以由客户端发起，取决于 Session 签收模式的设置。 在带事务的 Session 中，签收自动发生在事务提交时。如果事务回滚，所有已经接收的消息将会被再次传送。

（5）ActiveMQ消息传送模式

ActiveMQ 支持两种消息传送模式：PERSISTENT 和 NON_PERSISTENT 两种。

①PERSISTENT（持久性消息）

这是 ActiveMQ 的默认传送模式，此模式保证这些消息只被传送一次和成功使用一次。对于这些消息，可靠性是优先考虑的因素。可靠性的另一个重要方面是确保持久性消息传送至目标后，消息服务在向消费者传送它们之前不会丢失这些消息。这意味着在持久性消息传送至目标时，消息服务将其放入持久性数据存储。如果消息服务由于某种原因导致失败，它可以恢复此消息并将此消息传送至相应的消费者。虽然这样增加了消息传送的开销，但却增加了可靠性。

②NON_PERSISTENT（非持久性消息）

保证这些消息最多被传送一次。对于这些消息，可靠性并非主要的考虑因素。此模式并不要求持久性的数据存储，也不保证消息服务由于某种原因导致失败后消息不会丢失。

有两种方法指定传送模式：

使用setDeliveryMode 方法，这样所有的消息都采用此传送模式；

使用 send 方法为每一条消息设置传送模式。

（6）ActiveMQ优先级设置

通常，可以确保将单个会话向目标发送的所有消息按其发送顺序传送至消费者。然而，如果为这些消息分配了不同的优先级，消息传送系统将首先尝试传送优先级较高的消息。

有两种方法设置消息的优先级：

使用 setDeliveryMode 方法，这样所有的消息都采用此传送模式；

使用 send 方法为每一条消息设置传送模式。

消息优先级从 0-9 十个级别，0-4 是普通消息，5-9 是加急消息。如果不指定优先级，则默认为 4。JMS 不要求严格按照这十个优先级发送消息，但必须保证加急消息要先于普通消息到达。

（7）ActiveMQ消息过期设置

允许消息过期。默认情况下，消息永不会过期。如果消息在特定周期内失去意义，那么可以设置过期时间。

有两种方法设置消息的过期时间，时间单位为毫秒：

使用setTimeToLive 方法为所有的消息设置过期时间；

使用send 方法为每一条消息设置过期时间。

消息过期时间，send 方法中的 timeToLive 值加上发送时刻的 GMT 时间值。如果 timeToLive值等于零，则 JMSExpiration 被设为零，表示该消息永不过期。如果发送后，在消息过期时间之后消息还没有被发送到目的地，则该消息被清除。

（8）ActiveMQ持久订阅设置

通过为发布者设置 PERSISTENT传送模式，为订阅者时使用持久订阅，这样可以保证 Pub/Sub 程序接收所有发布的消息。

消息订阅分为非持久订阅(non-durable subscription)和持久订阅(durable subscription)，非持久订阅只有当客户端处于激活状态，也就是和 ActiveMQ 保持连接状态才能收到发送到某个主题的消息，而当客户端处于离线状态，这个时间段发到主题的消息将会丢失，永远不会收到。持久订阅时，客户端向ActiveMQ 注册一个识别自己身份的 ID，当这个客户端处于离线时，ActiveMQ会为这个 ID 保存所有发送到主题的消息，当客户端再次连接到ActiveMQ 时， 会根据自己的 ID 得到所有当自己处于离线时发送到主题的消息。持久订阅会增加开销，同一时间在持久订阅中只有一个激活的用户。

建立持久订阅的步骤：

为连接设置一个客户 ID；

为订阅的主题指定一个订阅名称。

上述组合必须唯一。

（9）ActiveMQ异步发送消息

ActiveMQ支持生产者以同步或异步模式发送消息。使用不同的模式对 send方法的 反应时间有巨大的影响，反映时间是衡量ActiveMQ 吞吐量的重要因素，使用异步发送

可以提高系统的性能。 在默认大多数情况下，AcitveMQ是以异步模式发送消息。例外的情况：在没有使用事务的情况下，生产者以 PERSISTENT传送模式发送消息。在这种情况下，send方法都是同步的，并且一直阻塞直到 ActiveMQ发回确认消息：消息已经存储在持久性数据存储中。这种确认机制保证消息不会丢失，但会造成生产者阻塞从而影响反应时间。

高性能的程序一般都能容忍在故障情况下丢失少量数据。如果编写这样的程序，可以通过使用异步发送来提高吞吐量（甚至在使用PERSISTENT 传送模式的情况下）。

（10）ActiveMQ消费者特性

①消费者异步分派

在 ActiveMQ4 中，支持 ActiveMQ 以同步或异步模式向消费者分派消息。这样的意义：可以以异步模式向处理消息慢的消费者分配消息；以同步模式向处理消息快的消费者分配消息。 ActiveMQ默认以同步模式分派消息（setDispatchAsync(false)或TEST.QUEUE?consumer.dispatchAsync=false），这样的设置可以提高性能。但是对于处理消息慢的消费者，需要以异步模式分派。

②消费者优先级

在 ActveMQ 分布式环境中，在有消费者存在的情况下，如果更希望ActveMQ 发送消给消费者而不是其他的 ActveMQ 到ActveMQ 的传送，可以如下设置：TEST.QUEUE?consumer.prority=10。

③独占消费者

ActiveMQ维护队列消息的顺序并顺序把消息分派给消费者。但是如果建立了多个Session 和 MessageConsumer，那么同一时刻多个线程同时从一个队列中接收消息时就并不能保证处理时有序。 有时候有序处理消息是非常重要的。ActiveMQ4 支持独占的消费。ActiveMQ 挑选一个 MessageConsumer，并把一个队列中所有消息按顺序分派给它。如果消费者发生故障，那么ActiveMQ将自动故障转移并选择另一个消费者。可以如下设置： TEST.QUEUE?consumer.exclusive=true。

（11）ActiveMQ消息预取机制

ActiveMQ的目标之一就是高性能的数据传送，所以ActiveMQ 使用“预取限制”来 控制有多少消息能及时的传送给任何地方的消费者。一旦预取数量达到限制，那么就不会有消息被分派给这个消费者直到它发回签收消息（用来标识所有的消息已经被处理）。 可以为每个消费者指定消息预取。如果有大量的消息并且希望更高的性能，那么可以为这个消费者增大预取值。如果有少量的消息并且每条消息的处理都要花费很长的时间，那么可以设置预取值为 1，这样同一时间，ActiveMQ 只会为这个消费者分派一条消息。如：TEST.QUEUE?consumer.prefetchSize=10

C. 参考网页

Active MQ C#实现- lee353086的专栏- 博客频道- CSDN.NET

http://blog.csdn.net/lee353086/article/details/6819123

ActiveMQ 即时通讯服务 浅析- hoojo - 博客园

http://www.cnblogs.com/hoojo/p/active_mq_jms_apache_activeMQ.html

ActiveMQ在C#中的应用- bodybo的专栏- 博客频道- CSDN.NET

http://blog.csdn.net/bodybo/article/details/5647968

ActiveMQ初体验- diorlv - 博客园

http://www.cnblogs.com/diorlv/p/3328712.html

C# activeMQ使用- 推酷

http://www.tuicool.com/articles/JNbYJ3