- java.lang.Object
-
- javax.jms.TopicRequestor
-
public class TopicRequestor extends Object
TheTopicRequestor
helper class simplifies making service requests.The
TopicRequestor
constructor is given a non-transactedTopicSession
and a destinationTopic
. It creates aTemporaryTopic
for the responses and provides arequest
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
- Version:
- JMS 2.0
- See Also:
QueueRequestor
-
-
Constructor Summary
Constructors Constructor and Description TopicRequestor(TopicSession session, Topic topic)
Constructor for theTopicRequestor
class.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description void
close()
Closes theTopicRequestor
and its session.Message
request(Message message)
Sends a request and waits for a reply.
-
-
-
Constructor Detail
-
TopicRequestor
public TopicRequestor(TopicSession session, Topic topic) throws JMSException
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 Detail
-
request
public Message request(Message message) throws JMSException
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
public void close() throws JMSException
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.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 17:21:52 Cette version de la page est en cache (à la date du 21/08/2025 17:21:52) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 14/04/2008, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/jms/TopicRequestor.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.