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, Aware, BeanClassLoaderAware, BeanFactoryAware, BeanNameAware, FactoryBean<Object>, InitializingBean, ApplicationContextAware, Lifecycle, Phased, SmartLifecycle, NamedComponent, TrackableComponent

Direct Known Subclasses:

GatewayCompletableFutureProxyFactoryBean

public class GatewayProxyFactoryBean
extends AbstractEndpoint
implements TrackableComponent, FactoryBean<Object>, org.aopalliance.intercept.MethodInterceptor, 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

logger

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected 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 AsyncTaskExecutor	getAsyncExecutor()
Object	getObject()
Class<?>	getObjectType()
Object	invoke(org.aopalliance.intercept.MethodInvocation invocation)
boolean	isSingleton()
protected void	onInit() Subclasses may implement this for initialization logic.
void	setAsyncExecutor(Executor executor) Set the executor for use when the gateway method returns Future or ListenableFuture.
void	setBeanClassLoader(ClassLoader beanClassLoader)
void	setDefaultReplyChannel(MessageChannel defaultReplyChannel) Set the default reply channel.
void	setDefaultReplyTimeout(Long defaultReplyTimeout) Set the default timeout value for receiving reply messages.
void	setDefaultRequestChannel(MessageChannel defaultRequestChannel) Set the default request channel.
void	setDefaultRequestTimeout(Long defaultRequestTimeout) Set the default timeout value for sending request messages.
void	setErrorChannel(MessageChannel errorChannel) Set the error channel.
void	setGlobalMethodMetadata(GatewayMethodMetadata globalMethodMetadata)
void	setMapper(MethodArgsMessageMapper mapper) Provide a custom MethodArgsMessageMapper to map from a MethodArgsHolder to a Message.
void	setMethodMetadataMap(Map<String,GatewayMethodMetadata> methodMetadataMap)
void	setReactorEnvironment(Object reactorEnvironment) Set the Reactor Environment to be used for processing methods with a Promise return type.
void	setServiceInterface(Class<?> serviceInterface) Set the interface class that the generated proxy should implement.
void	setShouldTrack(boolean shouldTrack)
void	setTypeConverter(TypeConverter typeConverter)

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

doStop, getPhase, isAutoStartup, isRunning, setAutoStartup, setPhase, setTaskScheduler, start, stop, stop

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

afterPropertiesSet, extractTypeIfPossible, getApplicationContext, getApplicationContextId, getBeanFactory, getChannelResolver, getComponentName, getComponentType, getConversionService, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, 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(Class<?> serviceInterface)

Method Detail

setServiceInterface

public void setServiceInterface(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(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.

setDefaultReplyChannel

public void setDefaultReplyChannel(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

setErrorChannel

public void setErrorChannel(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.

setDefaultRequestTimeout

public void setDefaultRequestTimeout(Long defaultRequestTimeout)

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

Parameters:

defaultRequestTimeout - the timeout value in milliseconds

setDefaultReplyTimeout

public void setDefaultReplyTimeout(Long defaultReplyTimeout)

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

Parameters:

defaultReplyTimeout - the timeout value in milliseconds

setShouldTrack

public void setShouldTrack(boolean shouldTrack)

Specified by:

setShouldTrack in interface TrackableComponent

setAsyncExecutor

public void setAsyncExecutor(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(TypeConverter typeConverter)

setMethodMetadataMap

public void setMethodMetadataMap(Map<String,GatewayMethodMetadata> methodMetadataMap)

setGlobalMethodMetadata

public void setGlobalMethodMetadata(GatewayMethodMetadata globalMethodMetadata)

setReactorEnvironment

public void setReactorEnvironment(Object reactorEnvironment)

Set the Reactor Environment to be used for processing methods with a Promise return type. (Required when any such methods are declared on the service interface).

Parameters:

reactorEnvironment - the Reactor Environment.

Since:

4.1

setBeanClassLoader

public void setBeanClassLoader(ClassLoader beanClassLoader)

Specified by:

setBeanClassLoader in interface 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 AsyncTaskExecutor getAsyncExecutor()

onInit

protected void onInit()

Description copied from class: IntegrationObjectSupport

Subclasses may implement this for initialization logic.

Overrides:

onInit in class IntegrationObjectSupport

getObjectType

public Class<?> getObjectType()

Specified by:

getObjectType in interface FactoryBean<Object>

getObject

public Object getObject()
                 throws Exception

Specified by:

getObject in interface FactoryBean<Object>

Throws:

Exception

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface FactoryBean<Object>

invoke

public Object invoke(org.aopalliance.intercept.MethodInvocation invocation)
              throws Throwable

Specified by:

invoke in interface org.aopalliance.intercept.MethodInterceptor

Throws:

Throwable

doInvoke

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

Throws:

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