Message Property Fields Message

2-18 Programming JMS for Oracle WebLogic Server

2.4.6.2 Message Property Fields

The property fields of a message contain header fields added by the sending application. The properties are standard Java namevalue pairs. Property names must conform to the message selector syntax specifications defined in the javax.jms.Message Javadoc, at http:java.sun.comjavaee5docsapijavaxjmsMessage.html . The following values are valid: boolean, byte, double, float, int, long, short, and String. WebLogic Server supports the use of the following JMS JMSX defined properties as defined in the JMS 1.1. Specification, at http:java.sun.comproductsjmsdocs.html : Although message property fields may be used for application-specific purposes, JMS provides them primarily for use in message selectors. You determine how the JMS properties are used in your environment. You may choose to include them in some messages and omit them from others depending upon your processing criteria. For more information, see: ■ Section 6.8, Setting and Browsing Message Header and Property Fields ■ Section 6.9, Filtering Messages JMSReplyTo Specifies a queue or topic to which reply messages should be sent. This field is set directly on the message by the application before send. This feature can be used with the JMSCorrelationID header field to coordinate requestresponse messages. Simply setting the JMSReplyTo field does not guarantee a response; it simply enables the receiving application to respond. Application JMSTimestamp Contains the time at which the message was sent. WebLogic JMS writes the timestamp in the message when it accepts the message for delivery, not when the application sends the message. When the message is received, it contains the timestamp. The value stored in the field is a Java millis time value. WebLogic JMS JMSType Specifies the message type identifier String set directly on the message by the application before send. The JMS specification allows some flexibility with this field in order to accommodate diverse JMS providers. Some messaging systems allow application-specific message types to be used. For such systems, the JMSType field could be used to hold a message type ID that provides access to the stored type definitions. WebLogic JMS does not restrict the use of this field. Application Table 2–11 JMSX Property Type Description JMSXUserID System generated property that identifies the user sending the message. See Section 3.12, Using the JMSXUserID Property. JMSXDeliveryCount System generated property that specifies the number of message delivery attempts where first attempt is 1. JMSXGroupID Identity of the message group. JMSXGroupSeq Sequence number of a message within a group. Table 2–10 Cont. Message Header Fields Field Description Defined by Understanding WebLogic JMS 2-19 ■ JMS 1.1. Specification, described at http:java.sun.comproductsjmsdocs.html

2.4.6.3 Message Body