Consumer高级特性

　　Queue队列的消息一般是按照顺序各个队列依次获取消息，每次获取一个。所以假设有两个队列queue1，queue2，发送的消息为1、2、3、4、5。则默认情况下queue1获取到的消息为1、3、5，queue2获取到的消息为2、4.

1.Exclusive Consume　用于队列消息　

　　独有消费者：Queue中的消息是按照顺序被分发到consumer的，然而，当你有多个consumers同时从相同的queue中提取消息时，你将失去这个保证。因为这些消息是被多个线程并发的处理。有的时候，保证消息按照顺序处理是很重要的。例如：你可能不希望在插入订单操作结束之前执行更新这个订单的操作。
　　ActiveMQ从4.x版本开始支持Exclusive Consumer。Broker会从多个Consumers中挑选一个consumer来处理queue中所有的消息，从而保证了消息的有序处理。如果这个consumer失效，那么broker会自动切换到其他的consumer。可以通过destination options来创建一个Exclusive Consumer,如下：

    private static final String queueName = "myQueue?consumer.exclusive=true";

　　还可以给consumer设置优先级，以便针对网络情况进行优化，如下：

private static final String queueName = "myQueue?consumer.exclusive=true&consumer.priority=10";

　　也就是这个会独占这个队列频道，所有的消息都将发发到这个连接上。在多线程环境下仍然是就这一个连接可以获取到消息。

2. Consumer Dispatche Async    用于队列消息

在activemq4.0以后，你可以选择broker同步或异步的把消息分发给消费者。可以设置dispatchAsync属性，默认是true,通常情况下这是最佳的。
你也可以通过如下几种方式修改：
1. 在ConnectionFactory层设置

ActiveMQConnectionFactory.setDispatchAsync(false);

2. 在Connection上设置,这个设置将会覆盖ConnectionFactory上的设置

ActiveMQConnetion.setDispatchAsync(false);

3. 在Consumer上设置

　　queue = new ActiveMQQueue("TEST.QUEUE?consumer.dispatchAsync=false");
　　consumer = session.createConsumer(queue);

3. Consumer Priority    用于队列消息

JMS JMSPriority定义了十个消息优先级值，0是最低优先级，9是最高优先级，另外，客户端应当将0-4看作普通优先级，5-9看作加急优先级。

自定义Consumer Priority优先级。配置如下：

private static final String queueName = "myQueue?consumer.priority=10";

　　Consumer的Priority的划分为0~127个级别，127是最高的级别，0是最低的也是ActiveMQ默认的。这种配置可以让Broker根据consumer的优先级来发送消息到较高的优先级的Consumer上，如果某个较高的Consumer的消息转载慢，则Broker会把消息发送到仅次于它优先级的Consumer上。

通过测试发现:只有消息级别相同的情况下才会平分队列的消息，如果存在一方的级别高于其他那么级别高的会获取全部的消息。

4. Manage Durable Subscribers　　用于主题消息

消息持久化，保证了消费者离线之后，再次进入系统，不会错过消息，但是这也会消耗很多的资源，从5.6开始，可以对持久化进行如下管理：
　　Removing inactive subscribers
我们还希望可以删除那些不活动的订阅者，如下：

<broker xmlns="http://activemq.apache.org/schema/core" schedulerSupport="true" offlineDurableSubscriberTimeout="30000" offlineDurableSubscriberTaskSchedule="30000" brokerName="brokerName" dataDirectory="${activemq.data}" schedulePeriodForDestinationPurge="1000">

1.offlineDurableSubscriberTimeout：离线多长时间就过期删除，缺省是-1，就是不删除。
2. offlineDurableSubscriberTaskSchedule： 多长时间检查一次，缺省300000，单位毫秒。

5. Message Groups　　

　　Message Goups就是对消息分组，它是Exclusive Consumer功能的增强。逻辑上Message Groups可以看成是一种并发的Exclusive Consumer。跟所有的消息都由唯一的consumer处理不同，JMS消息属性的JMSXGroupID用来区分message group.

