（六）：消息头

一个消息对象分为三部分：消息头(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和属性的用法。

[size=x-large] （七）：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();
}
}
});

}

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

Consumer get A persistent Message

可以看出消息消费者只接收到一个消息，它是一个Persistent的消息。而刚才发送的non persistent消息已经丢失了。

另外, 如果发送一个non persistent消息, 而刚好这个时候没有消费者在监听, 这个消息也会丢失.