com.solacesystems.jcsmp.impl.requestreply

Class RequestorImpl

java.lang.Object

com.solacesystems.jcsmp.impl.requestreply.RequestorImpl

All Implemented Interfaces:

Requestor

public class RequestorImpl
extends Object
implements Requestor

Constructor Summary

Constructors

Constructor and Description
RequestorImpl(JCSMPBasicSession session)

Method Summary

Modifier and Type	Method and Description
BytesXMLMessage	request(XMLMessage request, long timeoutMillis, Destination sendDestination) Performs a request to the specified destination.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RequestorImpl

public RequestorImpl(JCSMPBasicSession session)

Method Detail

request

public BytesXMLMessage request(XMLMessage request,
                               long timeoutMillis,
                               Destination sendDestination)
                        throws JCSMPException

Description copied from interface: Requestor

Performs a request to the specified destination.

If request has no ReplyTo destination or ReplyToSuffix set, the session's default ReplyTo destination is set on the message.

Blocking mode

The timeoutMillis parameter controls whether this call should operate in a blocking fashion.

If >0, the call blocks for up to the number of milliseconds specified by timeoutMillis while the Requestor waits for a reply. If none is received during this time, a JCSMPRequestTimeoutException is thrown.

If 0, the call returns null after the request message has been sent. The application should then examine incoming messages on a XMLMessageConsumer or its XMLMessageListener for a reply, which will be sent to the Destination specified in the request's ReplyTo header field. To correlate replies to sent requests, an application can use the CorrelationId field on outgoing requests.

Correlation IDs

Requestor uses CorrelationId values starting with '#' which are reserved for internal use such as two party request/reply. If other applications are required to receive the reply, specify an application CorrelationId.

Delivery Mode

The request message cannot be an Guaranteed delivery message ( DeliveryMode.PERSISTENT or DeliveryMode.NON_PERSISTENT).

Specified by:

request in interface Requestor

Parameters:

request - The request message to send.

timeoutMillis - The amount of time to allow for a reply to come in.

sendDestination - The Destination the request should be addressed to. Currently, Topics are supported.

Returns:

The reply message, if operating in blocking mode and a reply is received within the timeout period.

Throws:

JCSMPRequestTimeoutException - If a blocking request times out.

JCSMPException - If there is an error sending the request, or any other JCSMP error.