org.springframework.integration.annotation

Annotation Type MessagingGateway

@Target(value=TYPE)
@Retention(value=RUNTIME)
@Documented
public @interface MessagingGateway

The stereotype annotation to provide the Integration Messaging Gateway Proxy (<gateway/>).

Since:

4.0

Author:

Artem Bilan

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	asyncExecutor Provide a reference to an implementation of Executor to use for any of the interface methods that have a Future return type.
GatewayHeader[]	defaultHeaders Provides custom message headers.
String	defaultPayloadExpression An expression that will be used to generate the payload for all methods in the service interface unless explicitly overridden by a method declaration.
String	defaultReplyChannel Identifies default channel the gateway proxy will subscribe to to receive reply Messages, which will then be converted to the return type of the method signature.
long	defaultReplyTimeout Allows to specify how long this gateway will wait for the reply Message before returning.
String	defaultRequestChannel Identifies default channel the messages will be sent to upon invocation of methods of the gateway proxy.
long	defaultRequestTimeout Provides the amount of time dispatcher would wait to send a Message.
String	errorChannel Identifies a channel that error messages will be sent to if a failure occurs in the gateway's proxy invocation.
String	mapper An MethodArgsMessageMapper to map the method arguments to a Message.
String	name The value may indicate a suggestion for a logical component name, to be turned into a Spring bean in case of an autodetected component.

Element Detail

name

public abstract String name

The value may indicate a suggestion for a logical component name, to be turned into a Spring bean in case of an autodetected component.

Returns:

the suggested component name, if any

Default:

""

defaultRequestChannel

public abstract String defaultRequestChannel

Identifies default channel the messages will be sent to upon invocation of methods of the gateway proxy.

Returns:

the suggested channel name, if any

Default:

""

defaultReplyChannel

public abstract String defaultReplyChannel

Identifies default channel the gateway proxy will subscribe to to receive reply Messages, which will then be converted to the return type of the method signature.

Returns:

the suggested channel name, if any

Default:

""

errorChannel

public abstract String errorChannel

Identifies a channel that error messages will be sent to if a failure occurs in the gateway's proxy invocation. If no errorChannel reference is provided, the gateway will propagate Exceptions to the caller. To completely suppress Exceptions, provide a reference to the nullChannel here.

Returns:

the suggested channel name, if any

Default:

""

defaultRequestTimeout

public abstract long defaultRequestTimeout

Provides the amount of time dispatcher would wait to send a Message. This timeout would only apply if there is a potential to block in the send call. For example if this gateway is hooked up to a QueueChannel.

Returns:

the suggested timeout in milliseconds, if any

Default:

-9223372036854775808L

defaultReplyTimeout

public abstract long defaultReplyTimeout

Allows to specify how long this gateway will wait for the reply Message before returning. By default it will wait indefinitely. null is returned if the gateway times out.

Returns:

the suggested timeout in milliseconds, if any

Default:

-9223372036854775808L

asyncExecutor

public abstract String asyncExecutor

Provide a reference to an implementation of Executor to use for any of the interface methods that have a Future return type. This Executor will only be used for those async methods; the sync methods will be invoked in the caller's thread.

Returns:

the suggested executor bean name, if any

Default:

""

defaultPayloadExpression

public abstract String defaultPayloadExpression

An expression that will be used to generate the payload for all methods in the service interface unless explicitly overridden by a method declaration. Variables include #args, #methodName, #methodString and #methodObject; a bean resolver is also available, enabling expressions like @someBean(#args).

Returns:

the suggested payload expression, if any

Default:

""

defaultHeaders

public abstract GatewayHeader[] defaultHeaders

Provides custom message headers. These default headers are created for all methods on the service-interface (unless overridden by a specific method).

Returns:

the suggested payload expression, if any

Default:

{}

mapper

public abstract String mapper

An MethodArgsMessageMapper to map the method arguments to a Message. When this is provided, no payload-expressions or headers are allowed; the custom mapper is responsible for creating the message.

Returns:

the suggested mapper bean name, if any

Default:

""