org.springframework.integration.gateway

Class GatewayProxyFactoryBean

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.endpoint.AbstractEndpoint

org.springframework.integration.gateway.GatewayProxyFactoryBean

All Implemented Interfaces:

org.aopalliance.aop.Advice, org.aopalliance.intercept.Interceptor, org.aopalliance.intercept.MethodInterceptor, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.BeanFactoryAware, org.springframework.beans.factory.BeanNameAware, org.springframework.beans.factory.DisposableBean, org.springframework.beans.factory.FactoryBean<java.lang.Object>, org.springframework.beans.factory.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.context.Lifecycle, org.springframework.context.Phased, org.springframework.context.SmartLifecycle, ExpressionCapable, NamedComponent, TrackableComponent

Direct Known Subclasses:

AnnotationGatewayProxyFactoryBean

public class GatewayProxyFactoryBean
extends AbstractEndpoint
implements TrackableComponent, org.springframework.beans.factory.FactoryBean<java.lang.Object>, org.aopalliance.intercept.MethodInterceptor, org.springframework.beans.factory.BeanClassLoaderAware

Generates a proxy for the provided service interface to enable interaction with messaging components without application code being aware of them allowing for POJO-style interaction. This component is also aware of the ConversionService set on the enclosing BeanFactory under the name IntegrationUtils.INTEGRATION_CONVERSION_SERVICE_BEAN_NAME to perform type conversions when necessary (thanks to Jon Schneider's contribution and suggestion in INT-1230).

Author:

Mark Fisher, Oleg Zhurakousky, Gary Russell, Artem Bilan

Field Summary

Fields inherited from class org.springframework.integration.endpoint.AbstractEndpoint

lifecycleCondition, lifecycleLock

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

EXPRESSION_PARSER, logger

Fields inherited from interface org.springframework.context.SmartLifecycle

DEFAULT_PHASE

Constructor Summary

Constructors

Constructor and Description
GatewayProxyFactoryBean() Create a Factory whose service interface type can be configured by setter injection.
GatewayProxyFactoryBean(java.lang.Class<?> serviceInterface)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Object	doInvoke(org.aopalliance.intercept.MethodInvocation invocation, boolean runningOnCallerThread)
protected void	doStart() Subclasses must implement this method with the start behavior.
protected void	doStop() Subclasses must implement this method with the stop behavior.
protected org.springframework.core.task.AsyncTaskExecutor	getAsyncExecutor()
java.util.Map<java.lang.reflect.Method,MessagingGatewaySupport>	getGateways() Return the Map of Method to MessagingGatewaySupport generated by this factory bean.
java.lang.Object	getObject()
java.lang.Class<?>	getObjectType()
java.lang.Object	invoke(org.aopalliance.intercept.MethodInvocation invocation)
boolean	isSingleton()
protected void	onInit() Subclasses may implement this for initialization logic.
void	setAsyncExecutor(java.util.concurrent.Executor executor) Set the executor for use when the gateway method returns Future or ListenableFuture.
void	setBeanClassLoader(java.lang.ClassLoader beanClassLoader)
void	setDefaultReplyChannel(org.springframework.messaging.MessageChannel defaultReplyChannel) Set the default reply channel.
void	setDefaultReplyChannelName(java.lang.String defaultReplyChannelName) Set the default reply channel bean name.
void	setDefaultReplyTimeout(java.lang.Long defaultReplyTimeout) Set the default timeout value for receiving reply messages.
void	setDefaultReplyTimeoutExpression(org.springframework.expression.Expression defaultReplyTimeout) Set an expression to be evaluated to determine the default timeout value for receiving reply messages.
void	setDefaultReplyTimeoutExpressionString(java.lang.String defaultReplyTimeout) Set an expression to be evaluated to determine the default timeout value for receiving reply messages.
void	setDefaultRequestChannel(org.springframework.messaging.MessageChannel defaultRequestChannel) Set the default request channel.
void	setDefaultRequestChannelName(java.lang.String defaultRequestChannelName) Set the default request channel bean name.
void	setDefaultRequestTimeout(java.lang.Long defaultRequestTimeout) Set the default timeout value for sending request messages.
void	setDefaultRequestTimeoutExpression(org.springframework.expression.Expression defaultRequestTimeout) Set an expression to be evaluated to determine the default timeout value for sending request messages.
void	setDefaultRequestTimeoutExpressionString(java.lang.String defaultRequestTimeout) Set an expression to be evaluated to determine the default timeout value for sending request messages.
void	setErrorChannel(org.springframework.messaging.MessageChannel errorChannel) Set the error channel.
void	setErrorChannelName(java.lang.String errorChannelName) Set the error channel name.
void	setGlobalMethodMetadata(GatewayMethodMetadata globalMethodMetadata)
void	setMapper(MethodArgsMessageMapper mapper) Provide a custom MethodArgsMessageMapper to map from a MethodArgsHolder to a Message.
void	setMethodMetadataMap(java.util.Map<java.lang.String,GatewayMethodMetadata> methodMetadataMap)
void	setServiceInterface(java.lang.Class<?> serviceInterface) Set the interface class that the generated proxy should implement.
void	setShouldTrack(boolean shouldTrack)
void	setTypeConverter(org.springframework.beans.TypeConverter typeConverter)

Methods inherited from class org.springframework.integration.endpoint.AbstractEndpoint

destroy, doStop, getPhase, getRole, isAutoStartup, isRunning, setAutoStartup, setPhase, setRole, setTaskScheduler, start, stop, stop

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

afterPropertiesSet, extractTypeIfPossible, generateId, getApplicationContext, getApplicationContextId, getBeanFactory, getChannelResolver, getComponentName, getComponentType, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, isInitialized, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, 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, getComponentType

Constructor Detail

GatewayProxyFactoryBean

public GatewayProxyFactoryBean()

Create a Factory whose service interface type can be configured by setter injection. If none is set, it will fall back to the default service interface type, RequestReplyExchanger, upon initialization.

GatewayProxyFactoryBean

public GatewayProxyFactoryBean(java.lang.Class<?> serviceInterface)

Method Detail

setServiceInterface

public void setServiceInterface(java.lang.Class<?> serviceInterface)

Set the interface class that the generated proxy should implement. If none is provided explicitly, the default is RequestReplyExchanger.

Parameters:

serviceInterface - The service interface.

setDefaultRequestChannel

public void setDefaultRequestChannel(org.springframework.messaging.MessageChannel defaultRequestChannel)

Set the default request channel.

Parameters:

defaultRequestChannel - the channel to which request messages will be sent if no request channel has been configured with an annotation.

setDefaultRequestChannelName

public void setDefaultRequestChannelName(java.lang.String defaultRequestChannelName)

Set the default request channel bean name.

Parameters:

defaultRequestChannelName - the channel name to which request messages will be sent if no request channel has been configured with an annotation.

Since:

4.2.9

setDefaultReplyChannel

public void setDefaultReplyChannel(org.springframework.messaging.MessageChannel defaultReplyChannel)

Set the default reply channel. If no default reply channel is provided, and no reply channel is configured with annotations, an anonymous, temporary channel will be used for handling replies.

Parameters:

defaultReplyChannel - the channel from which reply messages will be received if no reply channel has been configured with an annotation

setDefaultReplyChannelName

public void setDefaultReplyChannelName(java.lang.String defaultReplyChannelName)

Set the default reply channel bean name. If no default reply channel is provided, and no reply channel is configured with annotations, an anonymous, temporary channel will be used for handling replies.

Parameters:

defaultReplyChannelName - the channel name from which reply messages will be received if no reply channel has been configured with an annotation

Since:

4.2.9

setErrorChannel

public void setErrorChannel(org.springframework.messaging.MessageChannel errorChannel)

Set the error channel. If no error channel is provided, this gateway will propagate Exceptions to the caller. To completely suppress Exceptions, provide a reference to the "nullChannel" here.

Parameters:

errorChannel - The error channel.

setErrorChannelName

public void setErrorChannelName(java.lang.String errorChannelName)

Set the error channel name. If no error channel is provided, this gateway will propagate Exceptions to the caller. To completely suppress Exceptions, provide a reference to the "nullChannel" here.

Parameters:

errorChannelName - The error channel bean name.

Since:

4.2.9

setDefaultRequestTimeout

public void setDefaultRequestTimeout(java.lang.Long defaultRequestTimeout)

Set the default timeout value for sending request messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultRequestTimeout - the timeout value in milliseconds

setDefaultRequestTimeoutExpression

public void setDefaultRequestTimeoutExpression(org.springframework.expression.Expression defaultRequestTimeout)

Set an expression to be evaluated to determine the default timeout value for sending request messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultRequestTimeout - the timeout value in milliseconds

Since:

5.0

setDefaultRequestTimeoutExpressionString

public void setDefaultRequestTimeoutExpressionString(java.lang.String defaultRequestTimeout)

Set an expression to be evaluated to determine the default timeout value for sending request messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultRequestTimeout - the timeout value in milliseconds

Since:

5.0

setDefaultReplyTimeout

public void setDefaultReplyTimeout(java.lang.Long defaultReplyTimeout)

Set the default timeout value for receiving reply messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultReplyTimeout - the timeout value in milliseconds

setDefaultReplyTimeoutExpression

public void setDefaultReplyTimeoutExpression(org.springframework.expression.Expression defaultReplyTimeout)

Set an expression to be evaluated to determine the default timeout value for receiving reply messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultReplyTimeout - the timeout value in milliseconds

Since:

5.0

setDefaultReplyTimeoutExpressionString

public void setDefaultReplyTimeoutExpressionString(java.lang.String defaultReplyTimeout)

Set an expression to be evaluated to determine the default timeout value for receiving reply messages. If not explicitly configured with an annotation, or on a method element, this value will be used.

Parameters:

defaultReplyTimeout - the timeout value in milliseconds

Since:

5.0

setShouldTrack

public void setShouldTrack(boolean shouldTrack)

Specified by:

setShouldTrack in interface TrackableComponent

setAsyncExecutor

public void setAsyncExecutor(@Nullable
                             java.util.concurrent.Executor executor)

Set the executor for use when the gateway method returns Future or ListenableFuture. Set it to null to disable the async processing, and any Future return types must be returned by the downstream flow.

Parameters:

executor - The executor.

setTypeConverter

public void setTypeConverter(org.springframework.beans.TypeConverter typeConverter)

setMethodMetadataMap

public void setMethodMetadataMap(java.util.Map<java.lang.String,GatewayMethodMetadata> methodMetadataMap)

setGlobalMethodMetadata

public void setGlobalMethodMetadata(GatewayMethodMetadata globalMethodMetadata)

setBeanClassLoader

public void setBeanClassLoader(java.lang.ClassLoader beanClassLoader)

Specified by:

setBeanClassLoader in interface org.springframework.beans.factory.BeanClassLoaderAware

setMapper

public final void setMapper(MethodArgsMessageMapper mapper)

Provide a custom MethodArgsMessageMapper to map from a MethodArgsHolder to a Message.

Parameters:

mapper - the mapper.

getAsyncExecutor

protected org.springframework.core.task.AsyncTaskExecutor getAsyncExecutor()

getGateways

public java.util.Map<java.lang.reflect.Method,MessagingGatewaySupport> getGateways()

Return the Map of Method to MessagingGatewaySupport generated by this factory bean.

Returns:

the map.

Since:

4.3

onInit

protected void onInit()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this for initialization logic.

Overrides:

onInit in class AbstractEndpoint

getObjectType

public java.lang.Class<?> getObjectType()

Specified by:

getObjectType in interface org.springframework.beans.factory.FactoryBean<java.lang.Object>

getObject

public java.lang.Object getObject()
                           throws java.lang.Exception

Specified by:

getObject in interface org.springframework.beans.factory.FactoryBean<java.lang.Object>

Throws:

java.lang.Exception

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface org.springframework.beans.factory.FactoryBean<java.lang.Object>

invoke

@Nullable
public java.lang.Object invoke(org.aopalliance.intercept.MethodInvocation invocation)
                                  throws java.lang.Throwable

Specified by:

invoke in interface org.aopalliance.intercept.MethodInterceptor

Throws:

java.lang.Throwable

doInvoke

@Nullable
protected java.lang.Object doInvoke(org.aopalliance.intercept.MethodInvocation invocation,
                                              boolean runningOnCallerThread)
                                       throws java.lang.Throwable

Throws:

java.lang.Throwable

doStart

protected void doStart()

Description copied from class: AbstractEndpoint

Subclasses must implement this method with the start behavior. This method will be invoked while holding the AbstractEndpoint.lifecycleLock.

Specified by:

doStart in class AbstractEndpoint

doStop

protected void doStop()

Description copied from class: AbstractEndpoint

Subclasses must implement this method with the stop behavior. This method will be invoked while holding the AbstractEndpoint.lifecycleLock.

Specified by:

doStop in class AbstractEndpoint