ActiveMQ死信队列

Apache ActiveMQ 中的死信队列(Dead Letter Queue, DLQ)是一个特殊队列，用于存储那些在常规队列或主题中无法正常投递或者消费的消息。当消息满足以下条件之一时，它们会被转移到死信队列：

1. 消息重试次数超过限制：当消息被消费者接收后由于某种原因(如业务处理失败、消费者异常等)导致消息无法被正确处理时，ActiveMQ会根据其重发策略对消息进行重试。当重试次数达到预先设定的最大值后，消息会被移动到死信队列。

2. 消息过期：对于设置了有效期(TTL)的消息，如果在有效期内未被成功消费，则消息也会被移动到死信队列。

3. 事务回滚：如果在事务性会话中，消息处理失败并且事务被回滚，消息也可能被送往死信队列。

4. 其他策略：可以通过配置特定的死信策略(如individualDeadLetterStrategy或sharedDeadLetterStrategy)，将特定条件下(例如消息被拒绝)的消息转移到自定义的死信队列。

默认情况下，死信队列的名字是 ActiveMQ.DLQ，不过可以通过配置文件(例如 activemq.xml)来改变这一设置或调整死信队列的行为。开发者可以编写专门的监听器去监听和处理死信队列中的消息，以便分析问题、修复错误或执行备份策略。

举例来说，如果你想更改死信队列的名称或配置，可以在 activemq.xml 中添加相应配置，例如：

<destinationPolicy>
    <policyMap>
        <policyEntries>
            <policyEntry queue=">" deadLetterStrategy="...">
                <!-- 在此处配置死信队列策略 -->
            </policyEntry>
        </policyEntries>
    </policyMap>
</destinationPolicy>

其中，deadLetterStrategy 部分可以配置多种策略类型及其属性，来决定哪些消息应该被移到哪个死信队列以及何时移动。

死信队列监听器

创建一个监听器来监听死信队列(DLQ)的消息，可以采用Java JMS API编写一个实现了MessageListener接口的类。
当死信队列中有新的消息到来时，这个监听器将会触发onMessage方法来进行消息处理。以下是一个简单的监听死信队列的示例代码：

import javax.jms.BytesMessage;
import javax.jms.JMSException;
import javax.jms.MapMessage;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.ObjectMessage;
import javax.jms.Session;
import javax.jms.StreamMessage;
import javax.jms.TextMessage;
import org.apache.activemq.command.ActiveMQDestination;

public class DeadLetterQueueListener implements MessageListener {

    @Override
    public void onMessage(Message message) {
        try {
            // 判断当前消息来自于死信队列
            ActiveMQDestination destination = (ActiveMQDestination) message.getJMSDestination();
            if (destination.getPhysicalName().equals("ActiveMQ.DLQ")) {
                System.out.println("监听到死信队列中的消息:");

                // 根据消息类型进行处理
                if (message instanceof TextMessage) {
                    TextMessage tm = (TextMessage) message;
                    String text = tm.getText();
                    System.out.println("TextMessage content: " + text);
                    // 在此处添加对文本消息的处理逻辑，例如重新发送到其他队列或存储到数据库等
                } else if (message instanceof MapMessage || message instanceof ObjectMessage ||
                        message instanceof BytesMessage || message instanceof StreamMessage) {
                    // 对于其他类型的消息，进行相应类型的转换并处理
                }

                // 在这里处理死信消息，例如重新发送、记录日志、发送告警等
                // ...

            } else {
                // 如果不是来自死信队列的消息，则忽略
            }

        } catch (JMSException e) {
            e.printStackTrace();
        }
    }
}

// 在应用初始化时创建监听器并将其关联到死信队列
public void setupDeadLetterQueueListener(ConnectionFactory connectionFactory) {
    try (Connection connection = connectionFactory.createConnection();
         Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE)) {

        Destination dlq = session.createQueue("ActiveMQ.DLQ");
        MessageConsumer consumer = session.createConsumer(dlq);
        connection.start();

        consumer.setMessageListener(new DeadLetterQueueListener());

    } catch (JMSException e) {
        // 处理异常
    }
}

原文链接 https://www.hanyuanhun.cn | https://node.hanyuanhun.cn