Package com.webmethods.jms

Interface WmTopicPublisher

All Superinterfaces:

javax.jms.MessageProducer, javax.jms.TopicPublisher, WmMessageProducer

All Known Implementing Classes:

WmClusterMultiSendTopicPublisherImpl, WmClusterTopicPublisherImpl, WmTopicPublisherImpl

public interface WmTopicPublisher
extends WmMessageProducer, javax.jms.TopicPublisher

Interface defining webMethods extensions to javax.jms.TopicPublisher.

Method Summary

Modifier and Type	Method	Description
void	publish(javax.jms.Message[] messages)	Publishes multiple messages to the topic.
void	publish(javax.jms.Message[] messages, int deliveryMode, int priority, long timeToLive)	Publishes multiple messages to the topic, specifying delivery mode, priority, and time to live.
void	publish(javax.jms.Topic topic, javax.jms.Message[] messages)	Publishes multiple messages to a topic for an unidentified message producer.
void	publish(javax.jms.Topic topic, javax.jms.Message[] messages, int deliveryMode, int priority, long timeToLive)	Publishes multiple messages to a topic for an unidentified message producer, specifying delivery mode, priority and time to live.

Methods inherited from interface javax.jms.MessageProducer

close, getDeliveryMode, getDestination, getDisableMessageID, getDisableMessageTimestamp, getPriority, getTimeToLive, send, send, send, send, setDeliveryMode, setDisableMessageID, setDisableMessageTimestamp, setPriority, setTimeToLive

Methods inherited from interface javax.jms.TopicPublisher

getTopic, publish, publish, publish, publish

Methods inherited from interface com.webmethods.jms.WmMessageProducer

getCompressionLevel, getCompressionThreshold, getOutputStream, getOutputStream, send, send, send, send, setCompressionLevel, setCompressionThreshold

Method Detail

publish

void publish(javax.jms.Message[] messages)
      throws javax.jms.JMSException

Publishes multiple messages to the topic. Uses the TopicPublisher's default delivery mode, priority, and time to live.

Parameters:

messages - the messages to publish

Throws:

javax.jms.JMSException - if the JMS provider fails to publish the message due to some internal error.

javax.jms.MessageFormatException - if an invalid message is specified.

javax.jms.InvalidDestinationException - if a client uses this method with a TopicPublisher with an invalid topic.

java.lang.UnsupportedOperationException - if a client uses this method with a TopicPublisher that did not specify a topic at creation time.

See Also:

MessageProducer.getDeliveryMode(), MessageProducer.getTimeToLive(), MessageProducer.getPriority()

publish

void publish(javax.jms.Message[] messages,
             int deliveryMode,
             int priority,
             long timeToLive)
      throws javax.jms.JMSException

Publishes multiple messages to the topic, specifying delivery mode, priority, and time to live.

Parameters:

messages - the messages to publish

deliveryMode - the delivery mode to use

priority - the priority for this message

timeToLive - the message's lifetime (in milliseconds)

Throws:

javax.jms.JMSException - if the JMS provider fails to publish the message due to some internal error.

javax.jms.MessageFormatException - if an invalid message is specified.

javax.jms.InvalidDestinationException - if a client uses this method with a TopicPublisher with an invalid topic.

java.lang.UnsupportedOperationException - if a client uses this method with a TopicPublisher that did not specify a topic at creation time.

publish

void publish(javax.jms.Topic topic,
             javax.jms.Message[] messages)
      throws javax.jms.JMSException

Publishes multiple messages to a topic for an unidentified message producer. Uses the TopicPublisher's default delivery mode, priority, and time to live.

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

Parameters:

topic - the topic to publish the messages to

messages - the messages to publish

Throws:

javax.jms.JMSException - if the JMS provider fails to publish the message due to some internal error.

javax.jms.MessageFormatException - if an invalid message is specified.

javax.jms.InvalidDestinationException - if a client uses this method with an invalid topic.

See Also:

MessageProducer.getDeliveryMode(), MessageProducer.getTimeToLive(), MessageProducer.getPriority()

publish

void publish(javax.jms.Topic topic,
             javax.jms.Message[] messages,
             int deliveryMode,
             int priority,
             long timeToLive)
      throws javax.jms.JMSException

Publishes multiple messages to a topic for an unidentified message producer, specifying delivery mode, priority and time to live.

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

Parameters:

topic - the topic to publish the messages to

messages - the messages to publish

deliveryMode - the delivery mode to use

priority - the priority for this message

timeToLive - the message's lifetime (in milliseconds)

Throws:

javax.jms.JMSException - if the JMS provider fails to publish the message due to some internal error.

javax.jms.MessageFormatException - if an invalid message is specified.

javax.jms.InvalidDestinationException - if a client uses this method with an invalid topic.