org.springframework.integration.router

Class AbstractMappingMessageRouter

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.handler.AbstractMessageHandler

org.springframework.integration.router.AbstractMessageRouter

org.springframework.integration.router.AbstractMappingMessageRouter

All Implemented Interfaces:

Aware, BeanFactoryAware, BeanNameAware, InitializingBean, ApplicationContextAware, Ordered, Orderable, TrackableComponent, MappingMessageRouterManagement, NamedComponent, MessageHandler

Direct Known Subclasses:

ErrorMessageExceptionTypeRouter, ExpressionEvaluatingRouter, HeaderValueRouter, MethodInvokingRouter, PayloadTypeRouter, XPathRouter

public abstract class AbstractMappingMessageRouter
extends AbstractMessageRouter
implements MappingMessageRouterManagement

Base class for all Message Routers that support mapping from arbitrary String values to Message Channel names.

Since:

2.1

Author:

Mark Fisher, Oleg Zhurakousky, Gunnar Hillert, Gary Russell

Field Summary

Fields inherited from class org.springframework.integration.context.IntegrationObjectSupport

logger

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Constructor and Description
AbstractMappingMessageRouter()

Method Summary

Methods

Modifier and Type	Method and Description
protected Collection<MessageChannel>	determineTargetChannels(Message<?> message) Subclasses must implement this method to return a Collection of zero or more MessageChannels to which the given Message should be routed.
protected abstract List<Object>	getChannelKeys(Message<?> message) Subclasses must implement this method to return the channel keys.
Map<String,String>	getChannelMappings() Returns an unmodifiable version of the channel mappings.
void	onInit() Subclasses may implement this for initialization logic.
void	removeChannelMapping(String key) Remove a channel mapping for the given key if present.
void	replaceChannelMappings(Properties channelMappings) Convenience method allowing conversion of a list of mappings in a control-bus message.
void	setChannelMapping(String key, String channelName) Add a channel mapping from the provided key to channel name.
void	setChannelMappings(Map<String,String> channelMappings) Provide mappings from channel keys to channel names.
void	setChannelResolver(DestinationResolver<MessageChannel> channelResolver) Specify the DestinationResolver strategy to use.
void	setPrefix(String prefix) Specify a prefix to be added to each channel name prior to resolution.
void	setResolutionRequired(boolean resolutionRequired) Specify whether this router should ignore any failure to resolve a channel name to an actual MessageChannel instance when delegating to the ChannelResolver strategy.
void	setSuffix(String suffix) Specify a suffix to be added to each channel name prior to resolution.

Methods inherited from class org.springframework.integration.router.AbstractMessageRouter

getComponentType, getMessagingTemplate, getRequiredConversionService, handleMessageInternal, setApplySequence, setDefaultOutputChannel, setDefaultOutputChannelName, setIgnoreSendFailures, setTimeout

Methods inherited from class org.springframework.integration.handler.AbstractMessageHandler

getOrder, handleMessage, setOrder, setShouldTrack

Methods inherited from class org.springframework.integration.context.IntegrationObjectSupport

afterPropertiesSet, getApplicationContextId, getBeanFactory, getComponentName, getConversionService, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, setApplicationContext, setBeanFactory, setBeanName, setComponentName, setConversionService, setMessageBuilderFactory, setTaskScheduler, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.integration.support.context.NamedComponent

getComponentName

Constructor Detail

AbstractMappingMessageRouter

public AbstractMappingMessageRouter()

Method Detail

setChannelMappings

@ManagedAttribute
public void setChannelMappings(Map<String,String> channelMappings)

Provide mappings from channel keys to channel names. Channel names will be resolved by the DestinationResolver.

Specified by:

setChannelMappings in interface MappingMessageRouterManagement

Parameters:

channelMappings - The channel mappings.

setChannelResolver

public void setChannelResolver(DestinationResolver<MessageChannel> channelResolver)

Specify the DestinationResolver strategy to use. The default is a BeanFactoryChannelResolver. This is considered an infrastructural configuration option and as of 2.1 has been deprecated as a configuration-driven attribute.

Parameters:

channelResolver - The channel resolver.

setPrefix

public void setPrefix(String prefix)

Specify a prefix to be added to each channel name prior to resolution.

Parameters:

prefix - The prefix.

setSuffix

public void setSuffix(String suffix)

Specify a suffix to be added to each channel name prior to resolution.

Parameters:

suffix - The suffix.

setResolutionRequired

public void setResolutionRequired(boolean resolutionRequired)

Specify whether this router should ignore any failure to resolve a channel name to an actual MessageChannel instance when delegating to the ChannelResolver strategy.

Parameters:

resolutionRequired - true if resolution is required.

getChannelMappings

@ManagedAttribute
public Map<String,String> getChannelMappings()

Returns an unmodifiable version of the channel mappings. This is intended for use by subclasses only.

Specified by:

getChannelMappings in interface MappingMessageRouterManagement

Returns:

The channel mappings.

setChannelMapping

@ManagedOperation
public void setChannelMapping(String key,
                                      String channelName)

Add a channel mapping from the provided key to channel name.

Specified by:

setChannelMapping in interface MappingMessageRouterManagement

Parameters:

key - The key.

channelName - The channel name.

removeChannelMapping

@ManagedOperation
public void removeChannelMapping(String key)

Remove a channel mapping for the given key if present.

Specified by:

removeChannelMapping in interface MappingMessageRouterManagement

Parameters:

key - The key.

onInit

public void onInit()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this for initialization logic.

Overrides:

onInit in class AbstractMessageRouter

getChannelKeys

protected abstract List<Object> getChannelKeys(Message<?> message)

Subclasses must implement this method to return the channel keys. A "key" might be present in this router's "channelMappings", or it could be the channel's name or even the Message Channel instance itself.

Parameters:

message - The message.

Returns:

The channel keys.

determineTargetChannels

protected Collection<MessageChannel> determineTargetChannels(Message<?> message)

Description copied from class: AbstractMessageRouter

Subclasses must implement this method to return a Collection of zero or more MessageChannels to which the given Message should be routed.

Specified by:

determineTargetChannels in class AbstractMessageRouter

Parameters:

message - The message.

Returns:

The collection of message channels.

replaceChannelMappings

@ManagedOperation
public void replaceChannelMappings(Properties channelMappings)

Convenience method allowing conversion of a list of mappings in a control-bus message.

This is intended to be called via a control-bus; keys and values that are not Strings will be ignored.

Mappings must be delimited with newlines, for example:

"@'myRouter.handler'.replaceChannelMappings('foo=qux \n baz=bar')".

Specified by:

replaceChannelMappings in interface MappingMessageRouterManagement

Parameters:

channelMappings - The channel mappings.

Since:

4.0