　　Message Group特性保证所有具有相同JMSXGroupID的消息 都会被分发到相同的consumer(只要这个consumer保持active).
　　另一方面，Message Groups特性也是一种负载均衡的机制。在一个消息被分发到consumer之前，broker首先检查消息JMSXGroupID属性。如果存在，那么broker会检查是否有某个consumer拥有这个message group.如果没有，那么broker会选择一个consumer,并将它关联到这个message group.此后，这个consumer会接收到这个message group的所有消息，直到：
　　1. consumer被关闭
　　2. Message group被关闭，通过发送一个消息，并设置这个消息的JMSXGroupSeq为-1
　　创建一个Message Groups，只需要在message对象上设置属性即可，如下：

message.setStringProperty("JMSXGroupID","GroupA");

　　关闭一个Message Groups，只需要在message对象上设置属性即可，如下：

　　message.setStringProperty("JMSXGroupID","GroupA");
　　message.setIntProperty("JMSXGroupSeq",-1);

例如:生产者将序号1、2、3的设为1组，两个消费者接收:

生产者代码:

        for (int i = 0; i < 5; i++) {
            // 7.创建Message，有好多类型，这里用最简单的TextMessage
            TextMessage tms = session.createTextMessage("textMessage:" + i);

            // 设置附加属性
            tms.setStringProperty("str", "stringProperties" + i);
            tms.setJMSPriority(6);
            tms.setJMSReplyTo(temporaryQueue);

            // 设置消息组
            if (i == 1 || i == 2 || i == 3) {
                tms.setStringProperty("JMSXGroupID", "GroupA");
            }

            // 8.生产者发送消息
            producer.send(tms);
        }

结果:

消费者2:

2019-04-12 14:51:33 [cn.qlq.activemq.queue.MsgConsumer2]-[INFO] [C2]threadname ->main,接收消息:textMessage:1;属性stringProperties1
2019-04-12 14:51:33 [cn.qlq.activemq.queue.MsgConsumer2]-[INFO] [C2]threadname ->main,接收消息:textMessage:2;属性stringProperties2
2019-04-12 14:51:33 [cn.qlq.activemq.queue.MsgConsumer2]-[INFO] [C2]threadname ->main,接收消息:textMessage:3;属性stringProperties3

消费者1:

2019-04-12 14:51:33 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:0;属性stringProperties0
2019-04-12 14:51:33 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:4;属性stringProperties4

6. Message Selectors

　　JMS Selectors 用在获取消息的时候，可以基于消息属性和Xpath语法对消息进行过滤。JMS Selectors有SQL92语义定义。以下是个Selectors的例子：

        // 6.创建消费者consumer
        MessageConsumer consumer = session.createConsumer(destination, "sendTo='C2'");

1. JMS Selectors表达式中，可以使用IN, NOT IN, LIKE等
2. 需要注意的是，JMS Selectors表达式中的日期和时间需要使用标准的Long型毫秒值。
3. 表达式中的属性不会自动进行类型转换，例如：

tms.setStringProperty("strVal", "2");

　　　　那么此时“setVal > 1” 的结果就是会false
4. Message Groups虽然可以保证具有相同的message group的消息会被唯一的consumer顺序处理，但是却不能确定被哪个consumer处理，在某些情况下，Message Groups可以和JMS Selector一起工作。
　　例如：设想三个consumers分别是A，B，C，你可以在producer中为消息设置三个message groups分别为“A","B","C"。然后令Consumer A使用JMSXGroupID='A'作为selector，c和b也同理，这样就保证了message group A的消息只会被A处理，需要注意的是，这种做法有以下缺点：
　　（1） producer必须直到当前正在运行的consumers，也就是说producer和consumer被耦合到一起。
　　（2） 如果某个consumer失效，那么应该被这个consumer消费的消息将会一直被积压在broker上。

例如:设置一个sendTo属性标记发给哪个消费者

生产者:

            // 设置消息组
            if (i == 1 || i == 2 || i == 3) {
                tms.setStringProperty("sendTo", "C1");
            } else {
                tms.setStringProperty("sendTo", "C2");
            }

C1:

        // 6.创建消费者consumer
        MessageConsumer consumer = session.createConsumer(destination, "sendTo='C1'");

