（六）：消息头

原创

xo_zhang 2022-08-30 11:24:20 博主文章分类：ActiveMQ ©著作权

©著作权归作者所有：来自51CTO博客作者xo_zhang的原创作品，请联系作者获取转载授权，否则将追究法律责任

一个消息对象分为三部分：消息头(Headers)，属性（Properties）和消息体（Payload）。对于StreamMessage和 MapMessage，消息本身就有特定的结构，而对于TextMessage，ObjectMessage和BytesMessage是无结构的。一个消息可以包含一些重要的数据或者仅仅是一个事件的通知。

消息的Headers部分通常包含一些消息的描述信息，它们都是标准的描述信息。包含下面一些值：

　　JMSDestination
消息的目的地，Topic或者是Queue。

　　JMSDeliveryMode
消息的发送模式：persistent或nonpersistent。前者表示消息在被消费之前，如果JMS提供者DOWN了，重新启动后消息仍然存在。后者在这种情况下表示消息会被丢失。可以通过下面的方式设置：
Producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT);

JMSTimestamp
当调用send()方法的时候，JMSTimestamp会被自动设置为当前事件。可以通过下面方式得到这个值：
long timestamp = message.getJMSTimestamp();
JMSExpiration
表示一个消息的有效期。只有在这个有效期内，消息消费者才可以消费这个消息。默认值为0，表示消息永不过期。可以通过下面的方式设置：
producer.setTimeToLive(3600000); //有效期1小时（1000毫秒 * 60秒 * 60分）

　　JMSPriority
消息的优先级。0-4为正常的优先级，5-9为高优先级。可以通过下面方式设置：
producer.setPriority(9);

　　JMSMessageID
一个字符串用来唯一标示一个消息。

　　JMSReplyTo
有时消息生产者希望消费者回复一个消息，JMSReplyTo为一个Destination，表示需要回复的目的地。当然消费者可以不理会它。

　　JMSCorrelationID
通常用来关联多个Message。例如需要回复一个消息，可以把JMSCorrelationID设置为所收到的消息的JMSMessageID。

　　JMSType
表示消息体的结构，和JMS提供者有关。

　　JMSRedelivered
如果这个值为true，表示消息是被重新发送了。因为有时消费者没有确认他已经收到消息或者JMS提供者不确定消费者是否已经收到。

除了Header，消息发送者可以添加一些属性(Properties)。这些属性可以是应用自定义的属性，JMS定义的属性和JMS提供者定义的属性。我们通常只适用自定义的属性。

后面会讲到这些Header和属性的用法。

（七）：DeliveryMode例子

在下面的例子中，分别发送一个Persistent和nonpersistent的消息，然后关闭退出JMS。[/size]

运行上面的程序，可以得到下面的输出结果：

/** 

 * 

 */ 

 package deliverymode; 


 import javax.jms.Connection; 

 import javax.jms.DeliveryMode; 

 import javax.jms.MessageProducer; 

 import javax.jms.Queue; 

 import javax.jms.Session; 


 import org.apache.activemq.ActiveMQConnectionFactory; 

 import org.apache.activemq.command.ActiveMQQueue; 


 /** 

 * After run the application successfully, Stop JMS provider 

 * If the message is persistent, Even the JMS' provider done(ActiveMQ, EJB Message Driven Bean), 

 * After restart JMS' provider, the related consumer can get the message. 

 * @author Wang Sheng(Josh) 

 * 

 */ 

 public class DeliveryModeSendTest { 


 /** 

 * @param args 

 */ 

 public static void main(String[] args) throws Exception { 

 ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory(); 


 Connection connection = factory.createConnection(); 

 connection.start(); 


 Queue queue = new ActiveMQQueue("JoshDeliveryModeQueue"); 

 Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); 


 MessageProducer producer = session.createProducer(queue); 

 producer.setDeliveryMode(DeliveryMode.PERSISTENT); 

 producer.send(session.createTextMessage("A Persistent Message")); 


 producer.setDeliveryMode(DeliveryMode.NON_PERSISTENT); 

 producer.send(session.createTextMessage("A Non Persistent Message")); 


 System.out.println("Send messages Successfully!!!"); 


 } 


 } 

运行上面的程序，当输出“Send messages sucessfully!”时，说明两个消息都已经发送成功，然后我们结束它，来停止JMS Provider。 

 接下来我们重新启动JMS Provicer，然后添加一个消费者： 

 /** 

 * 

 */ 

 package deliverymode; 


 import javax.jms.Connection; 

 import javax.jms.JMSException; 

 import javax.jms.Message; 

 import javax.jms.MessageConsumer; 

 import javax.jms.MessageListener; 

 import javax.jms.Queue; 

 import javax.jms.Session; 

 import javax.jms.TextMessage; 


 import org.apache.activemq.ActiveMQConnectionFactory; 

 import org.apache.activemq.command.ActiveMQQueue; 


 /** 

 * @author Wang Sheng(Josh) 

 * 

 */ 

 public class DeliveryModeReceiveTest { 


 /** 

 * Run the application, there only one message: persistent message can be 

 * received successfully. 

 * 

 * In addition to, when sending a non persistent message and there is no 

 * any listener listen at the same time, the message will lost too. 

 * 

 * @param args 

 */ 

 public static void main(String[] args) throws Exception { 

 ActiveMQConnectionFactory factory = new ActiveMQConnectionFactory(); 


 Connection connection = factory.createConnection(); 

 connection.start(); 


 // The queues name must equals the queues name with the Producer queue 

 Queue queue = new ActiveMQQueue("JoshDeliveryModeQueue"); 

 Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE); 


 MessageConsumer consumer = session.createConsumer(queue); 

 consumer.setMessageListener(new MessageListener() { 


 @Override 

 public void onMessage(Message message) { 

 try { 

 System.out.println("Consumer get " + ((TextMessage)message).getText()); 

 } catch (JMSException e) { 

 e.printStackTrace(); 

 } 

 } 

 }); 


 } 


 }