MessageProducer (Solace JMS API v10.25.1)

All Known Subinterfaces:

QueueSender, TopicPublisher
```
public interface MessageProducer
```
A client uses a MessageProducer object to send messages to a destination. A MessageProducer object is created by passing a Destination object to a message-producer creation method supplied by a session.
MessageProducer is the parent interface for all message producers.
A client also has the option of creating a message producer without supplying a destination. In this case, a destination must be provided with every send operation. A typical use for this kind of message producer is to send replies to requests using the request's JMSReplyTo destination.
A client can specify a default delivery mode, priority, and time to live for messages sent by a message producer. It can also specify the delivery mode, priority, and time to live for an individual message.
A client can specify a time-to-live value in milliseconds for each message it sends. This value defines a message expiration time that is the sum of the message's time-to-live and the GMT when it is sent (for transacted sends, this is the time the client sends the message, not the time the transaction is committed).
A JMS provider should do its best to expire messages accurately; however, the JMS API does not define the accuracy provided.

Version:

1.1 - February 2, 2002

See Also:

TopicPublisher, QueueSender, Session.createProducer(javax.jms.Destination)

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`close()` Closes the message producer.
`int`	`getDeliveryMode()` Gets the producer's default delivery mode.
`Destination`	`getDestination()` Gets the destination associated with this `MessageProducer`.
`boolean`	`getDisableMessageID()` Gets an indication of whether message IDs are disabled.
`boolean`	`getDisableMessageTimestamp()` Gets an indication of whether message timestamps are disabled.
`int`	`getPriority()` Gets the producer's default priority.
`long`	`getTimeToLive()` Gets the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system.
`void`	`send(Destination destination, Message message)` Sends a message to a destination for an unidentified message producer.
`void`	`send(Destination destination, Message message, int deliveryMode, int priority, long timeToLive)` Sends a message to a destination for an unidentified message producer, specifying delivery mode, priority and time to live.
`void`	`send(Message message)` Sends a message using the `MessageProducer`'s default delivery mode, priority, and time to live.
`void`	`send(Message message, int deliveryMode, int priority, long timeToLive)` Sends a message to the destination, specifying delivery mode, priority, and time to live.
`void`	`setDeliveryMode(int deliveryMode)` Sets the producer's default delivery mode.
`void`	`setDisableMessageID(boolean value)` Sets whether message IDs are disabled.
`void`	`setDisableMessageTimestamp(boolean value)` Sets whether message timestamps are disabled.
`void`	`setPriority(int defaultPriority)` Sets the producer's default priority.
`void`	`setTimeToLive(long timeToLive)` Sets the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system.

- Method Detail
  - setDisableMessageID
```
void setDisableMessageID(boolean value)
                  throws JMSException
```
    Sets whether message IDs are disabled.
    Since message IDs take some effort to create and increase a message's size, some JMS providers may be able to optimize message overhead if they are given a hint that the message ID is not used by an application. By calling the setDisableMessageID method on this message producer, a JMS client enables this potential optimization for all messages sent by this message producer. If the JMS provider accepts this hint, these messages must have the message ID set to null; if the provider ignores the hint, the message ID must be set to its normal unique value.
    Message IDs are enabled by default.
    
    Parameters:
    
    value - indicates if message IDs are disabled
    
    Throws:
    
    JMSException - if the JMS provider fails to set message ID to disabled due to some internal error.
  - getDisableMessageID
```
boolean getDisableMessageID()
                     throws JMSException
```
    Gets an indication of whether message IDs are disabled.
    
    Returns:
    
    an indication of whether message IDs are disabled
    
    Throws:
    
    JMSException - if the JMS provider fails to determine if message IDs are disabled due to some internal error.
  - setDisableMessageTimestamp
```
void setDisableMessageTimestamp(boolean value)
                         throws JMSException
```
    Sets whether message timestamps are disabled.
    Since timestamps take some effort to create and increase a message's size, some JMS providers may be able to optimize message overhead if they are given a hint that the timestamp is not used by an application. By calling the setDisableMessageTimestamp method on this message producer, a JMS client enables this potential optimization for all messages sent by this message producer. If the JMS provider accepts this hint, these messages must have the timestamp set to zero; if the provider ignores the hint, the timestamp must be set to its normal value.
    Message timestamps are enabled by default.
    
    Parameters:
    
    value - indicates if message timestamps are disabled
    
    Throws:
    
    JMSException - if the JMS provider fails to set timestamps to disabled due to some internal error.
  - getDisableMessageTimestamp
```
boolean getDisableMessageTimestamp()
                            throws JMSException
```
    Gets an indication of whether message timestamps are disabled.
    
    Returns:
    
    an indication of whether message timestamps are disabled
    
    Throws:
    
    JMSException - if the JMS provider fails to determine if timestamps are disabled due to some internal error.
  - setDeliveryMode
```
void setDeliveryMode(int deliveryMode)
              throws JMSException
```
    Sets the producer's default delivery mode.
    Delivery mode is set to PERSISTENT by default.
    
    Parameters:
    
    deliveryMode - the message delivery mode for this message producer; legal values are DeliveryMode.NON_PERSISTENT and DeliveryMode.PERSISTENT
    
    Throws:
    
    JMSException - if the JMS provider fails to set the delivery mode due to some internal error.
    
    See Also:
    
    getDeliveryMode(), DeliveryMode.NON_PERSISTENT, DeliveryMode.PERSISTENT, Message.DEFAULT_DELIVERY_MODE
  - getDeliveryMode
```
int getDeliveryMode()
             throws JMSException
```
    Gets the producer's default delivery mode.
    
    Returns:
    
    the message delivery mode for this message producer
    
    Throws:
    
    JMSException - if the JMS provider fails to get the delivery mode due to some internal error.
    
    See Also:
    
    setDeliveryMode(int)
  - setPriority