C2:

        // 6.创建消费者consumer
        MessageConsumer consumer = session.createConsumer(destination, "sendTo='C2'");

7.Redelivery Policy  重传策略

ActiveMQ在接收消息的Client有以下几种操作的时候，需要重新传递消息：
　　1. Client用了transactions,且在Session中调用了rollback();
　　2. Client用了transactions，且在调用commit()之前关闭。
　　3. Client在CLIENT_ACKNOWLEDGE的传递模式下，在session中调用了recover();

可以通过设置ActiveMQConnectionFactory和ActiveMQConnection来定制想要的再次传送策略，可用的Redelivery属性如下：
　　1). collisionAvoidanceFactor:设置防止冲突范围的正负百分比，只有启用了useCollisionAvoidance参数时才生效。也就是在延迟时间上再加一个时间波动范围。默认值是0.15
　　2). maximumRedeliveries:最大重传次数，达到最大重传次数后抛出异常。为-1时不限制次数，为0时表示不进行重传。默认值为
　 3) . maximumRedeliveryDelay:传送延迟，旨在useExpoentialBackOff为true时有效（5.5之后），假设首次重间隔为10ms,倍数为2，那么第二次重连时间间隔为20ms,第三次重连时间间隔为40ms,当重连时间间隔大于最大重连时间间隔时，以后每次重连时间间隔都为最大重连时间间隔。默认为-1.
　　4). initialRedeliveryDelay:初始重发延迟时间，默认1000L
　　5). redeliveryDelay:重发延迟时间，当initialRedeliveryDelay=0时生效，默认1000L
　　6). useCollisionAvoidance:启用防止冲突功能，默认false
　　7). useExponentialBackOff:启用指数倍数递增的方式增加延迟时间，默认false
　　8). backOffMultiplier:重连时间间隔递增倍数，只有值大于1和启用useExponentialBackOff参数时才生效，默认是5；

例如:测试session中发生异常，重传3次，间隔2s重传(总共传4次)

生产者代码

package cn.qlq.activemq.queue;

import javax.jms.Connection;
import javax.jms.JMSException;
import javax.jms.MessageProducer;
import javax.jms.Queue;
import javax.jms.Session;
import javax.jms.TemporaryQueue;
import javax.jms.TextMessage;

import org.apache.activemq.ActiveMQConnectionFactory;

/**
 * 生产消息
 */
public class MsgProducer {

    // 默认端口61616
    private static final String url = "tcp://localhost:61616/";
    private static final String queueName = "myQueue";
    private static Session session = null;

    public static void main(String[] args) throws JMSException {
        // 1创建ConnectionFactory
        ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(url);
        // 2.由connectionFactory创建connection
        Connection connection = connectionFactory.createConnection();
        // 3.启动connection
        connection.start();
        // 4.创建Session===第一个参数是是否事务管理，第二个参数是应答模式
        session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
        // 5.创建Destination(Queue继承Queue)
        Queue destination = session.createQueue(queueName);

        TemporaryQueue temporaryQueue = session.createTemporaryQueue();

        // 6.创建生产者producer
        MessageProducer producer = session.createProducer(destination);
        for (int i = 0; i < 2; i++) {
            // 7.创建Message，有好多类型，这里用最简单的TextMessage
            TextMessage tms = session.createTextMessage("textMessage:" + i);

            // 设置附加属性
            tms.setStringProperty("str", "stringProperties" + i);
            tms.setJMSPriority(6);
            tms.setJMSReplyTo(temporaryQueue);

            // 8.生产者发送消息
            producer.send(tms);
        }

        // 9.提交事务
        session.commit();

        // 10.关闭connection
        session.close();
        connection.close();
    }

}

消费者代码: (处理第二个消息的时间制造异常进行事务回滚操作，消息会重发三次，之后会进入死队列)

package cn.qlq.activemq.queue;

import javax.jms.Connection;
import javax.jms.JMSException;
import javax.jms.MessageConsumer;
import javax.jms.Queue;
import javax.jms.Session;
import javax.jms.TextMessage;

