org.springframework.amqp.rabbit

Class AsyncRabbitTemplate

java.lang.Object

org.springframework.amqp.rabbit.AsyncRabbitTemplate

All Implemented Interfaces:

org.springframework.amqp.core.MessageListener, RabbitTemplate.ConfirmCallback, RabbitTemplate.ReturnCallback, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanNameAware, org.springframework.context.Lifecycle, org.springframework.context.Phased, org.springframework.context.SmartLifecycle

public class AsyncRabbitTemplate
extends java.lang.Object
implements org.springframework.context.SmartLifecycle, org.springframework.amqp.core.MessageListener, RabbitTemplate.ReturnCallback, RabbitTemplate.ConfirmCallback, org.springframework.beans.factory.BeanNameAware

Provides asynchronous send and receive operations returning a ListenableFuture allowing the caller to obtain the reply later, using get() or a callback.

When confirms are enabled, the future has a confirm property which is itself a ListenableFuture. If the reply is received before the publisher confirm, the confirm is discarded since the reply implicitly indicates the message was published.

Returned (undeliverable) request messages are presented as a AmqpMessageReturnedException cause of an ExecutionException.

Internally, the template uses a RabbitTemplate and a SimpleMessageListenerContainer either provided or constructed internally. If an external RabbitTemplate is provided and confirms/returns are enabled, it must not previously have had callbacks registered because this object needs to be the callback.

Since:

1.6

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	AsyncRabbitTemplate.RabbitConverterFuture<C> A AsyncRabbitTemplate.RabbitFuture with a return type of the template's generic parameter.
class	AsyncRabbitTemplate.RabbitFuture<T> Base class for ListenableFutures returned by AsyncRabbitTemplate.
class	AsyncRabbitTemplate.RabbitMessageFuture A AsyncRabbitTemplate.RabbitFuture with a return type of Message.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_RECEIVE_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
AsyncRabbitTemplate(ConnectionFactory connectionFactory, java.lang.String exchange, java.lang.String routingKey, java.lang.String replyQueue) Construct an instance using the provided arguments.
AsyncRabbitTemplate(ConnectionFactory connectionFactory, java.lang.String exchange, java.lang.String routingKey, java.lang.String replyQueue, java.lang.String replyAddress) Construct an instance using the provided arguments.
AsyncRabbitTemplate(RabbitTemplate template, SimpleMessageListenerContainer container) Construct an instance using the provided arguments.
AsyncRabbitTemplate(RabbitTemplate template, SimpleMessageListenerContainer container, java.lang.String replyAddress) Construct an instance using the provided arguments.

Method Summary

Modifier and Type	Method and Description
void	confirm(CorrelationData correlationData, boolean ack, java.lang.String cause) Confirmation callback.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.Object message) Convert the object to a message and send it to the default exchange with the default routing key.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.Object message, org.springframework.amqp.core.MessagePostProcessor messagePostProcessor) Convert the object to a message and send it to the default exchange with the default routing key after invoking the MessagePostProcessor.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.String routingKey, java.lang.Object message) Convert the object to a message and send it to the default exchange with the provided routing key.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.String routingKey, java.lang.Object message, org.springframework.amqp.core.MessagePostProcessor messagePostProcessor) Convert the object to a message and send it to the default exchange with the provided routing key after invoking the MessagePostProcessor.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.String exchange, java.lang.String routingKey, java.lang.Object message) Convert the object to a message and send it to the provided exchange and routing key.
<C> AsyncRabbitTemplate.RabbitConverterFuture<C>	convertSendAndReceive(java.lang.String exchange, java.lang.String routingKey, java.lang.Object message, org.springframework.amqp.core.MessagePostProcessor messagePostProcessor) Convert the object to a message and send it to the provided exchange and routing key after invoking the MessagePostProcessor.
java.lang.String	getBeanName()
ConnectionFactory	getConnectionFactory()
org.springframework.amqp.support.converter.MessageConverter	getMessageConverter()
int	getPhase()
boolean	isAutoStartup()
boolean	isRunning()
void	onMessage(org.springframework.amqp.core.Message message)
void	returnedMessage(org.springframework.amqp.core.Message message, int replyCode, java.lang.String replyText, java.lang.String exchange, java.lang.String routingKey) Returned message callback.
AsyncRabbitTemplate.RabbitMessageFuture	sendAndReceive(org.springframework.amqp.core.Message message) Send a message to the default exchange with the default routing key.
AsyncRabbitTemplate.RabbitMessageFuture	sendAndReceive(java.lang.String routingKey, org.springframework.amqp.core.Message message) Send a message to the default exchange with the supplied routing key.
AsyncRabbitTemplate.RabbitMessageFuture	sendAndReceive(java.lang.String exchange, java.lang.String routingKey, org.springframework.amqp.core.Message message) Send a message to the supplied exchange and routing key.
void	setAutoStartup(boolean autoStartup)
void	setBeanName(java.lang.String beanName)
void	setCharset(java.nio.charset.Charset charset) Deprecated. - will be removed in 2.0 when byte[] correlation id is removed
void	setEnableConfirms(boolean enableConfirms) Set to true to enable publisher confirms.
void	setMandatory(boolean mandatory) Set to true to enable the receipt of returned messages that cannot be delivered in the form of a AmqpMessageReturnedException.
void	setPhase(int phase)
void	setReceiveTimeout(long receiveTimeout) Set the receive timeout - the future returned by the send and receive methods will be canceled when this timeout expires.
void	setTaskScheduler(org.springframework.scheduling.TaskScheduler taskScheduler) Set the task scheduler to expire timed out futures.
void	start()
void	stop()
void	stop(java.lang.Runnable callback)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_RECEIVE_TIMEOUT