```
void setPriority(int defaultPriority)
          throws JMSException
```
    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.
    
    Parameters:
    
    defaultPriority - the message priority for this message producer; must be a value between 0 and 9
    
    Throws:
    
    JMSException - if the JMS provider fails to set the priority due to some internal error.
    
    See Also:
    
    getPriority(), Message.DEFAULT_PRIORITY
  - getPriority
```
int getPriority()
         throws JMSException
```
    Gets the producer's default priority.
    
    Returns:
    
    the message priority for this message producer
    
    Throws:
    
    JMSException - if the JMS provider fails to get the priority due to some internal error.
    
    See Also:
    
    setPriority(int)
  - setTimeToLive
```
void setTimeToLive(long timeToLive)
            throws JMSException
```
    Sets the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system.
    Time to live is set to zero by default.
    
    Parameters:
    
    timeToLive - the message time to live in milliseconds; zero is unlimited
    
    Throws:
    
    JMSException - if the JMS provider fails to set the time to live due to some internal error.
    
    Since:
    
    4.6.1 SolOS-TR
    
    See Also:
    
    getTimeToLive(), Message.DEFAULT_TIME_TO_LIVE
  - getTimeToLive
```
long getTimeToLive()
            throws JMSException
```
    Gets the default length of time in milliseconds from its dispatch time that a produced message should be retained by the message system.
    
    Returns:
    
    the message time to live in milliseconds; zero is unlimited
    
    Throws:
    
    JMSException - if the JMS provider fails to get the time to live due to some internal error.
    
    Since:
    
    4.6.1 SolOS-TR
    
    See Also:
    
    setTimeToLive(long)
  - getDestination
```
Destination getDestination()
                    throws JMSException
```
    Gets the destination associated with this MessageProducer.
    
    Returns:
    
    this producer's Destination
    
    Throws:
    
    JMSException - if the JMS provider fails to get the destination for this MessageProducer due to some internal error.
    
    Since:
    
    1.1
  - close
```
void close()
    throws JMSException
```
    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.
    
    Throws:
    
    JMSException - if the JMS provider fails to close the producer due to some internal error.
  - send
```
void send(Message message)
   throws JMSException
```
    Sends a message using the MessageProducer's default delivery mode, priority, and time to live.
    When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.
    
    Parameters:
    
    message - the message to send
    
    Throws:
    
    JMSException - if the JMS provider fails to send the message due to some internal error.
    
    MessageFormatException - if an invalid message is specified.
    
    InvalidDestinationException - if a client uses this method with a MessageProducer with an invalid destination.
    
    UnsupportedOperationException - if a client uses this method with a MessageProducer that did not specify a destination at creation time.
    
    Since:
    
    1.1
    
    See Also:
    
    Session.createProducer(javax.jms.Destination), MessageProducer
  - send
```
void send(Message message,
          int deliveryMode,
          int priority,
          long timeToLive)
   throws JMSException
```
    Sends a message to the destination, specifying delivery mode, priority, and time to live.
    When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.
    
    Parameters:
    
    message - the message to send
    
    deliveryMode - the delivery mode to use
    
    priority - the priority for this message
    
    timeToLive - the message's lifetime (in milliseconds) Supported since 4.6.1 SolOS-TR.
    
    Throws:
    
    JMSException - if the JMS provider fails to send the message due to some internal error.
    
    MessageFormatException - if an invalid message is specified.
    
    InvalidDestinationException - if a client uses this method with a MessageProducer with an invalid destination.
    
    UnsupportedOperationException - if a client uses this method with a MessageProducer that did not specify a destination at creation time.
    
    Since:
    
    1.1
    
    See Also:
    
    Session.createProducer(javax.jms.Destination)
  - send
```
void send(Destination destination,
          Message message)
   throws JMSException
```
    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.
    When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.
    
    Parameters:
    
    destination - the destination to send this message to
    
    message - the message to send
    
    Throws:
    
    JMSException - if the JMS provider fails to send the message due to some internal error.
    
    MessageFormatException - if an invalid message is specified.
    
    InvalidDestinationException - if a client uses this method with an invalid destination.
    
    UnsupportedOperationException - if a client uses this method with a MessageProducer that specified a destination at creation time.
    
    Since:
    
    1.1
    
    See Also:
    
    Session.createProducer(javax.jms.Destination), MessageProducer
  - send
```
void send(Destination destination,
          Message message,
          int deliveryMode,
          int priority,
          long timeToLive)
   throws JMSException
```
    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.
    When sending non-persistent messages, notifications of quota, permission, or endpoint problems will occur by sending an exception asynchronously through the Connection's ExceptionListener. In this case the send API will return without error but the message will not have been accepted. When sending persistent messages, the send API will always throw an exception when messages are not accepted.
    
    Parameters:
    
    destination - the destination to send this message to
    
    message - the message to send
    
    deliveryMode - the delivery mode to use
    
    priority - the priority for this message
    
    timeToLive - the message's lifetime (in milliseconds) Supported since 4.6.1 SolOS-TR.
    
    Throws:
    
    JMSException - if the JMS provider fails to send the message due to some internal error.
    
    MessageFormatException - if an invalid message is specified.
    
    InvalidDestinationException - if a client uses this method with an invalid destination.
    
    Since:
    
    1.1
    
    See Also:
    
    Session.createProducer(javax.jms.Destination)

Interface MessageProducer

Method Summary

Method Detail

setDisableMessageID

getDisableMessageID

setDisableMessageTimestamp

getDisableMessageTimestamp

setDeliveryMode

getDeliveryMode

setPriority

getPriority

setTimeToLive

getTimeToLive

getDestination

close

send

send

send

send