org.springframework.integration.http.outbound

Class AbstractHttpRequestExecutingMessageHandler

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.handler.MessageHandlerSupport

org.springframework.integration.handler.AbstractMessageHandler

org.springframework.integration.handler.AbstractMessageProducingHandler

org.springframework.integration.handler.AbstractReplyProducingMessageHandler

org.springframework.integration.http.outbound.AbstractHttpRequestExecutingMessageHandler

All Implemented Interfaces:

org.reactivestreams.Subscriber<org.springframework.messaging.Message<?>>, 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.InitializingBean, org.springframework.context.ApplicationContextAware, org.springframework.core.Ordered, org.springframework.integration.context.ExpressionCapable, org.springframework.integration.context.Orderable, org.springframework.integration.core.MessageProducer, org.springframework.integration.handler.HeaderPropagationAware, org.springframework.integration.IntegrationPattern, org.springframework.integration.support.context.NamedComponent, org.springframework.integration.support.management.IntegrationManagement, org.springframework.integration.support.management.TrackableComponent, org.springframework.messaging.MessageHandler, reactor.core.CoreSubscriber<org.springframework.messaging.Message<?>>

Direct Known Subclasses:

HttpRequestExecutingMessageHandler

public abstract class AbstractHttpRequestExecutingMessageHandler
extends org.springframework.integration.handler.AbstractReplyProducingMessageHandler

Base class for http outbound adapter/gateway.

Since:

5.0

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

org.springframework.integration.handler.AbstractReplyProducingMessageHandler.RequestHandler

Nested classes/interfaces inherited from interface org.springframework.integration.support.management.IntegrationManagement

org.springframework.integration.support.management.IntegrationManagement.ManagementOverrides

Field Summary

Fields

Modifier and Type	Field and Description
protected org.springframework.web.util.DefaultUriBuilderFactory	uriFactory

Fields inherited from class org.springframework.integration.handler.AbstractMessageProducingHandler

messagingTemplate

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

EXPRESSION_PARSER, logger

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Fields inherited from interface org.springframework.integration.support.management.IntegrationManagement

METER_PREFIX, RECEIVE_COUNTER_NAME, SEND_TIMER_NAME

Constructor Summary

Constructors

Constructor and Description
AbstractHttpRequestExecutingMessageHandler(org.springframework.expression.Expression uriExpression)

Method Summary

Modifier and Type	Method and Description
protected void	doInit()
protected java.lang.Object	evaluateTypeFromExpression(org.springframework.messaging.Message<?> requestMessage, org.springframework.expression.Expression expression, java.lang.String property)
protected abstract java.lang.Object	exchange(java.lang.Object uri, org.springframework.http.HttpMethod httpMethod, org.springframework.http.HttpEntity<?> httpRequest, java.lang.Object expectedResponseType, org.springframework.messaging.Message<?> requestMessage, java.util.Map<java.lang.String,?> uriVariables)
org.springframework.integration.IntegrationPatternType	getIntegrationPatternType()
protected java.lang.Object	getReply(org.springframework.http.ResponseEntity<?> httpResponse)
protected java.lang.Object	handleRequestMessage(org.springframework.messaging.Message<?> requestMessage)
boolean	isExpectReply()
protected org.springframework.http.HttpHeaders	mapHeaders(org.springframework.messaging.Message<?> message)
void	setCharset(java.lang.String charset) Specify the charset name to use for converting String-typed payloads to bytes.
void	setEncodeUri(boolean encodeUri) Deprecated. since 5.3 in favor of setEncodingMode(org.springframework.web.util.DefaultUriBuilderFactory.EncodingMode)
void	setEncodingMode(org.springframework.web.util.DefaultUriBuilderFactory.EncodingMode encodingMode) Set the encoding mode to use.
void	setExpectedResponseType(java.lang.Class<?> expectedResponseType) Specify the expected response type for the REST request otherwise the default response type is ResponseEntity and will be returned as a payload of the reply Message.
void	setExpectedResponseTypeExpression(org.springframework.expression.Expression expectedResponseTypeExpression) Specify the Expression to determine the type for the expected response The returned value of the expression could be an instance of Class or String representing a fully qualified class name.
void	setExpectReply(boolean expectReply) Specify whether a reply Message is expected.
void	setExtractPayload(boolean extractPayload) Specify whether the outbound message's payload should be extracted when preparing the request body.
void	setHeaderMapper(org.springframework.integration.mapping.HeaderMapper<org.springframework.http.HttpHeaders> headerMapper) Set the HeaderMapper to use when mapping between HTTP headers and MessageHeaders.
void	setHttpMethod(org.springframework.http.HttpMethod httpMethod) Specify the HttpMethod for requests.
void	setHttpMethodExpression(org.springframework.expression.Expression httpMethodExpression) Specify the SpEL Expression to determine HttpMethod at runtime.
void	setTransferCookies(boolean transferCookies) Set to true if you wish 'Set-Cookie' headers in responses to be transferred as 'Cookie' headers in subsequent interactions for a message.
void	setTrustedSpel(boolean trustedSpel) Set to true if you trust the source of SpEL expressions used to evaluate URI variables.
void	setUriVariableExpressions(java.util.Map<java.lang.String,org.springframework.expression.Expression> uriVariableExpressions) Set the Map of URI variable expressions to evaluate against the outbound message when replacing the variable placeholders in a URI template.
void	setUriVariablesExpression(org.springframework.expression.Expression uriVariablesExpression) Set the Expression to evaluate against the outbound message; the expression must evaluate to a Map of URI variable expressions to evaluate against the outbound message when replacing the variable placeholders in a URI template.

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