import org.apache.activemq.ActiveMQConnectionFactory;
import org.apache.activemq.RedeliveryPolicy;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

/**
 * 消费消息
 *
 * @author QiaoLiQiang
 * @time 2018年9月18日下午11:26:41
 */
public class MsgConsumer {

    // 默认端口61616
    private static final String url = "failover:(tcp://localhost:61616,tcp://localhost:61617)?randomize=true";
    private static final String queueName = "myQueue?consumer.priority=9";
    private static final Logger LOGGER = LoggerFactory.getLogger(MsgConsumer.class);

    public static void main(String[] args) throws JMSException, InterruptedException {
        // 1创建ConnectionFactory
        ActiveMQConnectionFactory connectionFactory = new ActiveMQConnectionFactory(url);

        RedeliveryPolicy policy = new RedeliveryPolicy();
        policy.setMaximumRedeliveries(3);// 重传次数
        policy.setInitialRedeliveryDelay(2 * 1000);
        connectionFactory.setRedeliveryPolicy(policy);

        // 2.由connectionFactory创建connection
        Connection connection = connectionFactory.createConnection();
        // 3.启动connection
        connection.start();
        // 4.创建Session===第一个参数是是否事务管理，第二个参数是应答模式
        Session session = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);
        // 5.创建Destination(Queue继承Queue)
        Queue destination = session.createQueue(queueName);
        // 6.创建消费者consumer
        MessageConsumer consumer = session.createConsumer(destination);

        int i = 0;
        while (i < 50) {
            TextMessage textMessage = (TextMessage) consumer.receive();
            LOGGER.info("[C2]threadname ->{},接收消息:{}", Thread.currentThread().getName(),
                    textMessage.getText() + ";属性" + textMessage.getStringProperty("str"));

            // 模拟处理第二条消息的时候 异常
            try {
                if ("textMessage:1".equals(textMessage.getText())) {
                    int ee = 1 / 0;
                }
            } catch (Exception e) {
                session.rollback();
            } finally {
                i++;
                session.commit();
            }
        }

        // session.close();
        // connection.close();
    }
}

结果:

2019-04-12 16:59:46 [org.apache.activemq.transport.failover.FailoverTransport]-[INFO] Successfully connected to tcp://localhost:61616
2019-04-12 16:59:49 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:0;属性stringProperties0
2019-04-12 16:59:49 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:1;属性stringProperties1
2019-04-12 16:59:51 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:1;属性stringProperties1
2019-04-12 16:59:53 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:1;属性stringProperties1
2019-04-12 16:59:54 [cn.qlq.activemq.queue.MsgConsumer]-[INFO] [C2]threadname ->main,接收消息:textMessage:1;属性stringProperties1

并且该消息进入死队列

7.1 死队列

　　当消息试图被传递的次数超多配置中的maximumRedeliveries属性的值时，那么，broker会认定该消息是一个死消息，并会把该消息发送到死队列中。默认activeMQ中死队列被声明为”ActiveMQ.DLQ"，所有不能消费的消息都被传递到该死队列中。你可以在activemq.xml中配置individualDeadLetterStrategy属性，示例如下：

<policyEntry queue= "> " >
    <deadLetterStrategy>
        <individualDeadLetterStrategy queuePrefix= "DLQ." useQueueForQueueMessages= "true" />
    </deadLetterStrategy>
</policyEntry>

7.2 自动删除过期消息

有时需要直接删除过期的消息而不需要发送到死队列中，可以使用属性processExpired=false来设置，示例如下：

<policyEntry queue= "> " >
<deadLetterStrategy>
<sharedDeadLetterStrategy processExpired= "false" />
</deadLetterStrategy>
</policyEntry>

7.3 存放非持久消息到死队列中

默认情况下，Activemq不会把非持久的死消息发送到死队列中。非持久性如果你想把非持久的消息发送到死队列中，需要设置属性processNonPersistent=“true”，示例如下：

<policyEntry queue= "> " >
<deadLetterStrategy>
<sharedDeadLetterStrategy processNonPersistent= "true" />
</deadLetterStrategy>
</policyEntry>

7.4 为每一个Destination配置一个Redelivery Policy

