The IMessageProducer type exposes the following members.

Methods

  NameDescription
Public methodClose
Closes the message producer.

Since a provider may allocate some resources on behalf of a MessageProducer outside the Java virtual machine, clients should close them when they are not needed. Relying on garbage collection to eventually reclaim these resources may not be timely enough.

Public methodSend(IMessage)
Sends a message using the MessageProducer's default delivery mode, priority, and time to live.
Public methodSend(IDestination, IMessage)
Sends a message to a destination for an unidentified message producer. Uses the MessageProducer's default delivery mode, priority, and time to live.

Typically, a message producer is assigned a destination at creation time; however, the JMS API also supports unidentified message producers, which require that the destination be supplied every time a message is sent.

Public methodSend(IMessage, Int32, Int32, Int64)
Sends a message to the destination, specifying delivery mode, priority, and time to live.
Public methodSend(IDestination, IMessage, Int32, Int32, Int64)
Sends a message to a destination for an unidentified message producer, specifying delivery mode, priority and time to live.

Typically, a message producer is assigned a destination at creation time; however, the JMS API also supports unidentified message producers, which require that the destination be supplied every time a message is sent.

Properties

  NameDescription
Public propertyDeliveryMode
Sets the producer's default delivery mode.

Delivery mode is set to PERSISTENT by default.

Public propertyDestination
Gets the destination associated with this MessageProducer.
Public propertyDisableMessageID

Gets an indication of whether message IDs are disabled.

Public propertyDisableMessageTimestamp

Gets an indication of whether message timestamps are disabled.

Public propertyPriority
Sets the producer's default priority.

The JMS API defines ten levels of priority value, with 0 as the lowest priority and 9 as the highest. Clients should consider priorities 0-4 as gradations of normal priority and priorities 5-9 as gradations of expedited priority. Priority is set to 4 by default.

Public propertyTimeToLive

Gets the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system.

See Also