15.3. 根据注释的属性过滤 AMQP 消息
在代理将过期或未发送 AMQP 消息移至您配置的到期或死信队列前,代理会将注解和属性应用到消息。客户端可根据属性或注解创建过滤器,以便从到期或死信队列选择要消耗的特定消息。
注意
代理应用的属性是 内部 属性。这些属性不会公开给客户端供常规使用,但可以在 过滤器中指定。
下面显示了基于消息属性和注解的过滤器示例。根据属性进行过滤是尽可能推荐的方法,因为此方法需要较少的处理。
根据消息属性进行过滤
ConnectionFactory factory = new JmsConnectionFactory("amqp://localhost:5672");
Connection connection = factory.createConnection();
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
connection.start();
javax.jms.Queue queue = session.createQueue("my_DLQ");
MessageConsumer consumer = session.createConsumer(queue, "_AMQ_ORIG_ADDRESS='original_address_name'");
Message message = consumer.receive();
基于消息注解进行过滤
ConnectionFactory factory = new JmsConnectionFactory("amqp://localhost:5672");
Connection connection = factory.createConnection();
Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
connection.start();
javax.jms.Queue queue = session.createQueue("my_DLQ");
MessageConsumer consumer = session.createConsumer(queue, "\"m.x-opt-ORIG-ADDRESS\"='original_address_name'");
Message message = consumer.receive();
注意
基于注解使用 AMQP 消息时,客户端必须包含在消息注解中附加 m. 前缀,如上例中所示。
其他资源
- 有关代理应用到过期或未发送 AMQP 消息的注解和属性的更多信息,请参阅 第 4.14 节 “过期或未发送 AMQP 消息上的注解和属性”。