《JMS简明教程(PDF格式)》第11章

java　原始类型必须看作是调用原始类型的valueOf（String）转换方法来转换null　值。
设置为行总的类型，读作列中的类型。
表3?　属性值转换
boolean byte short int long float double String
boolean × ×
byte × × × × ×
short × × × ×
int × × ×
long × ×
float × × ×
double × ×
String × × × × × × × ×
21　/　66
…………………………………………………………Page　22……………………………………………………………
3。5。5　属性值作为对象
除了特定类型的属性有set/get　方法外，JMS　提供了setObjectProperty/getObjectProperty　
方法。这两个方法支持设置使用对象化的原始类型的属性。它们用于在运行时来决定属性类　
型而不是在编译时决定。它们支持同样的属性值转换。
setObjectProperty　方法接受Boolean，Byte，Short，Integer，Long，Float，Double　和String　
的值。企图使用其他的类必须抛出MessageFormatException。
getObjectProperty　方法只返回null，Boolean，Byte，Short，Integer，Long，Float，Double　
和String　的值。如果指定的属性名不存在则返回null。
3。5。6　属性迭代
没有定义属性值的排序。为了通过消息的属性值来迭代，那么使用　getPropertyNames　
来取得所有的属性名，然后使用不同的属性get　方法来取出它们的值。
方法getPropertyNames　没有返回JMS　标准头字段的名字。
3。5。7　清除消息属性的值
通过clearProperties　方法来删除消息的属性。这会使消息有一个空的属性集。然后可以　
创建和读取新的属性条目。
清除消息的属性条目不会清理消息体的值。
一旦私有属性条目被添加到消息中，则JMS　没有提供删除它的途径。
3。5。8　不存在的属性
按名字获取一个还没有被赋值的属性值则按照属性被赋了null　值来处理。
3。5。9　JMS　定义的属性
JMS　保留了“JMSX　”作为JMS　属性名的前缀。这些属性都在表3? 中。新的JMS　定义　
的属性可能在后续版本中增加。
除非说明否则支持这些属性是可选的。ConnectionMetaData。getJMSXPropertyNames（）方　
法返回所有连接支持的JMSX　属性的名字。
无论连接是否支持JMSX　属性，它们都可以在消息选择器中使用。如果消息中没有这些　
属性，那么它们与其他缺席属性一样看待。
在特定消息中，存在JMS 定义的属性，它们是由JMS　提供商根据如何控制属性的使用　
来设置的。根据管理或其它规则，可以在某些消息中包含它们在其他消息中忽略它们。
表3?　JMS　定义的属性
名字 类型 设置者 用法
JMSXUserID String 发送时提供商设置 发送消息的用户标识　
JMSXAppID String 发送时提供商设置 发送消息的应用标识　
22　/　66
…………………………………………………………Page　23……………………………………………………………
JMSXDeliveryCount int 发送时提供商设置 转发消息重试次数；　
第一次是1，第二次　
是2，…
JMSXGroupID String 客户端 消息所在消息组的标　
识
JMSXGroupSeq int 客户端 组内消息的序号；第　
一个消息是1，第二　
个是2，…
JMSXProducerTXID String 发送时提供商设置 产生消息的事务的事　
务标识
JMSXConsumerTXID String 接收时提供商设置 消费消息的事务的事　
务标识
JMSXRcvTimestamp long 接收时提供商设置 JMS　转发消息到消费　
者的时间
JMSXState int 提供商 假定存在一个消息仓　
库，它存储了每个消　
息的单独拷贝，且这　
些消息从原始消息被　
发送时开始。
每个拷贝的状态有：1　
（等待），2 （准备），　
3　（到期）或4　（保留）。　
由于状态与生产者和　
消费者无关，所以它　
不是由它们来提供。　
它只和在仓库中查找　
消息相关，因此JMS　
没有提供这种API　。
消息生产者和消费者都可以获取由提供商在发送时设置的JMSX　属性。在接收时由提供　
商设置的JSMX　属性只能由消费者获取。
如果客户端希望对消息进行分组，那么JMSXGroupID 和JMSXGroupSeq 是标准的属性。　
所有的提供商必须支持他们。
如果要使用JMSX　属性，则必须用上表中定义的名字。
除非特殊说明，否则JMSX　属性的值和语义是未下定义的。
3。5。10　提供商专有的属性
JMS　为提供商专有的属性保留了“JMS_　”属性名前缀。每个提供商定义　
了他们自己的值。JMS　提供商使用这个机制来让JMS　客户端可以获取它的所　
有消息服务。
提供商专有属性的目的是为提供商本地客户端提供特殊功