public static final int DEFAULT_RECEIVE_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

AsyncRabbitTemplate

public AsyncRabbitTemplate(ConnectionFactory connectionFactory,
                           java.lang.String exchange,
                           java.lang.String routingKey,
                           java.lang.String replyQueue)

Construct an instance using the provided arguments. Replies will be routed to the default exchange using the reply queue name as the routing key.

Parameters:

connectionFactory - the connection factory.

exchange - the default exchange to which requests will be sent.

routingKey - the default routing key.

replyQueue - the name of the reply queue to listen for replies.

AsyncRabbitTemplate

public AsyncRabbitTemplate(ConnectionFactory connectionFactory,
                           java.lang.String exchange,
                           java.lang.String routingKey,
                           java.lang.String replyQueue,
                           java.lang.String replyAddress)

Construct an instance using the provided arguments. If 'replyAddress' is null, replies will be routed to the default exchange using the reply queue name as the routing key. Otherwise it should have the form exchange/routingKey and must cause messages to be routed to the reply queue.

Parameters:

connectionFactory - the connection factory.

exchange - the default exchange to which requests will be sent.

routingKey - the default routing key.

replyQueue - the name of the reply queue to listen for replies.

replyAddress - the reply address (exchange/routingKey).

AsyncRabbitTemplate

public AsyncRabbitTemplate(RabbitTemplate template,
                           SimpleMessageListenerContainer container)

Construct an instance using the provided arguments. The first queue the container is configured to listen to will be used as the reply queue. Replies will be routed using the default exchange with that queue name as the routing key.

Parameters:

template - a RabbitTemplate

container - a SimpleMessageListenerContainer.

AsyncRabbitTemplate

public AsyncRabbitTemplate(RabbitTemplate template,
                           SimpleMessageListenerContainer container,
                           java.lang.String replyAddress)

Construct an instance using the provided arguments. The first queue the container is configured to listen to will be used as the reply queue. If 'replyAddress' is null, replies will be routed using the default exchange with that queue name as the routing key. Otherwise it should have the form exchange/routingKey and must cause messages to be routed to the reply queue.

Parameters:

template - a RabbitTemplate.

container - a SimpleMessageListenerContainer.

replyAddress - the reply address.

Method Detail

setAutoStartup

public void setAutoStartup(boolean autoStartup)

Parameters:

autoStartup - true for auto start.

See Also:

isAutoStartup()

setPhase

public void setPhase(int phase)

Parameters:

phase - the phase.

See Also:

getPhase()

setMandatory

public void setMandatory(boolean mandatory)

Set to true to enable the receipt of returned messages that cannot be delivered in the form of a AmqpMessageReturnedException.

Parameters:

mandatory - true to enable returns.

setEnableConfirms

public void setEnableConfirms(boolean enableConfirms)

Set to true to enable publisher confirms. When enabled, the AsyncRabbitTemplate.RabbitFuture returned by the send and receive operation will have a ListenableFuture<Boolean> in its confirm property.

Parameters:

enableConfirms - true to enable publisher confirms.

setCharset

@Deprecated
public void setCharset(java.nio.charset.Charset charset)

Deprecated. - will be removed in 2.0 when byte[] correlation id is removed

Set the charset to be used when converting byte[] to/from String for correlation Ids. Default: UTF-8.

Parameters:

charset - the charset.

getBeanName

public java.lang.String getBeanName()

setBeanName

public void setBeanName(java.lang.String beanName)

Specified by:

setBeanName in interface org.springframework.beans.factory.BeanNameAware

getConnectionFactory

public ConnectionFactory getConnectionFactory()

Returns:

a reference to the underlying connection factory in the RabbitTemplate.

setReceiveTimeout

public void setReceiveTimeout(long receiveTimeout)

Set the receive timeout - the future returned by the send and receive methods will be canceled when this timeout expires. <= 0 means futures never expire. Beware that this will cause a memory leak if a reply is not received. Default: 30000 (30 seconds).

Parameters:

receiveTimeout - the timeout in milliseconds.

setTaskScheduler

public void setTaskScheduler(org.springframework.scheduling.TaskScheduler taskScheduler)

Set the task scheduler to expire timed out futures.

Parameters:

taskScheduler - the task scheduler

See Also:

setReceiveTimeout(long)

getMessageConverter

public org.springframework.amqp.support.converter.MessageConverter getMessageConverter()

Returns:

a reference to the underlying RabbitTemplate's MessageConverter.