RedeliveryPolicy per Destination：在5.7之后，你可以为每一个Destination配置一个Redelivery Policy，示例如：

ActiveMQConnection connection ... // Create a connection
RedeliveryPolicy queuePolicy = new RedeliveryPolicy();
queuePolicy.setInitialRedeliveryDelay(0);
queuePolicy.setRedeliveryDelay(1000);
queuePolicy.setUseExponentialBackOff(false);
queuePolicy.setMaximumRedeliveries(2);

RedeliveryPolicy topicPolicy = new RedeliveryPolicy();
topicPolicy.setInitialRedeliveryDelay(0);
topicPolicy.setRedeliveryDelay(1000);
topicPolicy.setUseExponentialBackOff(false);
topicPolicy.setMaximumRedeliveries(3);
// Receive a message with the JMS API
RedeliveryPolicyMap map = connection.getRedeliveryPolicyMap();
map.put(new ActiveMQTopic(">"), topicPolicy);
map.put(new ActiveMQQueue(">"), queuePolicy);

8.Slow Consumer Handling　

1.　　Prefetch机制：

　　ActiveMQ通过Prefetch机制来提供性能，方式是在客户端得内存里可能缓存一定数量得消息。缓存消息得数量由prefetch limit来控制。当某个consumer的prefetch buffer已经达到上限，那么broker不会再向consumer分发消息，知道consumer像broker发送消息的确认，确认后的消息将会从缓存中去掉。
　　可以通过在ActiveMQConnectionFactory或者ActiveMQConnection上设置ActiveMQPrefetchPolicy对象来配置prefetch policy。也可以通过connection options或destination options来配置。例如：

　　tcp://localhost:61616?jms.prefetchPolicy.all=50
　　tcp://localhost:61616?jms.prefetchPolicy.queuePrefetch=1

或者

queue = new ActiveMQQueue("TEST.QUEUE?consumer.prefetchSize=10");
consumer = session.createConsumer(queue)

prefetch size缺省的值如下：

　　persistent queues (default value: 1000)
　　non-persistent queues (default value: 1000)
　　persistent topics (default value: 100)
　　non-persistent topics (default value: Short.MAX_VALUE - 1)　

2. 慢Consumer处理

　　慢消费者会在非持久的topics上导致问题，一旦消息积压起来，会导致broker把大量消息保存到内存中，broker也会因此而变慢，目前，ActiveMQ使用Pending Message Limit Strategy来解决这个问题。除了prefetch buffer之外，你还要配置缓存消息的上限，超过这个上限之后，新消息到来时会丢弃旧的消息。
　　通过在配置文件的destination map中配置pendingMessageLimitStrategy，可以为不同的topic message配置不同的策略。
Pending Message Limit Strategy(等待消息限制策略),目前有以下两种“
　　1. Constant Pending Message Limit Strategy
　　　　Limit 可以设置0， > 0, -1三种方式：0表示：不额外的增加其预存大小，> 0表示：在额外的增加其预存大小，-1表示：不增加预存也不丢弃旧的消息，这个策略使用常量限制，配置如下：

　　<constantPendingMessageLimitStrategy limit="50"/>

　　2. Prefetch Rate Pending Message LimitStrategy
　　　　这种策略是利用Consumer的之前的预存的大小乘以其倍数等于现在的预存大小。比如：

　　<prefetchRatePendingMessageLimitStrategy multiplier="2.5"/>

　　3. 说明：在以上两种方式中，如果设置了0，意味着除了prefetch之外不再缓存消息，如果设置了-1意味着禁止丢弃消息。
　　配置消息的丢弃策略，目前有三种方式：
　　oldestMessageEvictionStrategy:这个策略丢弃最旧的消息。
　　oldestMessageWithLowestPriorityEvictionStrategy： 这个策略丢弃最旧的，而且具有最低优先级的消息。　　
　　uniquePropertyMessageEvictionStrategy:从5.6开始，可以根据自定义的属性来进行抛弃，比如　 <uniquePropertyMessageEvictionStrategy propertyName="STOCK"/>表示要抛弃属性名称为Stock的消息。

配置方式：