doInvokeAdvisedRequestHandler, getBeanClassLoader, getRequiresReply, handleMessageInternal, hasAdviceChain, onInit, setAdviceChain, setBeanClassLoader, setRequiresReply

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

addNotPropagatedHeaders, createOutputMessage, getNotPropagatedHeaders, getOutputChannel, isAsync, messageBuilderForReply, produceOutput, resolveErrorChannel, sendErrorMessage, sendOutput, sendOutputs, setAsync, setNotPropagatedHeaders, setOutputChannel, setOutputChannelName, setSendTimeout, shouldCopyRequestHeaders, shouldSplitOutput, updateNotPropagatedHeaders

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

handleMessage, onComplete, onError, onNext, onSubscribe

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

buildSendTimer, destroy, getComponentType, getManagedName, getManagedType, getMetricsCaptor, getOrder, getOverrides, isLoggingEnabled, registerMetricsCaptor, sendTimer, setLoggingEnabled, setManagedName, setManagedType, setOrder, setShouldTrack, shouldTrack

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

afterPropertiesSet, extractTypeIfPossible, generateId, getApplicationContext, getApplicationContextId, getBeanDescription, getBeanFactory, getBeanName, getChannelResolver, getComponentName, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, isInitialized, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface reactor.core.CoreSubscriber

currentContext

Methods inherited from interface org.springframework.integration.support.management.IntegrationManagement

getThisAs

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

getBeanName, getComponentName

Field Detail

uriFactory

protected final org.springframework.web.util.DefaultUriBuilderFactory uriFactory

Constructor Detail

AbstractHttpRequestExecutingMessageHandler

public AbstractHttpRequestExecutingMessageHandler(org.springframework.expression.Expression uriExpression)

Method Detail

setEncodeUri

@Deprecated
public void setEncodeUri(boolean encodeUri)

Deprecated. since 5.3 in favor of setEncodingMode(org.springframework.web.util.DefaultUriBuilderFactory.EncodingMode)

Specify whether the real URI should be encoded after uriVariables expanding and before send request via RestTemplate. The default value is true.

Parameters:

encodeUri - true if the URI should be encoded.

See Also:

UriComponentsBuilder

setEncodingMode

public void setEncodingMode(org.springframework.web.util.DefaultUriBuilderFactory.EncodingMode encodingMode)

Set the encoding mode to use. By default this is set to DefaultUriBuilderFactory.EncodingMode#TEMPLATE_AND_VALUES. For more complicated scenarios consider to configure an UriTemplateHandler on an externally provided RestTemplate.

Parameters:

encodingMode - the mode to use for uri encoding

Since:

5.3

setHttpMethodExpression

public void setHttpMethodExpression(org.springframework.expression.Expression httpMethodExpression)

Specify the SpEL Expression to determine HttpMethod at runtime.

Parameters:

httpMethodExpression - The method expression.

setHttpMethod

public void setHttpMethod(org.springframework.http.HttpMethod httpMethod)

Specify the HttpMethod for requests. The default method is POST.

Parameters:

httpMethod - The method.

setExtractPayload

public void setExtractPayload(boolean extractPayload)

Specify whether the outbound message's payload should be extracted when preparing the request body. Otherwise the Message instance itself is serialized. The default value is true.