sendAndReceive

public AsyncRabbitTemplate.RabbitMessageFuture sendAndReceive(org.springframework.amqp.core.Message message)

Send a message to the default exchange with the default routing key. If the message contains a correlationId property, it must be unique.

Parameters:

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitMessageFuture.

sendAndReceive

public AsyncRabbitTemplate.RabbitMessageFuture sendAndReceive(java.lang.String routingKey,
                                                              org.springframework.amqp.core.Message message)

Send a message to the default exchange with the supplied routing key. If the message contains a correlationId property, it must be unique.

Parameters:

routingKey - the routing key.

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitMessageFuture.

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.Object message)

Convert the object to a message and send it to the default exchange with the default routing key.

Type Parameters:

C - the expected result type.

Parameters:

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.String routingKey,
                                                                              java.lang.Object message)
                                                                       throws org.springframework.amqp.AmqpException

Convert the object to a message and send it to the default exchange with the provided routing key.

Type Parameters:

C - the expected result type.

Parameters:

routingKey - the routing key.

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

Throws:

org.springframework.amqp.AmqpException

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.String exchange,
                                                                              java.lang.String routingKey,
                                                                              java.lang.Object message)

Convert the object to a message and send it to the provided exchange and routing key.

Type Parameters:

C - the expected result type.

Parameters:

exchange - the exchange.

routingKey - the routing key.

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.Object message,
                                                                              org.springframework.amqp.core.MessagePostProcessor messagePostProcessor)

Convert the object to a message and send it to the default exchange with the default routing key after invoking the MessagePostProcessor. If the post processor adds a correlationId property, it must be unique.

Type Parameters:

C - the expected result type.

Parameters:

message - the message.

messagePostProcessor - the post processor.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.String routingKey,
                                                                              java.lang.Object message,
                                                                              org.springframework.amqp.core.MessagePostProcessor messagePostProcessor)

Convert the object to a message and send it to the default exchange with the provided routing key after invoking the MessagePostProcessor. If the post processor adds a correlationId property, it must be unique.

Type Parameters:

C - the expected result type.

Parameters:

routingKey - the routing key.

message - the message.

messagePostProcessor - the post processor.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

sendAndReceive

public AsyncRabbitTemplate.RabbitMessageFuture sendAndReceive(java.lang.String exchange,
                                                              java.lang.String routingKey,
                                                              org.springframework.amqp.core.Message message)

Send a message to the supplied exchange and routing key. If the message contains a correlationId property, it must be unique.

Parameters:

exchange - the exchange.

routingKey - the routing key.

message - the message.

Returns:

the AsyncRabbitTemplate.RabbitMessageFuture.

convertSendAndReceive

public <C> AsyncRabbitTemplate.RabbitConverterFuture<C> convertSendAndReceive(java.lang.String exchange,
                                                                              java.lang.String routingKey,
                                                                              java.lang.Object message,
                                                                              org.springframework.amqp.core.MessagePostProcessor messagePostProcessor)

Convert the object to a message and send it to the provided exchange and routing key after invoking the MessagePostProcessor. If the post processor adds a correlationId property, it must be unique.

Type Parameters:

C - the expected result type.

Parameters:

exchange - the exchange

routingKey - the routing key.

message - the message.

messagePostProcessor - the post processor.

Returns:

the AsyncRabbitTemplate.RabbitConverterFuture.

start

public void start()

Specified by:

start in interface org.springframework.context.Lifecycle

stop

public void stop()

Specified by:

stop in interface org.springframework.context.Lifecycle

isRunning

public boolean isRunning()

Specified by:

isRunning in interface org.springframework.context.Lifecycle

getPhase

public int getPhase()

Specified by:

getPhase in interface org.springframework.context.Phased

isAutoStartup

public boolean isAutoStartup()

Specified by:

isAutoStartup in interface org.springframework.context.SmartLifecycle

stop

public void stop(java.lang.Runnable callback)

Specified by:

stop in interface org.springframework.context.SmartLifecycle

onMessage

public void onMessage(org.springframework.amqp.core.Message message)

Specified by:

onMessage in interface org.springframework.amqp.core.MessageListener

returnedMessage

public void returnedMessage(org.springframework.amqp.core.Message message,
                            int replyCode,
                            java.lang.String replyText,
                            java.lang.String exchange,
                            java.lang.String routingKey)

Description copied from interface: RabbitTemplate.ReturnCallback

Returned message callback.

Specified by:

returnedMessage in interface RabbitTemplate.ReturnCallback

Parameters:

message - the returned message.

replyCode - the reply code.

replyText - the reply text.

exchange - the exchange.

routingKey - the routing key.

confirm

public void confirm(CorrelationData correlationData,
                    boolean ack,
                    java.lang.String cause)

Description copied from interface: RabbitTemplate.ConfirmCallback

Confirmation callback.

Specified by:

confirm in interface RabbitTemplate.ConfirmCallback

Parameters:

correlationData - correlation data for the callback.

ack - true for ack, false for nack

cause - An optional cause, for nack, when available, otherwise null.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object