org.springframework.integration.http.outbound

Class HttpRequestExecutingMessageHandler

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

org.springframework.integration.http.outbound.HttpRequestExecutingMessageHandler

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<?>>

public class HttpRequestExecutingMessageHandler
extends AbstractHttpRequestExecutingMessageHandler

A MessageHandler implementation that executes HTTP requests by delegating to a RestTemplate instance. If the 'expectReply' flag is set to true (the default) then a reply Message will be generated from the HTTP response. If that response contains a body, it will be used as the reply Message's payload. Otherwise the reply Message's payload will contain the response status as an instance of the HttpStatus enum. When there is a response body, the HttpStatus enum instance will instead be copied to the MessageHeaders of the reply. In both cases, the response headers will be mapped to the reply Message's headers by this handler's HeaderMapper instance.

Since:

2.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 inherited from class org.springframework.integration.http.outbound.AbstractHttpRequestExecutingMessageHandler

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
HttpRequestExecutingMessageHandler(org.springframework.expression.Expression uriExpression) Create a handler that will send requests to the provided URI Expression.
HttpRequestExecutingMessageHandler(org.springframework.expression.Expression uriExpression, org.springframework.web.client.RestTemplate restTemplate) Create a handler that will send requests to the provided URI using a provided RestTemplate
HttpRequestExecutingMessageHandler(java.lang.String uri) Create a handler that will send requests to the provided URI.
HttpRequestExecutingMessageHandler(java.lang.String uri, org.springframework.web.client.RestTemplate restTemplate) Create a handler that will send requests to the provided URI using a provided RestTemplate
HttpRequestExecutingMessageHandler(java.net.URI uri) Create a handler that will send requests to the provided URI.

Method Summary

Modifier and Type	Method and Description
protected 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)
java.lang.String	getComponentType()
void	setEncodingMode(org.springframework.web.util.DefaultUriBuilderFactory.EncodingMode encodingMode) Set the encoding mode to use.
void	setErrorHandler(org.springframework.web.client.ResponseErrorHandler errorHandler) Set the ResponseErrorHandler for the underlying RestTemplate.
void	setMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>> messageConverters) Set a list of HttpMessageConverters to be used by the underlying RestTemplate.
void	setRequestFactory(org.springframework.http.client.ClientHttpRequestFactory requestFactory) Set the ClientHttpRequestFactory for the underlying RestTemplate.

Methods inherited from class org.springframework.integration.http.outbound.AbstractHttpRequestExecutingMessageHandler

doInit, evaluateTypeFromExpression, getIntegrationPatternType, getReply, handleRequestMessage, isExpectReply, mapHeaders, setCharset, setEncodeUri, setExpectedResponseType, setExpectedResponseTypeExpression, setExpectReply, setExtractPayload, setHeaderMapper, setHttpMethod, setHttpMethodExpression, setTransferCookies, setTrustedSpel, setUriVariableExpressions, setUriVariablesExpression

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, 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

Constructor Detail

HttpRequestExecutingMessageHandler

public HttpRequestExecutingMessageHandler(java.net.URI uri)

Create a handler that will send requests to the provided URI.

Parameters:

uri - The URI.

HttpRequestExecutingMessageHandler

public HttpRequestExecutingMessageHandler(java.lang.String uri)

Create a handler that will send requests to the provided URI.

Parameters:

uri - The URI.

HttpRequestExecutingMessageHandler

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

Create a handler that will send requests to the provided URI Expression.

Parameters:

uriExpression - The URI expression.

HttpRequestExecutingMessageHandler

public HttpRequestExecutingMessageHandler(java.lang.String uri,
                                          org.springframework.web.client.RestTemplate restTemplate)

Create a handler that will send requests to the provided URI using a provided RestTemplate

Parameters:

uri - The URI.

restTemplate - The rest template.

HttpRequestExecutingMessageHandler

public HttpRequestExecutingMessageHandler(org.springframework.expression.Expression uriExpression,
                                          @Nullable
                                          org.springframework.web.client.RestTemplate restTemplate)

Create a handler that will send requests to the provided URI using a provided RestTemplate

Parameters:

uriExpression - A SpEL Expression that can be resolved against the message object and BeanFactory.

restTemplate - The rest template.

Method Detail

getComponentType

public java.lang.String getComponentType()

Specified by:

getComponentType in interface org.springframework.integration.support.context.NamedComponent

Overrides:

getComponentType in class org.springframework.integration.handler.MessageHandlerSupport

setErrorHandler

public void setErrorHandler(org.springframework.web.client.ResponseErrorHandler errorHandler)

Set the ResponseErrorHandler for the underlying RestTemplate.

Parameters:

errorHandler - The error handler.

See Also:

RestTemplate.setErrorHandler(ResponseErrorHandler)

setMessageConverters

public void setMessageConverters(java.util.List<org.springframework.http.converter.HttpMessageConverter<?>> messageConverters)

Set a list of HttpMessageConverters to be used by the underlying RestTemplate. Converters configured via this method will override the default converters.

Parameters:

messageConverters - The message converters.

See Also:

RestTemplate.setMessageConverters(java.util.List)

setRequestFactory

public void setRequestFactory(org.springframework.http.client.ClientHttpRequestFactory requestFactory)

Set the ClientHttpRequestFactory for the underlying RestTemplate.

Parameters:

requestFactory - The request factory.

See Also:

InterceptingHttpAccessor.setRequestFactory(ClientHttpRequestFactory)

setEncodingMode

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

Description copied from class: AbstractHttpRequestExecutingMessageHandler

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.

Overrides:

setEncodingMode in class AbstractHttpRequestExecutingMessageHandler

Parameters:

encodingMode - the mode to use for uri encoding

exchange

@Nullable
protected 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)

Specified by:

exchange in class AbstractHttpRequestExecutingMessageHandler