Parameters:

extractPayload - true if the payload should be extracted.

setCharset

public void setCharset(java.lang.String charset)

Specify the charset name to use for converting String-typed payloads to bytes. The default is UTF-8.

Parameters:

charset - The charset.

isExpectReply

public boolean isExpectReply()

Returns:

whether a reply Message is expected.

See Also:

setExpectReply(boolean)

setExpectReply

public void setExpectReply(boolean expectReply)

Specify whether a reply Message is expected. If not, this handler will simply return null for a successful response or throw an Exception for a non-successful response. The default is true.

Parameters:

expectReply - true if a reply is expected.

setExpectedResponseType

public void setExpectedResponseType(java.lang.Class<?> expectedResponseType)

Specify the expected response type for the REST request otherwise the default response type is ResponseEntity and will be returned as a payload of the reply Message. To take advantage of the HttpMessageConverters registered on this adapter, provide a different type).

Parameters:

expectedResponseType - The expected type. Also see setExpectedResponseTypeExpression(Expression)

setExpectedResponseTypeExpression

public void setExpectedResponseTypeExpression(org.springframework.expression.Expression expectedResponseTypeExpression)

Specify the Expression to determine the type for the expected response The returned value of the expression could be an instance of Class or String representing a fully qualified class name.

Parameters:

expectedResponseTypeExpression - The expected response type expression. Also see setExpectedResponseType(java.lang.Class<?>)

setHeaderMapper

public void setHeaderMapper(org.springframework.integration.mapping.HeaderMapper<org.springframework.http.HttpHeaders> headerMapper)

Set the HeaderMapper to use when mapping between HTTP headers and MessageHeaders.

Parameters:

headerMapper - The header mapper.

setUriVariableExpressions

public void setUriVariableExpressions(java.util.Map<java.lang.String,org.springframework.expression.Expression> uriVariableExpressions)

Set the Map of URI variable expressions to evaluate against the outbound message when replacing the variable placeholders in a URI template.

Parameters:

uriVariableExpressions - The URI variable expressions.

setUriVariablesExpression

public void setUriVariablesExpression(org.springframework.expression.Expression uriVariablesExpression)

Set the Expression to evaluate against the outbound message; the expression must evaluate to a Map of URI variable expressions to evaluate against the outbound message when replacing the variable placeholders in a URI template.

Parameters:

uriVariablesExpression - The URI variables expression.

setTransferCookies

public void setTransferCookies(boolean transferCookies)

Set to true if you wish 'Set-Cookie' headers in responses to be transferred as 'Cookie' headers in subsequent interactions for a message.

Parameters:

transferCookies - the transferCookies to set.

setTrustedSpel

public void setTrustedSpel(boolean trustedSpel)

Set to true if you trust the source of SpEL expressions used to evaluate URI variables. Default is false, which means a SimpleEvaluationContext is used for evaluating such expressions, which restricts the use of some SpEL capabilities.

Parameters:

trustedSpel - true to trust.

Since:

4.3.15.

getIntegrationPatternType

public org.springframework.integration.IntegrationPatternType getIntegrationPatternType()

Specified by:

getIntegrationPatternType in interface org.springframework.integration.IntegrationPattern

Overrides:

getIntegrationPatternType in class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

doInit

protected void doInit()

Overrides:

doInit in class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

handleRequestMessage

@Nullable
protected java.lang.Object handleRequestMessage(org.springframework.messaging.Message<?> requestMessage)

Specified by:

handleRequestMessage in class org.springframework.integration.handler.AbstractReplyProducingMessageHandler

exchange

@Nullable
protected abstract java.lang.Object exchange(java.lang.Object uri,
                                                       org.springframework.http.HttpMethod httpMethod,
                                                       org.springframework.http.HttpEntity<?> httpRequest,
                                                       java.lang.Object expectedResponseType,
                                                       org.springframework.messaging.Message<?> requestMessage,
                                                       java.util.Map<java.lang.String,?> uriVariables)

getReply

protected java.lang.Object getReply(org.springframework.http.ResponseEntity<?> httpResponse)

mapHeaders

protected org.springframework.http.HttpHeaders mapHeaders(org.springframework.messaging.Message<?> message)

evaluateTypeFromExpression

@Nullable
protected java.lang.Object evaluateTypeFromExpression(org.springframework.messaging.Message<?> requestMessage,
                                                                @Nullable
                                                                org.springframework.expression.Expression expression,
                                                                java.lang.String property)