org.springframework.messaging.simp.broker

Class SimpleBrokerMessageHandler

java.lang.Object

org.springframework.messaging.simp.broker.AbstractBrokerMessageHandler

org.springframework.messaging.simp.broker.SimpleBrokerMessageHandler

All Implemented Interfaces:

Aware, ApplicationEventPublisherAware, Lifecycle, Phased, SmartLifecycle, MessageHandler

public class SimpleBrokerMessageHandler
extends AbstractBrokerMessageHandler

A "simple" message broker that recognizes the message types defined in SimpMessageType, keeps track of subscriptions with the help of a SubscriptionRegistry and sends messages to subscribers.

Since:

4.0

Author:

Rossen Stoyanchev

Field Summary

Fields inherited from class org.springframework.messaging.simp.broker.AbstractBrokerMessageHandler

logger

Constructor Summary

Constructors

Constructor and Description
SimpleBrokerMessageHandler(SubscribableChannel clientInboundChannel, MessageChannel clientOutboundChannel, SubscribableChannel brokerChannel, Collection<String> destinationPrefixes) Create a SimpleBrokerMessageHandler instance with the given message channels and destination prefixes.

Method Summary

Modifier and Type	Method and Description
MessageHeaderInitializer	getHeaderInitializer() Return the configured header initializer.
SubscriptionRegistry	getSubscriptionRegistry()
protected void	handleMessageInternal(Message<?> message)
protected void	sendMessageToSubscribers(String destination, Message<?> message)
void	setHeaderInitializer(MessageHeaderInitializer headerInitializer) Configure a MessageHeaderInitializer to apply to the headers of all messages sent to the client outbound channel.
void	setPathMatcher(PathMatcher pathMatcher) When configured, the given PathMatcher is passed down to the SubscriptionRegistry to use for matching destination to subscriptions.
void	setSubscriptionRegistry(SubscriptionRegistry subscriptionRegistry) Configure a custom SubscriptionRegistry to use for storing subscriptions.
void	startInternal()
void	stopInternal()
String	toString()

Methods inherited from class org.springframework.messaging.simp.broker.AbstractBrokerMessageHandler

checkDestinationPrefix, getApplicationEventPublisher, getBrokerChannel, getClientInboundChannel, getClientOutboundChannel, getDestinationPrefixes, getPhase, handleMessage, isAutoStartup, isBrokerAvailable, isRunning, publishBrokerAvailableEvent, publishBrokerUnavailableEvent, setApplicationEventPublisher, setAutoStartup, start, stop, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleBrokerMessageHandler

public SimpleBrokerMessageHandler(SubscribableChannel clientInboundChannel,
                                  MessageChannel clientOutboundChannel,
                                  SubscribableChannel brokerChannel,
                                  Collection<String> destinationPrefixes)

Create a SimpleBrokerMessageHandler instance with the given message channels and destination prefixes.

Parameters:

clientInboundChannel - the channel for receiving messages from clients (e.g. WebSocket clients)

clientOutboundChannel - the channel for sending messages to clients (e.g. WebSocket clients)

brokerChannel - the channel for the application to send messages to the broker

destinationPrefixes - prefixes to use to filter out messages

Method Detail

setSubscriptionRegistry

public void setSubscriptionRegistry(SubscriptionRegistry subscriptionRegistry)

Configure a custom SubscriptionRegistry to use for storing subscriptions.

Note that when a custom PathMatcher is configured via setPathMatcher(org.springframework.util.PathMatcher), if the custom registry is not an instance of DefaultSubscriptionRegistry, the provided PathMatcher is not used and must be configured directly on the custom registry.

getSubscriptionRegistry

public SubscriptionRegistry getSubscriptionRegistry()

setPathMatcher

public void setPathMatcher(PathMatcher pathMatcher)

When configured, the given PathMatcher is passed down to the SubscriptionRegistry to use for matching destination to subscriptions.

setHeaderInitializer

public void setHeaderInitializer(MessageHeaderInitializer headerInitializer)

Configure a MessageHeaderInitializer to apply to the headers of all messages sent to the client outbound channel.

By default this property is not set.

getHeaderInitializer

public MessageHeaderInitializer getHeaderInitializer()

Return the configured header initializer.

startInternal

public void startInternal()

Overrides:

startInternal in class AbstractBrokerMessageHandler

stopInternal

public void stopInternal()

Overrides:

stopInternal in class AbstractBrokerMessageHandler

handleMessageInternal

protected void handleMessageInternal(Message<?> message)

Specified by:

handleMessageInternal in class AbstractBrokerMessageHandler

sendMessageToSubscribers

protected void sendMessageToSubscribers(String destination,
                                        Message<?> message)

toString

public String toString()

Overrides:

toString in class Object