Package org.springframework.messaging.core

Interface DestinationResolvingMessageRequestReplyOperations<D>

Type Parameters:
D - the destination type
All Superinterfaces:
MessageRequestReplyOperations<D>
All Known Implementing Classes:
AbstractDestinationResolvingMessagingTemplate, GenericMessagingTemplate
public interface DestinationResolvingMessageRequestReplyOperations<D> extends MessageRequestReplyOperations<D>
Extends MessageRequestReplyOperations and adds operations for sending and receiving messages to and from a destination specified as a (resolvable) String name.
Since:
4.0
Author:
Mark Fisher, Rossen Stoyanchev
See Also:

  • Method Details

    • sendAndReceive

      @Nullable Message<?> sendAndReceive(String destinationName, Message<?> requestMessage) throws MessagingException
      Resolve the given destination name to a destination and send the given message, receive a reply and return it.
      Parameters:
      destinationName - the name of the target destination
      requestMessage - the message to send
      Returns:
      the received message, possibly null if the message could not be received, for example due to a timeout
      Throws:
      MessagingException

    • convertSendAndReceive

      @Nullable <T> T convertSendAndReceive(String destinationName, Object request, Class<T> targetClass) throws MessagingException
      Resolve the given destination name, convert the payload request Object to serialized form, possibly using a MessageConverter, wrap it as a message and send it to the resolved destination, receive a reply and convert its body to the specified target class.
      Parameters:
      destinationName - the name of the target destination
      request - the payload for the request message to send
      targetClass - the target class to convert the payload of the reply to
      Returns:
      the converted payload of the reply message, possibly null if the message could not be received, for example due to a timeout
      Throws:
      MessagingException

    • convertSendAndReceive

      @Nullable <T> T convertSendAndReceive(String destinationName, Object request, @Nullable Map<String,Object> headers, Class<T> targetClass) throws MessagingException
      Resolve the given destination name, convert the payload request Object to serialized form, possibly using a MessageConverter, wrap it as a message with the given headers and send it to the resolved destination, receive a reply and convert its body to the specified target class.
      Parameters:
      destinationName - the name of the target destination
      request - the payload for the request message to send
      headers - the headers for the request message to send
      targetClass - the target class to convert the payload of the reply to
      Returns:
      the converted payload of the reply message, possibly null if the message could not be received, for example due to a timeout
      Throws:
      MessagingException

    • convertSendAndReceive

      @Nullable <T> T convertSendAndReceive(String destinationName, Object request, Class<T> targetClass, @Nullable MessagePostProcessor requestPostProcessor) throws MessagingException
      Resolve the given destination name, convert the payload request Object to serialized form, possibly using a MessageConverter, wrap it as a message, apply the given post-process, and send the resulting message to the resolved destination, then receive a reply and convert its body to the specified target class.
      Parameters:
      destinationName - the name of the target destination
      request - the payload for the request message to send
      targetClass - the target class to convert the payload of the reply to
      requestPostProcessor - post-process for the request message
      Returns:
      the converted payload of the reply message, possibly null if the message could not be received, for example due to a timeout
      Throws:
      MessagingException

    • convertSendAndReceive

      @Nullable <T> T convertSendAndReceive(String destinationName, Object request, @Nullable Map<String,Object> headers, Class<T> targetClass, @Nullable MessagePostProcessor requestPostProcessor) throws MessagingException
      Resolve the given destination name, convert the payload request Object to serialized form, possibly using a MessageConverter, wrap it as a message with the given headers, apply the given post-process, and send the resulting message to the resolved destination, then receive a reply and convert its body to the specified target class.
      Parameters:
      destinationName - the name of the target destination
      request - the payload for the request message to send
      headers - the headers for the request message to send
      targetClass - the target class to convert the payload of the reply to
      requestPostProcessor - post-process for the request message
      Returns:
      the converted payload of the reply message, possibly null if the message could not be received, for example due to a timeout
      Throws:
      MessagingException