Class AsyncRabbitTemplate

java.lang.Object
org.springframework.amqp.rabbit.AsyncRabbitTemplate
All Implemented Interfaces:
AsyncAmqpTemplate, MessageListener, RabbitTemplate.ConfirmCallback, RabbitTemplate.ReturnsCallback, ChannelAwareMessageListener, Aware, BeanNameAware, Lifecycle, Phased, SmartLifecycle

Provides asynchronous send and receive operations returning a CompletableFuture 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 CompletableFuture. 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 an AbstractMessageListenerContainer either provided or constructed internally (a SimpleMessageListenerContainer). 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
Author:
Gary Russell, Artem Bilan, FengYang Su, Ngoc Nhan
  • Field Details

    • DEFAULT_RECEIVE_TIMEOUT

      public static final int DEFAULT_RECEIVE_TIMEOUT
      See Also:
  • Constructor Details

    • AsyncRabbitTemplate

      public AsyncRabbitTemplate(ConnectionFactory connectionFactory, String exchange, String routingKey, 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, String exchange, String routingKey, String replyQueue, 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, AbstractMessageListenerContainer 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 AbstractMessageListenerContainer.
    • AsyncRabbitTemplate

      public AsyncRabbitTemplate(RabbitTemplate template, AbstractMessageListenerContainer container, 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 AbstractMessageListenerContainer.
      replyAddress - the reply address.
    • AsyncRabbitTemplate

      public AsyncRabbitTemplate(ConnectionFactory connectionFactory, String exchange, String routingKey)
      Construct an instance using the provided arguments. "Direct replyTo" is used for replies.
      Parameters:
      connectionFactory - the connection factory.
      exchange - the default exchange to which requests will be sent.
      routingKey - the default routing key.
      Since:
      2.0
    • AsyncRabbitTemplate

      public AsyncRabbitTemplate(RabbitTemplate template)
      Construct an instance using the provided arguments. "Direct replyTo" is used for replies.
      Parameters:
      template - a RabbitTemplate
      Since:
      2.0
  • Method Details

    • setAutoStartup

      public void setAutoStartup(boolean autoStartup)
      Parameters:
      autoStartup - true for auto start.
      See Also:
    • setPhase

      public void setPhase(int phase)
      Parameters:
      phase - the phase.
      See Also:
    • 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.
    • setMandatoryExpression

      public void setMandatoryExpression(Expression mandatoryExpression)
      Parameters:
      mandatoryExpression - a SpEL Expression to evaluate against each request message. The result of the evaluation must be a boolean value.
      Since:
      2.0
    • setMandatoryExpressionString

      public void setMandatoryExpressionString(String mandatoryExpression)
      Parameters:
      mandatoryExpression - a SpEL Expression to evaluate against each request message. The result of the evaluation must be a boolean value.
      Since:
      2.0
    • setEnableConfirms

      public void setEnableConfirms(boolean enableConfirms)
      Set to true to enable publisher confirms. When enabled, the RabbitFuture returned by the send and receive operation will have a CompletableFuture<Boolean> in its confirm property.
      Parameters:
      enableConfirms - true to enable publisher confirms.
    • getBeanName

      public String getBeanName()
    • setBeanName

      public void setBeanName(String beanName)
      Specified by:
      setBeanName in interface 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(TaskScheduler taskScheduler)
      Set the task scheduler to expire timed out futures.
      Parameters:
      taskScheduler - the task scheduler
      See Also:
    • getMessageConverter

      public MessageConverter getMessageConverter()
      Returns:
      a reference to the underlying RabbitTemplate's MessageConverter.
    • getRabbitTemplate

      public RabbitTemplate getRabbitTemplate()
      Return the underlying RabbitTemplate used for sending.
      Returns:
      the template.
      Since:
      2.2
    • sendAndReceive

      public RabbitMessageFuture sendAndReceive(Message message)
      Description copied from interface: AsyncAmqpTemplate
      Send a message to the default exchange with the default routing key. If the message contains a correlationId property, it must be unique.
      Specified by:
      sendAndReceive in interface AsyncAmqpTemplate
      Parameters:
      message - the message.
      Returns:
      the CompletableFuture.
    • sendAndReceive

      public RabbitMessageFuture sendAndReceive(String routingKey, Message message)
      Description copied from interface: AsyncAmqpTemplate
      Send a message to the default exchange with the supplied routing key. If the message contains a correlationId property, it must be unique.
      Specified by:
      sendAndReceive in interface AsyncAmqpTemplate
      Parameters:
      routingKey - the routing key.
      message - the message.
      Returns:
      the CompletableFuture.
    • sendAndReceive

      public RabbitMessageFuture sendAndReceive(String exchange, String routingKey, Message message)
      Description copied from interface: AsyncAmqpTemplate
      Send a message to the supplied exchange and routing key. If the message contains a correlationId property, it must be unique.
      Specified by:
      sendAndReceive in interface AsyncAmqpTemplate
      Parameters:
      exchange - the exchange.
      routingKey - the routing key.
      message - the message.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(Object object)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the default exchange with the default routing key.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      object - the object to convert.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(String routingKey, Object object)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the default exchange with the provided routing key.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      routingKey - the routing key.
      object - the object to convert.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(String exchange, String routingKey, Object object)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the provided exchange and routing key.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      exchange - the exchange.
      routingKey - the routing key.
      object - the object to convert.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(Object object, MessagePostProcessor messagePostProcessor)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      object - the object to convert.
      messagePostProcessor - the post processor.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(String routingKey, Object object, MessagePostProcessor messagePostProcessor)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      routingKey - the routing key.
      object - the object to convert.
      messagePostProcessor - the post processor.
      Returns:
      the CompletableFuture.
    • convertSendAndReceive

      public <C> RabbitConverterFuture<C> convertSendAndReceive(String exchange, String routingKey, Object object, MessagePostProcessor messagePostProcessor)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceive in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      exchange - the exchange
      routingKey - the routing key.
      object - the object to convert.
      messagePostProcessor - the post processor.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(Object object, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the default exchange with the default routing key.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      object - the object to convert.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(String routingKey, Object object, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the default exchange with the provided routing key.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      routingKey - the routing key.
      object - the object to convert.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(String exchange, String routingKey, Object object, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      Convert the object to a message and send it to the provided exchange and routing key.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      exchange - the exchange.
      routingKey - the routing key.
      object - the object to convert.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(Object object, MessagePostProcessor messagePostProcessor, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      object - the object to convert.
      messagePostProcessor - the post processor.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(String routingKey, Object object, MessagePostProcessor messagePostProcessor, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      routingKey - the routing key.
      object - the object to convert.
      messagePostProcessor - the post processor.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • convertSendAndReceiveAsType

      public <C> RabbitConverterFuture<C> convertSendAndReceiveAsType(String exchange, String routingKey, Object object, MessagePostProcessor messagePostProcessor, ParameterizedTypeReference<C> responseType)
      Description copied from interface: AsyncAmqpTemplate
      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.
      Specified by:
      convertSendAndReceiveAsType in interface AsyncAmqpTemplate
      Type Parameters:
      C - the expected result type.
      Parameters:
      exchange - the exchange
      routingKey - the routing key.
      object - the object to convert.
      messagePostProcessor - the post processor.
      responseType - the response type.
      Returns:
      the CompletableFuture.
    • start

      public void start()
      Specified by:
      start in interface Lifecycle
    • stop

      public void stop()
      Specified by:
      stop in interface Lifecycle
    • isRunning

      public boolean isRunning()
      Specified by:
      isRunning in interface Lifecycle
    • getPhase

      public int getPhase()
      Specified by:
      getPhase in interface Phased
      Specified by:
      getPhase in interface SmartLifecycle
    • isAutoStartup

      public boolean isAutoStartup()
      Specified by:
      isAutoStartup in interface SmartLifecycle
    • onMessage

      public void onMessage(Message message, com.rabbitmq.client.Channel channel)
      Description copied from interface: ChannelAwareMessageListener
      Callback for processing a received Rabbit message.

      Implementors are supposed to process the given Message, typically sending reply messages through the given Session.

      Specified by:
      onMessage in interface ChannelAwareMessageListener
      Parameters:
      message - the received AMQP message (never null)
      channel - the underlying Rabbit Channel (never null unless called by the stream listener container).
    • returnedMessage

      public void returnedMessage(ReturnedMessage returned)
      Description copied from interface: RabbitTemplate.ReturnsCallback
      Returned message callback.
      Specified by:
      returnedMessage in interface RabbitTemplate.ReturnsCallback
      Parameters:
      returned - the returned message and metadata.
    • confirm

      public void confirm(@NonNull CorrelationData correlationData, boolean ack, @Nullable 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 String toString()
      Overrides:
      toString in class Object