org.springframework.messaging

Interface MessageHandler

All Known Implementing Classes:

AnnotationMethodMessageHandler, SimpleBrokerMessageHandler, StompBrokerRelayMessageHandler, StompWebSocketHandler, UserDestinationMessageHandler

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

public interface MessageHandler

Base interface for any component that handles Messages.

Since:

4.0

Author:

Mark Fisher, Iwein Fuld

Method Summary

Modifier and Type	Method and Description
void	handleMessage(Message<?> message) Handles the message if possible.

Method Detail

handleMessage

void handleMessage(Message<?> message)
                   throws MessagingException

Handles the message if possible. If the handler cannot deal with the message this will result in a MessageRejectedException e.g. in case of a Selective Consumer. When a consumer tries to handle a message, but fails to do so, a MessageHandlingException is thrown. In the last case it is recommended to treat the message as tainted and go into an error scenario.

When the handling results in a failure of another message being sent (e.g. a "reply" message), that failure will trigger a MessageDeliveryException.

Parameters:

message - the message to be handled reply related to the handling of the message

Throws:

MessagingException