Class TopicRequestor
TopicRequestor
helper class simplifies
making service requests.
The TopicRequestor
constructor is given a non-transacted
TopicSession
and a destination Topic
. It creates a
TemporaryTopic
for the responses and provides a
request
method that sends the request message and waits
for its reply.
This is a very basic request/reply abstraction which assumes the session is non-transacted with a delivery mode of either AUTO_ACKNOWLEDGE or DUPS_OK_ACKNOWLEDGE. It is expected that most applications will create less basic implementations.
- Since:
- JMS 1.0
- See Also:
-
Constructor Summary
ConstructorDescriptionTopicRequestor
(TopicSession session, Topic topic) Constructor for theTopicRequestor
class. -
Method Summary
-
Constructor Details
-
TopicRequestor
Constructor for theTopicRequestor
class.This implementation assumes the session parameter to be non-transacted, with a delivery mode of either
AUTO_ACKNOWLEDGE
orDUPS_OK_ACKNOWLEDGE
.- Parameters:
session
- theTopicSession
the topic belongs totopic
- the topic to perform the request/reply call on- Throws:
JMSException
- if the JMS provider fails to create theTopicRequestor
due to some internal error.InvalidDestinationException
- if an invalid topic is specified.
-
-
Method Details
-
request
Sends a request and waits for a reply. The temporary topic is used for theJMSReplyTo
destination; the first reply is returned, and any following replies are discarded.- Parameters:
message
- the message to send- Returns:
- the reply message
- Throws:
JMSException
- if the JMS provider fails to complete the request due to some internal error.
-
close
Closes theTopicRequestor
and its session.Since a provider may allocate some resources on behalf of a
TopicRequestor
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.Note that this method closes the
TopicSession
object passed to theTopicRequestor
constructor.- Throws:
JMSException
- if the JMS provider fails to close theTopicRequestor
due to some internal error.
-