JMS的消息结构相似于HTTP请求的结构分为三部分:java
下面分别说明三部分的内容标准。服务器
1. 消息头
消息头包含消息的识别信息和路由信息,其标准属性以下:
下面介绍的参数均可以经过Message
对象进行设置。ide
1.1. 能够经过producer
的send
方法快捷设置的参数
- JMSDestination:消息发送的目的地,主要是指Queue和Topic,自动分配。
- JMSDeliveryMode:传送模式,分为两种:持久模式和非持久模式。一条持久性的消息应该被传送“一次且仅仅一次”,这就意味着若是JMS提供者出现故障,该消息并不会丢失,他会在服务器恢复以后再次传递;一条非持久性的消息最多会传递一次,这意味着服务器出现故障,该消息将永远丢失,自动分配。
- JMSExpiration:消息过时时间,等于
producer
的send
方法中的timeToLive
值加上发送时刻的GMT时间值,若是timeToLive
值等于0,则JMSExpiration
被设为0,表示该消息永不过时,若是发送后,在消息过时时间以后消息尚未被发送到目的地,则该消息被清除。自动分配。
- JMSPriority:消息优先级,从0-9十个级别,0-4是普通消息,5-9是甲基消息,JMS不要求JMS Provider严格按照这十个优先级发送消息,但必须保证加急消息要先于普通消息到达,默认是4级,自动分配。
1.2.其余参数
- JMSMessageID:惟一识别每一个消息的标识,由JMS Provider产生,自动分配。
- JMSTimestamp:一个JMS Provider在调用send方法时自动设置的,它是消息被发送和消费者实际接收的时间差,自动分配。
- JMSCorrelationID:用来链接到另一个消息,典型的应用是在回复消息中链接到原消息,在大多数状况下,JMSCorrelationID用于将一条消息标记为对JMSMessageID标示的上一条消息的应答。不过,JMSCorrelationID能够是任何值,不单单是JMSMessageID,由开发者设置。
- JMSReplyTo:提供本消息回复消息的目的地址,由开发者设置;
- JMSType:消息类型的识别符,由开发者设置;
- JMSRedelivered:若是一个客户端收到了一个设置了
JMSRedelivered
属性的消息,则表示可能客户端曾经在某些时候收到过该消息,但并无签收(Acknowledge
),若是该消息被从新传送,JMSRedelivered=true,反之JMSRedelivered=false,自动设置。
2. 消息体结构
JSM标准API定了5种消息体格式,也叫消息类型,可使用不一样形式发送接收数据,并能够兼容现有的消息格式。包括:TextMessage、MapMessage、BytesMessage、StreamMessage和ObjectMessage。code
3. 消息属性
其本质上就是key-value
键值对。
消息属性包含如下三种类型:对象
3.1. 应用程序设置和添加的属性
其value
能够是各类不一样的类型,用来给消息添加附加属性,经过Message
对象设置。好比:事务
message.setStringProperty("username", username);
3.2. JMS定义的属性
其特色是key
使用"JMSX"做为属性的前缀,属于JMS的标准属性。路由
//经过该方法获取全部链接支持的JMSX属性的名字
connection.getMetaData().getJMSXPropertyNames();
经常使用的有哪些呢,咱们列举说明一下:开发
- JMSXUserID:发送消息的用户标识,发送时提供商设置;
- JMSXAppID:发送消息的应用标识,发送时提供商设置;
- JMSXDeliveryCount:转发消息重试次数,第一次是1,第二次是2,… ,发送时提供商设置;
- JMSXGroupID:消息所在消息组的标识,由客户端设置;
- JMSXGroupSeq:组内消息的序号第一个消息是1,第二个是2,…,由客户端设置;
- JMSXProducerTXID :产生消息的事务的事务标识,发送时提供商设置;
- JMSXConsumerTXID :消费消息的事务的事务标识,接收时提供商设置;
- JMSXRcvTimestamp :JMS 转发消息到消费者的时间,接收时提供商设置;
- JMSXState:假定存在一个消息仓库,它存储了每一个消息的单独拷贝,且这些消息从原始消息被发送时开始。每一个拷贝的状态有:1(等待),2(准备),3(到期)或4(保留)。因为状态与生产者和消费者无关,因此它不是由它们来提供。它只和在仓库中查找消息相关,所以JMS没有提供这种API。由提供商设置。
3.3. JMS Provider特定的属性
这种属性由于绑定到了某一具体的Provider上,因此尽可能少用。get