(window.webpackJsonp=window.webpackJsonp||[]).push([[116],{545:function(e,t,n){"use strict";n.r(t);var a=n(56),r=Object(a.a)({},(function(){var e=this,t=e.$createElement,n=e._self._c||t;return n("ContentSlotsDistributor",{attrs:{"slot-key":e.$parent.slotKey}},[n("h1",{attrs:{id:"change-history"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#change-history"}},[e._v("#")]),e._v(" Change History")]),e._v(" "),n("h2",{attrs:{id:"change-history-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#change-history-2"}},[e._v("#")]),e._v(" Change History")]),e._v(" "),n("h3",{attrs:{id:"changes-between-5-3-and-5-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-5-3-and-5-4"}},[e._v("#")]),e._v(" Changes between 5.3 and 5.4")]),e._v(" "),n("h3",{attrs:{id:"new-components"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("h4",{attrs:{id:"channel-adapters-for-apache-kafka"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#channel-adapters-for-apache-kafka"}},[e._v("#")]),e._v(" Channel Adapters for Apache Kafka")]),e._v(" "),n("p",[e._v("The standalone "),n("a",{attrs:{href:"https://projects.spring.io/spring-integration-kafka/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration for Apache Kafka"),n("OutboundLink")],1),e._v(" project has been merged as a "),n("code",[e._v("spring-integration-kafka")]),e._v(" module to this project.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("KafkaProducerMessageHandler")]),e._v(" "),n("code",[e._v("sendTimeoutExpression")]),e._v(" default has changed.")]),e._v(" "),n("p",[e._v("You can now access the "),n("code",[e._v("Future<?>")]),e._v(" for underlying "),n("code",[e._v("send()")]),e._v(" operations.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/kafka.html#kafka"}},[e._v("Spring for Apache Kafka Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"r2dbc-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#r2dbc-channel-adapters"}},[e._v("#")]),e._v(" R2DBC Channel Adapters")]),e._v(" "),n("p",[e._v("The Channel Adapters for R2DBC database interaction have been introduced.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/r2dbc.html#r2dbc"}},[e._v("R2DBC Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"redis-stream-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-stream-support"}},[e._v("#")]),e._v(" Redis Stream Support")]),e._v(" "),n("p",[e._v("The Channel Adapters for Redis Stream support have been introduced.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-stream-outbound"}},[e._v("Redis Stream Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"renewable-lock-registry"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#renewable-lock-registry"}},[e._v("#")]),e._v(" Renewable Lock Registry")]),e._v(" "),n("p",[e._v("A Renewable lock registry has been introduced to allow renew lease of a distributed lock.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-lock-registry"}},[e._v("JDBC implementation")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"zeromq-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#zeromq-support"}},[e._v("#")]),e._v(" ZeroMQ Support")]),e._v(" "),n("p",[n("code",[e._v("ZeroMqChannel")]),e._v(", "),n("code",[e._v("ZeroMqMessageHandler")]),e._v(" and "),n("code",[e._v("ZeroMqMessageProducer")]),e._v(" have been introduced.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/zeromq.html#zeromq"}},[e._v("ZeroMQ Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"general-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("The one-way messaging gateway (the "),n("code",[e._v("void")]),e._v(" method return type) now sets a "),n("code",[e._v("nullChannel")]),e._v(" explicitly into the "),n("code",[e._v("replyChannel")]),e._v(" header to ignore any possible downstream replies.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway-default-reply-channel"}},[e._v("Setting the Default Reply Channel")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("Also the gateway method invokers ("),n("code",[e._v("GatewayProxyFactoryBean.MethodInvocationGateway")]),e._v(") are now supplied with the managed bean name as a combination of gateway proxy bean name plus method signature.\nFor example: "),n("code",[e._v("sampleGateway#echo(String)")]),e._v(".\nThis effects message history and metrics exposed for the gateway method calls and also give fine-grained logs during start and close of application context.")]),e._v(" "),n("p",[e._v("The aggregator (and resequencer) can now expire orphaned groups (groups in a persistent store where no new messages arrive after an application restart).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-expiring-groups"}},[e._v("Aggregator Expiring Groups")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The legacy metrics that were replaced by Micrometer meters have been removed.")]),e._v(" "),n("p",[e._v("The "),n("RouterLink",{attrs:{to:"/en/spring-integration/barrier.html#barrier"}},[e._v("Thread Barrier")]),e._v(" has now two separate timeout options: "),n("code",[e._v("requestTimeout")]),e._v(" and "),n("code",[e._v("triggerTimeout")]),e._v(".")],1),e._v(" "),n("h3",{attrs:{id:"tcp-udp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-udp-changes"}},[e._v("#")]),e._v(" TCP/UDP Changes")]),e._v(" "),n("p",[e._v("Connection factories now support multiple sending components ("),n("code",[e._v("TcpSender")]),e._v("); they remain limited to one receiving component ("),n("code",[e._v("TcpListener")]),e._v(").\nThis allows, for example, an inbound gateway and outbound channel adapter to share the same factory, supporting both request/reply and arbitrary messaging from the server to the client.\nShared factories should not be used with outbound gateways, unless single-use connections or the "),n("code",[e._v("ThreadAffinityClientConnectionFactory")]),e._v(" are being used.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip-collaborating-adapters"}},[e._v("Collaborating Channel Adapters")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-gateways"}},[e._v("TCP Gateways")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The UDP channel adapters can now be configured with a "),n("code",[e._v("SocketCustomizer")]),e._v(" which allows the setting of socket properties that are not directly supported by the adapters.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#udp-adapters"}},[e._v("UDP Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"rmi-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#rmi-changes"}},[e._v("#")]),e._v(" RMI Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("spring-integration-rmi")]),e._v(" module is deprecated with no replacement and is going to be removed in the next major version.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/rmi.html#rmi"}},[e._v("RMI Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"amqp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("The outbound endpoints now have a new mechanism for handling publisher confirms and returns.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#alternative-confirms-returns"}},[e._v("Alternative Mechanism for Publisher Confirms and Returns")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("BatchMode.EXTRACT_PAYLOAD_WITH_HEADERS")]),e._v(" is supported by the "),n("code",[e._v("AmqpInboundChannelAdapter")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-inbound-channel-adapter"}},[e._v("Inbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"mail-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mail-changes"}},[e._v("#")]),e._v(" Mail Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("AbstractMailReceiver")]),e._v(" can now produce the "),n("code",[e._v("MimeMessage")]),e._v(" as-is without eager fetching its content.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#mail-inbound"}},[e._v("Mail-receiving Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-5-2-and-5-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-5-2-and-5-3"}},[e._v("#")]),e._v(" Changes between 5.2 and 5.3")]),e._v(" "),n("h3",{attrs:{id:"new-components-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-2"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("h4",{attrs:{id:"integration-pattern"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-pattern"}},[e._v("#")]),e._v(" Integration Pattern")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("IntegrationPattern")]),e._v(" abstraction has been introduced to indicate which enterprise integration pattern (an "),n("code",[e._v("IntegrationPatternType")]),e._v(") and category a Spring Integration component belongs to.\nSee its JavaDocs and "),n("RouterLink",{attrs:{to:"/en/spring-integration/graph.html#integration-graph"}},[e._v("Integration Graph")]),e._v(" for more information about this abstraction and its use-cases.")],1),e._v(" "),n("h4",{attrs:{id:"reactivemessagehandler"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#reactivemessagehandler"}},[e._v("#")]),e._v(" "),n("code",[e._v("ReactiveMessageHandler")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ReactiveMessageHandler")]),e._v(" is now natively supported in the framework.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/reactive-streams.html#reactive-message-handler"}},[e._v("ReactiveMessageHandler")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"reactivemessagesourceproducer"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#reactivemessagesourceproducer"}},[e._v("#")]),e._v(" "),n("code",[e._v("ReactiveMessageSourceProducer")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ReactiveMessageSourceProducer")]),e._v(" is a reactive implementation of the "),n("code",[e._v("MessageProducerSupport")]),e._v(" to wrap a provided "),n("code",[e._v("MessageSource")]),e._v(" into a "),n("code",[e._v("Flux")]),e._v(" for on demand "),n("code",[e._v("receive()")]),e._v(" calls.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/reactive-streams.html#reactive-streams"}},[e._v("Reactive Streams Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"java-dsl-extensions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#java-dsl-extensions"}},[e._v("#")]),e._v(" Java DSL Extensions")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("IntegrationFlowExtension")]),e._v(" API has been introduced to allow extension of the existing Java DSL with custom or composed EIP-operators.\nThis also can be used to introduce customizers for any out-of-the-box "),n("code",[e._v("IntegrationComponentSpec")]),e._v(" extensions.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/dsl.html#java-dsl-extensions"}},[e._v("DSL Extensions")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"kotlin-dsl"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#kotlin-dsl"}},[e._v("#")]),e._v(" Kotlin DSL")]),e._v(" "),n("p",[e._v("The Kotlin DSL for integration flow configurations has been introduced.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/kotlin-dsl.html#kotlin-dsl"}},[e._v("Kotlin DSL Chapter")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"reactiverequesthandleradvice"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#reactiverequesthandleradvice"}},[e._v("#")]),e._v(" ReactiveRequestHandlerAdvice")]),e._v(" "),n("p",[e._v("A "),n("code",[e._v("ReactiveRequestHandlerAdvice")]),e._v(" is provided to customize "),n("code",[e._v("Mono")]),e._v(" replies from message handlers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#reactive-advice"}},[e._v("Reactive Advice")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"handlemessageadviceadapter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#handlemessageadviceadapter"}},[e._v("#")]),e._v(" HandleMessageAdviceAdapter")]),e._v(" "),n("p",[e._v("A "),n("code",[e._v("HandleMessageAdviceAdapter")]),e._v(" is provided to wrap any "),n("code",[e._v("MethodInterceptor")]),e._v(" for applying on the "),n("code",[e._v("MessageHandler.handleMessage()")]),e._v(" instead of a default "),n("code",[e._v("AbstractReplyProducingMessageHandler.RequestHandler.handleRequestMessage()")]),e._v(" behavior.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#handle-message-advice"}},[e._v("Handling Message Advice")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"mongodb-reactive-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-reactive-channel-adapters"}},[e._v("#")]),e._v(" MongoDB Reactive Channel Adapters")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("spring-integration-mongodb")]),e._v(" module now provides channel adapter implementations for the Reactive MongoDb driver support in Spring Data.\nAlso, a reactive implementation for MongoDb change stream support is present with the "),n("code",[e._v("MongoDbChangeStreamMessageProducer")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb"}},[e._v("MongoDB Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"receivemessageadvice"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#receivemessageadvice"}},[e._v("#")]),e._v(" ReceiveMessageAdvice")]),e._v(" "),n("p",[e._v("A special "),n("code",[e._v("ReceiveMessageAdvice")]),e._v(" has been introduced to proxy exactly "),n("code",[e._v("MessageSource.receive()")]),e._v(" or "),n("code",[e._v("PollableChannel.receive()")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/polling-consumer.html#smart-polling"}},[e._v("Smart Polling")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"general-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-2"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("The gateway proxy now doesn’t proxy "),n("code",[e._v("default")]),e._v(" methods by default.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway-calling-default-methods"}},[e._v("Invoking "),n("code",[e._v("default")]),e._v(" Methods")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("Internal components (such as "),n("code",[e._v("_org.springframework.integration.errorLogger")]),e._v(") now have a shortened name when they are represented in the integration graph.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/graph.html#integration-graph"}},[e._v("Integration Graph")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("In the aggregator, when the "),n("code",[e._v("MessageGroupProcessor")]),e._v(" returns a "),n("code",[e._v("Message")]),e._v(", the "),n("code",[e._v("MessageBuilder.popSequenceDetails()")]),e._v(" is performed on the output message if the "),n("code",[e._v("sequenceDetails")]),e._v(" matches the header in the first message of the group.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-api"}},[e._v("Aggregator Programming Model")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("publishSubscribeChannel()")]),e._v(" operator, based on the "),n("code",[e._v("BroadcastCapableChannel")]),e._v(" and "),n("code",[e._v("BroadcastPublishSubscribeSpec")]),e._v(", was added into Java DSL.\nThis fluent API has its advantage when we configure sub-flows as pub-sub subscribers for broker-backed channels like "),n("code",[e._v("SubscribableJmsChannel")]),e._v(", "),n("code",[e._v("SubscribableRedisChannel")]),e._v(" etc.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/dsl.html#java-dsl-subflows"}},[e._v("Sub-flows support")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("Transactional support in Spring Integration now also includes options to configure a "),n("code",[e._v("ReactiveTransactionManager")]),e._v(" if a "),n("code",[e._v("MessageSource")]),e._v(" or "),n("code",[e._v("MessageHandler")]),e._v(" implementation produces a reactive type for payload to send.\nSee "),n("code",[e._v("TransactionInterceptorBuilder")]),e._v(" for more information.\nSee also "),n("RouterLink",{attrs:{to:"/en/spring-integration/transactions.html#reactive-transactions"}},[e._v("Reactive Transactions")]),e._v(".")],1),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("intercept()")]),e._v(" operator to register "),n("code",[e._v("ChannelInterceptor")]),e._v(" instances without creating explicit channels was added into Java DSL.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/dsl.html#java-dsl-intercept"}},[e._v("Operator intercept()")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("MessageStoreSelector")]),e._v(" has a new mechanism to compare an old and new value.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#idempotent-receiver"}},[e._v("Idempotent Receiver Enterprise Integration Pattern")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("MessageProducerSupport")]),e._v(" base class now has a "),n("code",[e._v("subscribeToPublisher(Publisher<? extends Message<?>>)")]),e._v(" API to allow implementation of message-driven producer endpoints which emit messages via reactive "),n("code",[e._v("Publisher")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/reactive-streams.html#reactive-streams"}},[e._v("Reactive Streams Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"amqp-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-2"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("The outbound channel adapter has a new property "),n("code",[e._v("multiSend")]),e._v(" allowing multiple messages to be sent within the scope of one "),n("code",[e._v("RabbitTemplate")]),e._v(" invocation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-outbound-channel-adapter"}},[e._v("AMQP Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The inbound channel adapter now supports a listener container with the "),n("code",[e._v("consumerBatchEnabled")]),e._v(" property set to "),n("code",[e._v("true")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-inbound-channel-adapter"}},[e._v("AMQP Inbound Channel Adapter")])],1),e._v(" "),n("h3",{attrs:{id:"http-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-changes"}},[e._v("#")]),e._v(" HTTP Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("encodeUri")]),e._v(" property on the "),n("code",[e._v("AbstractHttpRequestExecutingMessageHandler")]),e._v(" has been deprecated in favor of newly introduced "),n("code",[e._v("encodingMode")]),e._v(".\nSee "),n("code",[e._v("DefaultUriBuilderFactory.EncodingMode")]),e._v(" JavaDocs and "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-uri-encoding"}},[e._v("Controlling URI Encoding")]),e._v(" for more information.\nThis also affects "),n("code",[e._v("WebFluxRequestExecutingMessageHandler")]),e._v(", respective Java DSL and XML configuration.\nThe same option is added into an "),n("code",[e._v("AbstractWebServiceOutboundGateway")]),e._v(".")],1),e._v(" "),n("h3",{attrs:{id:"web-services-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#web-services-changes"}},[e._v("#")]),e._v(" Web Services Changes")]),e._v(" "),n("p",[e._v("Java DSL support has been added for Web Service components.\nThe "),n("code",[e._v("encodeUri")]),e._v(" property on the "),n("code",[e._v("AbstractWebServiceOutboundGateway")]),e._v(" has been deprecated in favor of newly introduced "),n("code",[e._v("encodingMode")]),e._v(" - similar to HTTP changes above.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ws.html#ws"}},[e._v("Web Services Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"tcp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-changes"}},[e._v("#")]),e._v(" TCP Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FailoverClientConnectionFactory")]),e._v(" no longer fails back, by default, until the current connection fails.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#failover-cf"}},[e._v("TCP Failover Client Connection Factory")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("TcpOutboundGateway")]),e._v(" now supports asynchronous request/reply.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-gateways"}},[e._v("TCP Gateways")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("You can now configure client connections to perform some arbitrary test on new connections.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#testing-connections"}},[e._v("Testing Connections")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"rsocket-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#rsocket-changes"}},[e._v("#")]),e._v(" RSocket Changes")]),e._v(" "),n("p",[e._v("A "),n("code",[e._v("decodeFluxAsUnit")]),e._v(" option has been added to the "),n("code",[e._v("RSocketInboundGateway")]),e._v(" with the meaning to decode incoming "),n("code",[e._v("Flux")]),e._v(" as a single unit or apply decoding for each event in it.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/rsocket.html#rsocket-inbound"}},[e._v("RSocket Inbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"zookeeper-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#zookeeper-changes"}},[e._v("#")]),e._v(" Zookeeper Changes")]),e._v(" "),n("p",[e._v("A "),n("code",[e._v("LeaderInitiatorFactoryBean")]),e._v(" (as well as its XML "),n("code",[e._v("<int-zk:leader-listener>")]),e._v(") exposes a "),n("code",[e._v("candidate")]),e._v(" option for more control over a "),n("code",[e._v("Candidate")]),e._v(" configuration.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/zookeeper.html#zk-leadership"}},[e._v("Leadership event handling")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"mqtt-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mqtt-changes"}},[e._v("#")]),e._v(" MQTT Changes")]),e._v(" "),n("p",[e._v("The inbound channel adapter can now be configured to provide user control over when a message is acknowledged as being delivered.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt-ack-mode"}},[e._v("Manual Acks")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The outbound adapter now publishes a "),n("code",[e._v("MqttConnectionFailedEvent")]),e._v(" when a connection can’t be created, or is lost.\nPreviously, only the inbound adapter did so.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt-events"}},[e._v("MQTT Events")]),e._v(".")],1),e._v(" "),n("h3",{attrs:{id:"ftp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-changes"}},[e._v("#")]),e._v(" FTP Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileTransferringMessageHandler")]),e._v(" (for FTP and SFTP, for example) in addition to "),n("code",[e._v("File")]),e._v(", "),n("code",[e._v("byte[]")]),e._v(", "),n("code",[e._v("String")]),e._v(" and "),n("code",[e._v("InputStream")]),e._v(" now also supports an "),n("code",[e._v("org.springframework.core.io.Resource")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Support")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"file-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-changes"}},[e._v("#")]),e._v(" File Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileSplitter")]),e._v(" doesn’t require a Jackson processor (or similar) dependency any more for the "),n("code",[e._v("markersJson")]),e._v(" mode.\nIt uses a "),n("code",[e._v("SimpleJsonSerializer")]),e._v(" for a straightforward string representation of the "),n("code",[e._v("FileSplitter.FileMarker")]),e._v(" instances.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-splitter"}},[e._v("FileSplitter")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-5-1-and-5-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-5-1-and-5-2"}},[e._v("#")]),e._v(" Changes between 5.1 and 5.2")]),e._v(" "),n("h3",{attrs:{id:"package-and-class-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#package-and-class-changes"}},[e._v("#")]),e._v(" Package and Class Changes")]),e._v(" "),n("p",[n("code",[e._v("Pausable")]),e._v(" has been moved from "),n("code",[e._v("o.s.i.endpoint")]),e._v(" to "),n("code",[e._v("o.s.i.core")]),e._v(".")]),e._v(" "),n("h3",{attrs:{id:"behavior-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#behavior-changes"}},[e._v("#")]),e._v(" Behavior Changes")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-5.1-to-5.2-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" about behavior changes in this version.")]),e._v(" "),n("h3",{attrs:{id:"new-components-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-3"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("h4",{attrs:{id:"rsocket-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#rsocket-support"}},[e._v("#")]),e._v(" RSocket Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("spring-integration-rsocket")]),e._v(" module is now available with channel adapter implementations for RSocket protocol support.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/rsocket.html#rsocket"}},[e._v("RSocket Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"rate-limit-advice-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#rate-limit-advice-support"}},[e._v("#")]),e._v(" Rate Limit Advice Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RateLimiterRequestHandlerAdvice")]),e._v(" is now available for limiting requests rate on handlers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#rate-limiter-advice"}},[e._v("Rate Limiter Advice")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"caching-advice-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#caching-advice-support"}},[e._v("#")]),e._v(" Caching Advice Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("CacheRequestHandlerAdvice")]),e._v(" is now available for caching request results on handlers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#cache-advice"}},[e._v("Caching Advice")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"kotlin-scripts-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#kotlin-scripts-support"}},[e._v("#")]),e._v(" Kotlin Scripts Support")]),e._v(" "),n("p",[e._v("The JSR223 scripting module now includes a support for Kotlin scripts.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/scripting.html#scripting"}},[e._v("Scripting Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"flux-aggregator-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#flux-aggregator-support"}},[e._v("#")]),e._v(" Flux Aggregator Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FluxAggregatorMessageHandler")]),e._v(" is now available for grouping and windowing messages logic based on the Project Reactor "),n("code",[e._v("Flux")]),e._v(" operators.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#flux-aggregator"}},[e._v("Flux Aggregator")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"ftp-sftp-event-publisher"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-sftp-event-publisher"}},[e._v("#")]),e._v(" FTP/SFTP Event Publisher")]),e._v(" "),n("p",[e._v("The FTP and SFTP modules now provide an event listener for certain Apache Mina FTP/SFTP server events.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-server-events"}},[e._v("Apache Mina FTP Server Events")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-server-events"}},[e._v("Apache Mina SFTP Server Events")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"avro-transformers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#avro-transformers"}},[e._v("#")]),e._v(" Avro Transformers")]),e._v(" "),n("p",[e._v("Simple Apache Avro transformers are now provided.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformers.html#avro-transformers"}},[e._v("Avro Transformers")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"general-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-3"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("JsonToObjectTransformer")]),e._v(" now supports generics for the target object to deserialize into.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#json-transformers"}},[e._v("JSON Transformers")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("splitter")]),e._v(" now supports a "),n("code",[e._v("discardChannel")]),e._v(" configuration option.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/splitter.html#splitter"}},[e._v("Splitter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The Control Bus can now handle "),n("code",[e._v("Pausable")]),e._v(" (extension of "),n("code",[e._v("Lifecycle")]),e._v(") operations.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/control-bus.html#control-bus"}},[e._v("Control Bus")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("Function<MessageGroup, Map<String, Object>>")]),e._v(" strategy has been introduced for the aggregator component to merge and compute headers for output messages.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-api"}},[e._v("Aggregator Programming Model")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("All the "),n("code",[e._v("MessageHandlingException")]),e._v(" s thrown in the framework, includes now a bean resource and source for back tracking a configuration part in case no end-user code involved.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/error-handling.html#error-handling"}},[e._v("Error Handling")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("For better end-user experience, Java DSL now provides a configurer variant for starting flow with a gateway interface.\nSee "),n("code",[e._v("IntegrationFlows.from(Class<?> serviceInterface, Consumer<GatewayProxySpec> endpointConfigurer)")]),e._v(" JavaDocs for more information.\nAlso a "),n("code",[e._v("MethodArgsHolder")]),e._v(" is now a root object for evaluation context for all the expressions in the "),n("code",[e._v("GatewayProxyFactoryBean")]),e._v(".\nThe "),n("code",[e._v("#args")]),e._v(" and "),n("code",[e._v("#method")]),e._v(" evaluation context variables are now deprecated.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway"}},[e._v("Messaging Gateways")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"amqp-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-3"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v('The outbound endpoints can now be configured to synthesize a "nack" if no publisher confirm is received within a timeout.\nSee '),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-outbound-endpoints"}},[e._v("Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The inbound channel adapter can now receive batched messages as a "),n("code",[e._v("List<?>")]),e._v(" payload instead of receiving a discrete message for each batch fragment.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-debatching"}},[e._v("Batched Messages")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The outbound channel adapter can now be configured to block the calling thread until a publisher confirm (acknowledgment) is received.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-outbound-channel-adapter"}},[e._v("Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"file-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-changes-2"}},[e._v("#")]),e._v(" File Changes")]),e._v(" "),n("p",[e._v("Some improvements to filtering remote files have been made.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#remote-persistent-flf"}},[e._v("Remote Persistent File List Filters")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"tcp-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-changes-2"}},[e._v("#")]),e._v(" TCP Changes")]),e._v(" "),n("p",[e._v("The length header used by the "),n("code",[e._v("ByteArrayLengthHeaderSerializer")]),e._v(" can now include the length of the header in addition to the payload.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-codecs"}},[e._v("Message Demarcation (Serializers and Deserializers)")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("When using a "),n("code",[e._v("TcpNioServerConnectionFactory")]),e._v(", priority is now given to accepting new connections over reading from existing connections, but it is configurable.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#note-nio"}},[e._v("About Non-blocking I/O (NIO)")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The outbound gateway has a new property "),n("code",[e._v("closeStreamAfterSend")]),e._v("; when used with a new connection for each request/reply it signals EOF to the server, without closing the connection.\nThis is useful for servers that use the EOF to signal end of message instead of some delimiter in the data.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-gateways"}},[e._v("TCP Gateways")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The client connection factories now support "),n("code",[e._v("connectTimeout")]),e._v(" which causes an exception to be thrown if the connection is not established in that time.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-connection-factory"}},[e._v("TCP Connection Factories")]),e._v(" for more information.")],1),e._v(" "),n("p",[n("code",[e._v("SoftEndOfStreamException")]),e._v(" is now a "),n("code",[e._v("RuntimeException")]),e._v(" instead of extending "),n("code",[e._v("IOException")]),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"mail-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mail-changes-2"}},[e._v("#")]),e._v(" Mail Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("AbstractMailReceiver")]),e._v(" has now an "),n("code",[e._v("autoCloseFolder")]),e._v(" option ("),n("code",[e._v("true")]),e._v(" by default), to disable an automatic folder close after a fetch, but populate "),n("code",[e._v("IntegrationMessageHeaderAccessor.CLOSEABLE_RESOURCE")]),e._v(" header instead for downstream interaction.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#mail-inbound"}},[e._v("Mail-receiving Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"http-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-changes-2"}},[e._v("#")]),e._v(" HTTP Changes")]),e._v(" "),n("p",[e._v("The HTTP inbound endpoint now support a request payload validation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http"}},[e._v("HTTP Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"webflux-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#webflux-changes"}},[e._v("#")]),e._v(" WebFlux Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("WebFluxRequestExecutingMessageHandler")]),e._v(" now supports a "),n("code",[e._v("Publisher")]),e._v(", "),n("code",[e._v("Resource")]),e._v(" and "),n("code",[e._v("MultiValueMap")]),e._v(" as a request message "),n("code",[e._v("payload")]),e._v(".\nThe "),n("code",[e._v("WebFluxInboundEndpoint")]),e._v(" now supports a request payload validation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/webflux.html#webflux"}},[e._v("WebFlux Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"mongodb-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-changes"}},[e._v("#")]),e._v(" MongoDb Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("MongoDbMessageStore")]),e._v(" can now be configured with custom converters.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb"}},[e._v("MongoDB Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"router-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#router-changes"}},[e._v("#")]),e._v(" Router Changes")]),e._v(" "),n("p",[e._v("You can now disable falling back to the channel key as the channel bean name.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/router.html#dynamic-routers"}},[e._v("Dynamic Routers")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"ftp-sftp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-sftp-changes"}},[e._v("#")]),e._v(" FTP/SFTP Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RotatingServerAdvice")]),e._v(" is decoupled now from the "),n("code",[e._v("RotationPolicy")]),e._v(" and its "),n("code",[e._v("StandardRotationPolicy")]),e._v(".")]),e._v(" "),n("p",[e._v("The remote file information, including host/port and directory are included now into message headers in the "),n("code",[e._v("AbstractInboundFileSynchronizingMessageSource")]),e._v(" and "),n("code",[e._v("AbstractRemoteFileStreamingMessageSource")]),e._v(" implementations.\nAlso this information is included into headers in the read operations results of the "),n("code",[e._v("AbstractRemoteFileOutboundGateway")]),e._v(" implementations.\nThe FTP outbound endpoints now support "),n("code",[e._v("chmod")]),e._v(" to change permissions on the uploaded file.\n(SFTP already supported it since version 4.3).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP(S) Support")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-5-0-and-5-1"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-5-0-and-5-1"}},[e._v("#")]),e._v(" Changes between 5.0 and 5.1")]),e._v(" "),n("h4",{attrs:{id:"new-components-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-4"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("The following components are new in 5.1:")]),e._v(" "),n("ul",[n("li",[n("a",{attrs:{href:"#x5.1-AmqpDedicatedChannelAdvice"}},[n("code",[e._v("AmqpDedicatedChannelAdvice")])])])]),e._v(" "),n("h5",{attrs:{id:"amqpdedicatedchanneladvice"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqpdedicatedchanneladvice"}},[e._v("#")]),e._v(" "),n("code",[e._v("AmqpDedicatedChannelAdvice")])]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-strict-ordering"}},[e._v("Strict Message Ordering")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"improved-function-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#improved-function-support"}},[e._v("#")]),e._v(" Improved Function Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("java.util.function")]),e._v(" interfaces now have improved integration support in the Framework components.\nAlso Kotlin lambdas now can be used for handler and source methods.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/functions-support.html#functions-support"}},[n("code",[e._v("java.util.function")]),e._v(" Interfaces Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"longrunningtest"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#longrunningtest"}},[e._v("#")]),e._v(" "),n("code",[e._v("@LongRunningTest")])]),e._v(" "),n("p",[e._v("A JUnit 5 "),n("code",[e._v("@LongRunningTest")]),e._v(" conditional annotation is provided to check the environment or system properties for the "),n("code",[e._v("RUN_LONG_INTEGRATION_TESTS")]),e._v(" entry with the value of "),n("code",[e._v("true")]),e._v(" to determine if test should be run or skipped.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/testing.html#test-junit-rules"}},[e._v("JUnit Rules and Conditions")]),e._v(".")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-4"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("The following changes have been made in version 5.1:")]),e._v(" "),n("ul",[n("li",[n("p",[n("a",{attrs:{href:"#x5.1-java-dsl"}},[e._v("Java DSL")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-dispatcher-exceptions"}},[e._v("Dispatcher Exceptions")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-global-channel-interceptors"}},[e._v("Global Channel Interceptors")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-object-to-json-transformer"}},[n("code",[e._v("ObjectToJsonTransformer")])])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-integration-flows-generated-bean-names"}},[e._v("Integration Flows: Generated Bean Names")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-aggregator"}},[e._v("Aggregator Changes")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x5.1-publisher"}},[e._v("@Publisher annotation changes")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x51.-integration-graph"}},[e._v("Integration Graph Customization")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x51.-global-properties"}},[e._v("Integration Global Properties")])])]),e._v(" "),n("li",[n("p",[n("a",{attrs:{href:"#x51.-poller-annotation"}},[e._v("The "),n("code",[e._v("receiveTimeout")]),e._v(" for "),n("code",[e._v("@Poller")])])])])]),e._v(" "),n("h5",{attrs:{id:"java-dsl"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#java-dsl"}},[e._v("#")]),e._v(" Java DSL")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("IntegrationFlowContext")]),e._v(" is now an interface and "),n("code",[e._v("IntegrationFlowRegistration")]),e._v(" is an inner interface of "),n("code",[e._v("IntegrationFlowContext")]),e._v(".")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("logAndReply()")]),e._v(" operator has been introduced for convenience when you wish to log at the end of a flow for request-reply configurations.\nThis avoid confusion with "),n("code",[e._v("log()")]),e._v(" which is treated as a one-way end flow component.")]),e._v(" "),n("p",[e._v("A generated bean name for any "),n("code",[e._v("NamedComponent")]),e._v(" within an integration flow is now based on the component type for better readability from visual tools, logs analyzers and metrics collectors.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("GenericHandler.handle()")]),e._v(" now excepts a "),n("code",[e._v("MessageHeaders")]),e._v(" type for the second argument.")]),e._v(" "),n("h5",{attrs:{id:"dispatcher-exceptions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#dispatcher-exceptions"}},[e._v("#")]),e._v(" Dispatcher Exceptions")]),e._v(" "),n("p",[e._v("Exceptions caught and re-thrown by "),n("code",[e._v("AbstractDispatcher")]),e._v(" are now more consistent:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("A "),n("code",[e._v("MessagingException")]),e._v(" of any kind that has a "),n("code",[e._v("failedMessage")]),e._v(" property is re-thrown unchanged.")])]),e._v(" "),n("li",[n("p",[e._v("All other exceptions are wrapped in a "),n("code",[e._v("MessageDeliveryException")]),e._v(" with the "),n("code",[e._v("failedMessage")]),e._v(" property set.")])])]),e._v(" "),n("p",[e._v("Previously:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("A "),n("code",[e._v("MessagingException")]),e._v(" of any kind that has a "),n("code",[e._v("failedMessage")]),e._v(" property was re-thrown unchanged")])]),e._v(" "),n("li",[n("p",[e._v("A "),n("code",[e._v("MessagingException")]),e._v(" that had no "),n("code",[e._v("failedMessage")]),e._v(" property was wrapped in a "),n("code",[e._v("MessagingException")]),e._v(" with the "),n("code",[e._v("failedMessage")]),e._v(" property set.")])]),e._v(" "),n("li",[n("p",[e._v("Other "),n("code",[e._v("RuntimeException")]),e._v(" instances were re-thrown unchanged.")])]),e._v(" "),n("li",[n("p",[e._v("Checked exceptions were wrapped in a "),n("code",[e._v("MessageDeliveryException")]),e._v(" with the "),n("code",[e._v("failedMessage")]),e._v(" property set.")])])]),e._v(" "),n("h5",{attrs:{id:"global-channel-interceptors"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#global-channel-interceptors"}},[e._v("#")]),e._v(" Global Channel Interceptors")]),e._v(" "),n("p",[e._v("Global channel interceptors now apply to dynamically registered channels, such as through the "),n("code",[e._v("IntegrationFlowContext")]),e._v(" when using the Java DSL or beans that are initialized using "),n("code",[e._v("beanFactory.initializeBean()")]),e._v(".\nPreviously, when beans were created after the application context was refreshed, interceptors were not applied.")]),e._v(" "),n("h5",{attrs:{id:"channel-interceptors"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#channel-interceptors"}},[e._v("#")]),e._v(" Channel Interceptors")]),e._v(" "),n("p",[n("code",[e._v("ChannelInterceptor.postReceive()")]),e._v(" is no longer called when no message is received; it is no longer necessary to check for a "),n("code",[e._v("null")]),e._v(" "),n("code",[e._v("Message<?>")]),e._v(".\nPreviously, the method was called.\nIf you have an interceptor that relies on the previous behavior, implement "),n("code",[e._v("afterReceiveCompleted()")]),e._v(" instead, since that method is invoked, regardless of whether a message is received or not.\nFurthermore, the "),n("code",[e._v("PolledAmqpChannel")]),e._v(" and "),n("code",[e._v("PolledJmsChannel")]),e._v(" previously did not invoke "),n("code",[e._v("afterReceiveCompleted()")]),e._v(" with "),n("code",[e._v("null")]),e._v("; they now do.")]),e._v(" "),n("h5",{attrs:{id:"objecttojsontransformer"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#objecttojsontransformer"}},[e._v("#")]),e._v(" "),n("code",[e._v("ObjectToJsonTransformer")])]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("ResultType.BYTES")]),e._v(" mode is introduced for the "),n("code",[e._v("ObjectToJsonTransformer")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#json-transformers"}},[e._v("JSON Transformers")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"integration-flows-generated-bean-names"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-flows-generated-bean-names"}},[e._v("#")]),e._v(" Integration Flows: Generated Bean Names")]),e._v(" "),n("p",[e._v("Starting with version 5.0.5, generated bean names for the components in an "),n("code",[e._v("IntegrationFlow")]),e._v(" include the flow bean name, followed by a dot, as a prefix.\nFor example, if a flow bean were named "),n("code",[e._v("flowBean")]),e._v(", a generated bean might be named "),n("code",[e._v("flowBean.generatedBean")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/dsl.html#java-dsl-flows"}},[e._v("Working With Message Flows")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-changes"}},[e._v("#")]),e._v(" Aggregator Changes")]),e._v(" "),n("p",[e._v("If the "),n("code",[e._v("groupTimeout")]),e._v(" is evaluated to a negative value, an aggregator now expires the group immediately.\nOnly "),n("code",[e._v("null")]),e._v(" is considered as a signal to do nothing for the current message.")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("popSequence")]),e._v(" property has been introduced to allow (by default) to call a "),n("code",[e._v("MessageBuilder.popSequenceDetails()")]),e._v(" for the output message.\nAlso an "),n("code",[e._v("AbstractAggregatingMessageGroupProcessor")]),e._v(" returns now an "),n("code",[e._v("AbstractIntegrationMessageBuilder")]),e._v(" instead of the whole "),n("code",[e._v("Message")]),e._v(" for optimization.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"publisher-annotation-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#publisher-annotation-changes"}},[e._v("#")]),e._v(" @Publisher annotation changes")]),e._v(" "),n("p",[e._v("Starting with version 5.1, you must explicitly turn on the "),n("code",[e._v("@Publisher")]),e._v(" AOP functionality by using "),n("code",[e._v("@EnablePublisher")]),e._v(" or by using the "),n("code",[e._v("<int:enable-publisher>")]),e._v(" child element on "),n("code",[e._v("<int:annotation-config>")]),e._v(".\nAlso the "),n("code",[e._v("proxy-target-class")]),e._v(" and "),n("code",[e._v("order")]),e._v(" attributes have been added for tuning the "),n("code",[e._v("ProxyFactory")]),e._v(" configuration.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-publishing.html#publisher-annotation"}},[e._v("Annotation-driven Configuration with the "),n("code",[e._v("@Publisher")]),e._v(" Annotation")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"files-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#files-changes"}},[e._v("#")]),e._v(" Files Changes")]),e._v(" "),n("p",[e._v("If you are using "),n("code",[e._v("FileExistsMode.APPEND")]),e._v(" or "),n("code",[e._v("FileExistsMode.APPEND_NO_FLUSH")]),e._v(" you can provide a "),n("code",[e._v("newFileCallback")]),e._v(" that will be called when creating a new file.\nThis callback receives the newly created file and the message that triggered the callback.\nThis could be used to write a CSV header, for an example.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileReadingMessageSource")]),e._v(" now doesn’t check and create a directory until its "),n("code",[e._v("start()")]),e._v(" is called.\nSo, if an Inbound Channel Adapter for the "),n("code",[e._v("FileReadingMessageSource")]),e._v(" has "),n("code",[e._v("autoStartup = false")]),e._v(", there are no failures against the file system during application start up.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#files"}},[e._v("File Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"amqp-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-4"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("We have made "),n("code",[e._v("ID")]),e._v(" and "),n("code",[e._v("Timestamp")]),e._v(" header mapping changes in the "),n("code",[e._v("DefaultAmqpHeaderMapper")]),e._v(".\nSee the note near the bottom of "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-message-headers"}},[e._v("AMQP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("contentType")]),e._v(" header is now correctly mapped as an entry in the general headers map.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-content-type"}},[e._v("contentType Header")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("Starting with version 5.1.3, if a message conversion exception occurs when using manual acknowledgments, and an error channel is defined, the payload is a "),n("code",[e._v("ManualAckListenerExecutionFailedException")]),e._v(" with additional "),n("code",[e._v("channel")]),e._v(" and "),n("code",[e._v("deliveryTag")]),e._v(" properties.\nThis enables the error flow to ack/nack the original message.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-conversion-inbound"}},[e._v("Inbound Message Conversion")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"jdbc-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-changes"}},[e._v("#")]),e._v(" JDBC Changes")]),e._v(" "),n("p",[e._v("A confusing "),n("code",[e._v("max-rows-per-poll")]),e._v(" property on the JDBC Inbound Channel Adapter and JDBC Outbound Gateway has been deprecated in favor of the newly introduced "),n("code",[e._v("max-rows")]),e._v(" property.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("JdbcMessageHandler")]),e._v(" supports now a "),n("code",[e._v("batchUpdate")]),e._v(" functionality when the payload of the request message is an instance of an "),n("code",[e._v("Iterable")]),e._v(" type.")]),e._v(" "),n("p",[e._v("The indexes for the "),n("code",[e._v("INT_CHANNEL_MESSAGE")]),e._v(" table (for the "),n("code",[e._v("JdbcChannelMessageStore")]),e._v(") have been optimized.\nIf you have large message groups in such a store, you may wish to alter the indexes.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc"}},[e._v("JDBC Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"ftp-and-sftp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-changes"}},[e._v("#")]),e._v(" FTP and SFTP Changes")]),e._v(" "),n("p",[e._v("A "),n("code",[e._v("RotatingServerAdvice")]),e._v(" is now available to poll multiple servers and directories with the inbound channel adapters.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-rotating-server-advice"}},[e._v("Inbound Channel Adapters: Polling Multiple Servers and Directories")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-rotating-server-advice"}},[e._v("Inbound Channel Adapters: Polling Multiple Servers and Directories")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("Also, inbound adapter "),n("code",[e._v("localFilenameExpression")]),e._v(" instances can contain the "),n("code",[e._v("#remoteDirectory")]),e._v(" variable, which contains the remote directory being polled.\nThe generic type of the comparators (used to sort the fetched file list for the streaming adapters) has changed from "),n("code",[e._v("Comparator<AbstractFileInfo<F>>")]),e._v(" to "),n("code",[e._v("Comparator<F>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-streaming"}},[e._v("FTP Streaming Inbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-streaming"}},[e._v("SFTP Streaming Inbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("In addition, the synchronizers for inbound channel adapters can now be provided with a "),n("code",[e._v("Comparator")]),e._v(".\nThis is useful when using "),n("code",[e._v("maxFetchSize")]),e._v(" to limit the files retrieved.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("CachingSessionFactory")]),e._v(" has a new property "),n("code",[e._v("testSession")]),e._v(" which, when true, causes the factory to perform a "),n("code",[e._v("test()")]),e._v(" operation on the "),n("code",[e._v("Session")]),e._v(" when checking out an existing session from the cache.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-session-caching"}},[e._v("SFTP Session Caching")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-session-caching"}},[e._v("FTP Session Caching")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The outbound gateway MPUT command now supports a message payload with a collection of files or strings.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-outbound-gateway"}},[e._v("SFTP Outbound Gateway")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-outbound-gateway"}},[e._v("FTP Outbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"tcp-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-support"}},[e._v("#")]),e._v(" TCP Support")]),e._v(" "),n("p",[e._v("When using SSL, host verification is now enabled, by default, to prevent man-in-the-middle attacks with a trusted certificate.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-ssl-host-verification"}},[e._v("Host Verification")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("In addition the key and trust store types can now be configured on the "),n("code",[e._v("DefaultTcpSSLContextSupport")]),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"twitter-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#twitter-support"}},[e._v("#")]),e._v(" Twitter Support")]),e._v(" "),n("p",[e._v("Since the Spring Social project has moved to "),n("a",{attrs:{href:"https://spring.io/blog/2018/07/03/spring-social-end-of-life-announcement",target:"_blank",rel:"noopener noreferrer"}},[e._v("end of life status"),n("OutboundLink")],1),e._v(", Twitter support in Spring Integration has been moved to the Extensions project.\nSee "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-extensions/tree/main/spring-integration-social-twitter",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration Social Twitter"),n("OutboundLink")],1),e._v(" for more information.")]),e._v(" "),n("h4",{attrs:{id:"jms-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-support"}},[e._v("#")]),e._v(" JMS Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("JmsSendingMessageHandler")]),e._v(" now provides "),n("code",[e._v("deliveryModeExpression")]),e._v(" and "),n("code",[e._v("timeToLiveExpression")]),e._v(" options to determine respective QoS options for JMS message to send at runtime.\nThe "),n("code",[e._v("DefaultJmsHeaderMapper")]),e._v(" now allows to map inbound "),n("code",[e._v("JMSDeliveryMode")]),e._v(" and "),n("code",[e._v("JMSExpiration")]),e._v(" properties via setting to "),n("code",[e._v("true")]),e._v(" respective "),n("code",[e._v("setMapInboundDeliveryMode()")]),e._v(" and "),n("code",[e._v("setMapInboundExpiration()")]),e._v(" options.\nWhen a "),n("code",[e._v("JmsMessageDrivenEndpoint")]),e._v(" or "),n("code",[e._v("JmsInboundGateway")]),e._v(" is stopped, the associated listener container is now shut down; this closes its shared connection and any consumers.\nYou can configure the endpoints to revert to the previous behavior.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms"}},[e._v("JMS Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"http-webflux-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-webflux-support"}},[e._v("#")]),e._v(" HTTP/WebFlux Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("statusCodeExpression")]),e._v(" (and "),n("code",[e._v("Function")]),e._v(") is now supplied with the "),n("code",[e._v("RequestEntity<?>")]),e._v(" as a root object for evaluation context, so request headers, method, URI and body are available for target status code calculation.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http"}},[e._v("HTTP Support")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/webflux.html#webflux"}},[e._v("WebFlux Support")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"jmx-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jmx-changes"}},[e._v("#")]),e._v(" JMX Changes")]),e._v(" "),n("p",[e._v("Object name key values are now quoted if they contain any characters other than those allowed in a Java identifier (or period "),n("code",[e._v(".")]),e._v(").\nFor example "),n("code",[e._v("org.springframework.integration:type=MessageChannel,")]),e._v(" "),n("code",[e._v('name="input:foo.myGroup.errors"')]),e._v('.\nThis has the side effect that previously "allowed" names, with such characters, will now be quoted.\nFor example '),n("code",[e._v("org.springframework.integration:type=MessageChannel,")]),e._v(" "),n("code",[e._v('name="input#foo.myGroup.errors"')]),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"micrometer-support-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#micrometer-support-changes"}},[e._v("#")]),e._v(" Micrometer Support Changes")]),e._v(" "),n("p",[e._v("It is now simpler to customize the standard Micrometer meters created by the framework.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/metrics.html#micrometer-integration"}},[e._v("Micrometer Integration")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"integration-graph-customization"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-graph-customization"}},[e._v("#")]),e._v(" Integration Graph Customization")]),e._v(" "),n("p",[e._v("It is now possible to add additional properties to the "),n("code",[e._v("IntegrationNode")]),e._v(" s via "),n("code",[e._v("Function<NamedComponent, Map<String, Object>> additionalPropertiesCallback")]),e._v(" on the "),n("code",[e._v("IntegrationGraphServer")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/graph.html#integration-graph"}},[e._v("Integration Graph")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"integration-global-properties"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-global-properties"}},[e._v("#")]),e._v(" Integration Global Properties")]),e._v(" "),n("p",[e._v("The Integration global properties (including defaults) can now be printed in the logs, when a "),n("code",[e._v("DEBUG")]),e._v(" logic level is turned on for the "),n("code",[e._v("org.springframework.integration")]),e._v(" category.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#global-properties"}},[e._v("Global Properties")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"the-receivetimeout-for-poller"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#the-receivetimeout-for-poller"}},[e._v("#")]),e._v(" The "),n("code",[e._v("receiveTimeout")]),e._v(" for "),n("code",[e._v("@Poller")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("@Poller")]),e._v(" annotation now provides a "),n("code",[e._v("receiveTimeout")]),e._v(" option for convenience.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#configuration-using-poller-annotation"}},[e._v("Using the "),n("code",[e._v("@Poller")]),e._v(" Annotation")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-4-3-and-5-0"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-4-3-and-5-0"}},[e._v("#")]),e._v(" Changes between 4.3 and 5.0")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-4.3-to-5.0-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-5"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-5"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 5.0 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"java-dsl-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#java-dsl-2"}},[e._v("#")]),e._v(" Java DSL")]),e._v(" "),n("p",[e._v("The separate "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-java-dsl",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration Java DSL"),n("OutboundLink")],1),e._v(" project has now been merged into the core Spring Integration project.\nThe "),n("code",[e._v("IntegrationComponentSpec")]),e._v(" implementations for channel adapters and gateways are distributed to their specific modules.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/dsl.html#java-dsl"}},[e._v("Java DSL")]),e._v(" for more information about Java DSL support.\nSee also the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-4.3-to-5.0-Migration-Guide#java-dsl",target:"_blank",rel:"noopener noreferrer"}},[e._v("4.3 to 5.0 Migration Guide"),n("OutboundLink")],1),e._v(" for the required steps to move to Spring Integration 5.0.")],1),e._v(" "),n("h5",{attrs:{id:"testing-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#testing-support"}},[e._v("#")]),e._v(" Testing Support")]),e._v(" "),n("p",[e._v("We created a new Spring Integration Test Framework to help with testing Spring Integration applications.\nNow, with the "),n("code",[e._v("@SpringIntegrationTest")]),e._v(" annotation on test classes and the "),n("code",[e._v("MockIntegration")]),e._v(" factory, you can make your JUnit tests for integration flows somewhat easier.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/testing.html#testing"}},[e._v("Testing support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mongodb-outbound-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-outbound-gateway"}},[e._v("#")]),e._v(" MongoDB Outbound Gateway")]),e._v(" "),n("p",[e._v("The new "),n("code",[e._v("MongoDbOutboundGateway")]),e._v(" lets you make queries to the database on demand by sending a message to its request channel.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb-outbound-gateway"}},[e._v("MongoDB Outbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"webflux-gateways-and-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#webflux-gateways-and-channel-adapters"}},[e._v("#")]),e._v(" WebFlux Gateways and Channel Adapters")]),e._v(" "),n("p",[e._v("We introduced the new WebFlux support module for Spring WebFlux Framework gateways and channel adapters.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/webflux.html#webflux"}},[e._v("WebFlux Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"content-type-conversion"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#content-type-conversion"}},[e._v("#")]),e._v(" Content Type Conversion")]),e._v(" "),n("p",[e._v("Now that we use the new "),n("code",[e._v("InvocableHandlerMethod")]),e._v("-based infrastructure for service method invocations, we can perform "),n("code",[e._v("contentType")]),e._v(" conversion from the payload to a target method argument.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/endpoint.html#content-type-conversion"}},[e._v("Content Type Conversion")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"errormessagepublisher-and-errormessagestrategy"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#errormessagepublisher-and-errormessagestrategy"}},[e._v("#")]),e._v(" "),n("code",[e._v("ErrorMessagePublisher")]),e._v(" and "),n("code",[e._v("ErrorMessageStrategy")])]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("ErrorMessagePublisher")]),e._v(" and the "),n("code",[e._v("ErrorMessageStrategy")]),e._v(" for creating "),n("code",[e._v("ErrorMessage")]),e._v(" instances.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/error-handling.html#error-handling"}},[e._v("Error Handling")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"jdbc-metadata-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-metadata-store"}},[e._v("#")]),e._v(" JDBC Metadata Store")]),e._v(" "),n("p",[e._v("We added a JDBC implementation of the "),n("code",[e._v("MetadataStore")]),e._v(" implementation.\nThis is useful when you need to ensure transactional boundaries for metadata.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-metadata-store"}},[e._v("JDBC Metadata Store")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-5"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-5"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("Spring Integration is now fully based on Spring Framework "),n("code",[e._v("5.0")]),e._v(" and Project Reactor "),n("code",[e._v("3.1")]),e._v(".\nPrevious Project Reactor versions are no longer supported.")]),e._v(" "),n("h5",{attrs:{id:"core-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#core-changes"}},[e._v("#")]),e._v(" Core Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("@Poller")]),e._v(" annotation now has the "),n("code",[e._v("errorChannel")]),e._v(" attribute for easier configuration of the underlying "),n("code",[e._v("MessagePublishingErrorHandler")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("All the request-reply endpoints (based on "),n("code",[e._v("AbstractReplyProducingMessageHandler")]),e._v(") can now start transactions and, therefore, make the whole downstream flow transactional.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#tx-handle-message-advice"}},[e._v("Transaction Support")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("SmartLifecycleRoleController")]),e._v(" now provides methods to obtain status of endpoints in roles.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/endpoint.html#endpoint-roles"}},[e._v("Endpoint Roles")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("By default, POJO methods are now invoked by using an "),n("code",[e._v("InvocableHandlerMethod")]),e._v(", but you can configure them to use SpEL, as before.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/overview.html#pojo-invocation"}},[e._v("POJO Method invocation")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("When targeting POJO methods as message handlers, you can now mark one of the service methods with the "),n("code",[e._v("@Default")]),e._v(" annotation to provide a fallback mechanism for non-matched conditions.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/service-activator.html#service-activator-namespace"}},[e._v("Configuring Service Activator")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("We added a simple "),n("code",[e._v("PassThroughTransactionSynchronizationFactory")]),e._v(" to always store a polled message in the current transaction context.\nThat message is used as a "),n("code",[e._v("failedMessage")]),e._v(" property of the "),n("code",[e._v("MessagingException")]),e._v(", which wraps any raw exception thrown during transaction completion.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transactions.html#transaction-synchronization"}},[e._v("Transaction Synchronization")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The aggregator expression-based "),n("code",[e._v("ReleaseStrategy")]),e._v(" now evaluates the expression against the "),n("code",[e._v("MessageGroup")]),e._v(" instead of just the collection of "),n("code",[e._v("Message<?>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-spel"}},[e._v("Aggregators and Spring Expression Language (SpEL)")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("You can now supply the "),n("code",[e._v("ObjectToMapTransformer")]),e._v(" with a customized "),n("code",[e._v("JsonObjectMapper")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-spel"}},[e._v("Aggregators and Spring Expression Language (SpEL)")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("@GlobalChannelInterceptor")]),e._v(" annotation and "),n("code",[e._v("<int:channel-interceptor>")]),e._v(" now support negative patterns (via "),n("code",[e._v("!")]),e._v(" prepending) for component names matching.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#global-channel-configuration-interceptors"}},[e._v("Global Channel Interceptor Configuration")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("When a candidate failed to acquire the lock, the "),n("code",[e._v("LockRegistryLeaderInitiator")]),e._v(" now emits a new "),n("code",[e._v("OnFailedToAcquireMutexEvent")]),e._v(" through "),n("code",[e._v("DefaultLeaderEventPublisher")]),e._v(".\nSee "),n("code",[e._v("[Leadership Event Handling](./endpoint.html#leadership-event-handling)")]),e._v(" for more information.")]),e._v(" "),n("h5",{attrs:{id:"gateway-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gateway-changes"}},[e._v("#")]),e._v(" Gateway Changes")]),e._v(" "),n("p",[e._v("When the gateway method has a "),n("code",[e._v("void")]),e._v(" return type and an error channel is provided, the gateway now correctly sets the "),n("code",[e._v("errorChannel")]),e._v(" header.\nPreviously, the header was not populated.\nThis caused synchronous downstream flows (running on the calling thread) to send the exception to the configured channel, but an exception on an asynchronous downstream flow would be sent to the default "),n("code",[e._v("errorChannel")]),e._v(" instead.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RequestReplyExchanger")]),e._v(" interface now has a "),n("code",[e._v("throws MessagingException")]),e._v(" clause to meet the proposed messages exchange contract.")]),e._v(" "),n("p",[e._v("You can now specify the request and reply timeouts with SpEL expressions.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway"}},[e._v("Messaging Gateways")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-performance-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-performance-changes"}},[e._v("#")]),e._v(" Aggregator Performance Changes")]),e._v(" "),n("p",[e._v("By default, aggregators now use a "),n("code",[e._v("SimpleSequenceSizeReleaseStrategy")]),e._v(", which is more efficient, especially with large groups.\nEmpty groups are now scheduled for removal after "),n("code",[e._v("empty-group-min-timeout")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"splitter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#splitter-changes"}},[e._v("#")]),e._v(" Splitter Changes")]),e._v(" "),n("p",[e._v("The splitter component can now handle and split Java "),n("code",[e._v("Stream")]),e._v(" and Reactive Streams "),n("code",[e._v("Publisher")]),e._v(" objects.\nIf the output channel is a "),n("code",[e._v("ReactiveStreamsSubscribableChannel")]),e._v(", the "),n("code",[e._v("AbstractMessageSplitter")]),e._v(" builds a "),n("code",[e._v("Flux")]),e._v(" for subsequent iteration instead of a regular "),n("code",[e._v("Iterator")]),e._v(", independent of the object being split.\nIn addition, "),n("code",[e._v("AbstractMessageSplitter")]),e._v(" provides "),n("code",[e._v("protected obtainSizeIfPossible()")]),e._v(" methods to allow determination of the size of the "),n("code",[e._v("Iterable")]),e._v(" and "),n("code",[e._v("Iterator")]),e._v(" objects, if that is possible.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/splitter.html#splitter"}},[e._v("Splitter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"jms-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-changes"}},[e._v("#")]),e._v(" JMS Changes")]),e._v(" "),n("p",[e._v("Previously, Spring Integration JMS XML configuration used a default bean name of "),n("code",[e._v("connectionFactory")]),e._v(" for the JMS connection factory, letting the property be omitted from component definitions.\nWe renamed it to "),n("code",[e._v("jmsConnectionFactory")]),e._v(", which is the bean name used by Spring Boot to auto-configure the JMS connection factory bean.")]),e._v(" "),n("p",[e._v("If your application relies on the previous behavior, you can rename your "),n("code",[e._v("connectionFactory")]),e._v(" bean to "),n("code",[e._v("jmsConnectionFactory")]),e._v(" or specifically configure your components to use your bean by using its current name.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms"}},[e._v("JMS Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mail-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mail-changes-3"}},[e._v("#")]),e._v(" Mail Changes")]),e._v(" "),n("p",[e._v("Some inconsistencies with rendering IMAP mail content have been resolved.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#imap-format-important"}},[e._v("the note in the “Mail-receiving Channel Adapter” section")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"feed-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#feed-changes"}},[e._v("#")]),e._v(" Feed Changes")]),e._v(" "),n("p",[e._v("Instead of the "),n("code",[e._v("com.rometools.fetcher.FeedFetcher")]),e._v(", which is deprecated in ROME, we introduced a new "),n("code",[e._v("Resource")]),e._v(" property for the "),n("code",[e._v("FeedEntryMessageSource")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/feed.html#feed"}},[e._v("Feed Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"file-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-changes-3"}},[e._v("#")]),e._v(" File Changes")]),e._v(" "),n("p",[e._v("We introduced the new "),n("code",[e._v("FileHeaders.RELATIVE_PATH")]),e._v(" message header to represent relative path in "),n("code",[e._v("FileReadingMessageSource")]),e._v(".")]),e._v(" "),n("p",[e._v("The tail adapter now supports "),n("code",[e._v("idleEventInterval")]),e._v(" to emit events when there is no data in the file during that period.")]),e._v(" "),n("p",[e._v("The flush predicates for the "),n("code",[e._v("FileWritingMessageHandler")]),e._v(" now have an additional parameter.")]),e._v(" "),n("p",[e._v("The file outbound channel adapter and gateway ("),n("code",[e._v("FileWritingMessageHandler")]),e._v(") now support the "),n("code",[e._v("REPLACE_IF_MODIFIED")]),e._v(" "),n("code",[e._v("FileExistsMode")]),e._v(".")]),e._v(" "),n("p",[e._v("They also now support setting file permissions on the newly written file.")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("FileSystemMarkerFilePresentFileListFilter")]),e._v(" is now available.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-incomplete"}},[e._v("Dealing With Incomplete Data")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileSplitter")]),e._v(" now provides a "),n("code",[e._v("firstLineAsHeader")]),e._v(" option to carry the first line of content as a header in the messages emitted for the remaining lines.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#files"}},[e._v("File Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-sftp-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-changes-2"}},[e._v("#")]),e._v(" FTP and SFTP Changes")]),e._v(" "),n("p",[e._v("The inbound channel adapters now have a property called "),n("code",[e._v("max-fetch-size")]),e._v(", which is used to limit the number of files fetched during a poll when no files are currently in the local directory.\nBy default, they also are configured with a "),n("code",[e._v("FileSystemPersistentAcceptOnceFileListFilter")]),e._v(" in the "),n("code",[e._v("local-filter")]),e._v(".")]),e._v(" "),n("p",[e._v("You can also provide a custom "),n("code",[e._v("DirectoryScanner")]),e._v(" implementation to inbound channel adapters by setting the newly introduced "),n("code",[e._v("scanner")]),e._v(" attribute.")]),e._v(" "),n("p",[e._v("You can now configure the regex and pattern filters to always pass directories.\nThis can be useful when you use recursion in the outbound gateways.")]),e._v(" "),n("p",[e._v("By default, all the inbound channel adapters (streaming and synchronization-based) now use an appropriate "),n("code",[e._v("AbstractPersistentAcceptOnceFileListFilter")]),e._v(" implementation to prevent duplicate downloads of remote files.")]),e._v(" "),n("p",[e._v("The FTP and SFTP outbound gateways now support the "),n("code",[e._v("REPLACE_IF_MODIFIED")]),e._v(" "),n("code",[e._v("FileExistsMode")]),e._v(" when fetching remote files.")]),e._v(" "),n("p",[e._v("The FTP and SFTP streaming inbound channel adapters now add remote file information in a message header.")]),e._v(" "),n("p",[e._v("The FTP and SFTP outbound channel adapters (as well as the "),n("code",[e._v("PUT")]),e._v(" command for outbound gateways) now support "),n("code",[e._v("InputStream")]),e._v(" as "),n("code",[e._v("payload")]),e._v(", too.")]),e._v(" "),n("p",[e._v("The inbound channel adapters can now build file trees locally by using a newly introduced "),n("code",[e._v("RecursiveDirectoryScanner")]),e._v(".\nSee the "),n("code",[e._v("scanner")]),e._v(" option in the "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-inbound"}},[e._v("FTP Inbound Channel Adapter")]),e._v(" section for injection.\nAlso, you can now switch these adapters to the "),n("code",[e._v("WatchService")]),e._v(" instead.")],1),e._v(" "),n("p",[e._v("We added The "),n("code",[e._v("NLST")]),e._v(" command to the "),n("code",[e._v("AbstractRemoteFileOutboundGateway")]),e._v(" to perform the list files names remote command.")]),e._v(" "),n("p",[e._v("You can now supply the "),n("code",[e._v("FtpOutboundGateway")]),e._v(" with "),n("code",[e._v("workingDirExpression")]),e._v(" to change the FTP client working directory for the current request message.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RemoteFileTemplate")]),e._v(" is supplied now with the "),n("code",[e._v("invoke(OperationsCallback<F, T> action)")]),e._v(" to perform several "),n("code",[e._v("RemoteFileOperations")]),e._v(" calls in the scope of the same, thread-bounded, "),n("code",[e._v("Session")]),e._v(".")]),e._v(" "),n("p",[e._v("We added new filters for detecting incomplete remote files.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FtpOutboundGateway")]),e._v(" and "),n("code",[e._v("SftpOutboundGateway")]),e._v(" now support an option to remove the remote file after a successful transfer by using the "),n("code",[e._v("GET")]),e._v(" or "),n("code",[e._v("MGET")]),e._v(" commands.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"integration-properties"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-properties"}},[e._v("#")]),e._v(" Integration Properties")]),e._v(" "),n("p",[e._v("Version 4.3.2 added a new "),n("code",[e._v("spring.integration.readOnly.headers")]),e._v(" global property to let you customize the list of headers that should not be copied to a newly created "),n("code",[e._v("Message")]),e._v(" by the "),n("code",[e._v("MessageBuilder")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#global-properties"}},[e._v("Global Properties")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"stream-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stream-changes"}},[e._v("#")]),e._v(" Stream Changes")]),e._v(" "),n("p",[e._v("We added a new option on the "),n("code",[e._v("CharacterStreamReadingMessageSource")]),e._v(" to let it be used to “pipe” stdin and publish an application event when the pipe is closed.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/stream.html#stream-reading"}},[e._v("Reading from Streams")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"barrier-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#barrier-changes"}},[e._v("#")]),e._v(" Barrier Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("BarrierMessageHandler")]),e._v(" now supports a discard channel to which late-arriving trigger messages are sent.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/barrier.html#barrier"}},[e._v("Thread Barrier")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"amqp-changes-5"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-5"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("The AMQP outbound endpoints now support setting a delay expression when you use the RabbitMQ Delayed Message Exchange plugin.")]),e._v(" "),n("p",[e._v("The inbound endpoints now support the Spring AMQP "),n("code",[e._v("DirectMessageListenerContainer")]),e._v(".")]),e._v(" "),n("p",[e._v("Pollable AMQP-backed channels now block the poller thread for the poller’s configured "),n("code",[e._v("receiveTimeout")]),e._v(" (default: one second).")]),e._v(" "),n("p",[e._v("Headers, such as "),n("code",[e._v("contentType")]),e._v(", that are added to message properties by the message converter are now used in the final message.\nPreviously, it depended on the converter type as to which headers and message properties appeared in the final message.\nTo override the headers set by the converter, set the "),n("code",[e._v("headersMappedLast")]),e._v(" property to "),n("code",[e._v("true")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp"}},[e._v("AMQP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"http-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-changes-3"}},[e._v("#")]),e._v(" HTTP Changes")]),e._v(" "),n("p",[e._v("By default, the "),n("code",[e._v("DefaultHttpHeaderMapper.userDefinedHeaderPrefix")]),e._v(" property is now an empty string instead of "),n("code",[e._v("X-")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-header-mapping"}},[e._v("HTTP Header Mappings")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("By default, "),n("code",[e._v("uriVariablesExpression")]),e._v(" now uses a "),n("code",[e._v("SimpleEvaluationContext")]),e._v(" (since 5.0.4).")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#mapping-uri-variables"}},[e._v("Mapping URI Variables")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mqtt-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mqtt-changes-2"}},[e._v("#")]),e._v(" MQTT Changes")]),e._v(" "),n("p",[e._v("Inbound messages are now mapped with the "),n("code",[e._v("RECEIVED_TOPIC")]),e._v(", "),n("code",[e._v("RECEIVED_QOS")]),e._v(", and "),n("code",[e._v("RECEIVED_RETAINED")]),e._v(" headers to avoid inadvertent propagation to outbound messages when an application relays messages.")]),e._v(" "),n("p",[e._v("The outbound channel adapter now supports expressions for the topic, qos, and retained properties.\nThe defaults remain the same.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt"}},[e._v("MQTT Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"stomp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stomp-changes"}},[e._v("#")]),e._v(" STOMP Changes")]),e._v(" "),n("p",[e._v("We changed the STOMP module to use "),n("code",[e._v("ReactorNettyTcpStompClient")]),e._v(", based on the Project Reactor "),n("code",[e._v("3.1")]),e._v(" and "),n("code",[e._v("reactor-netty")]),e._v(" extension.\nWe renamed "),n("code",[e._v("Reactor2TcpStompSessionManager")]),e._v(" to "),n("code",[e._v("ReactorNettyTcpStompSessionManager")]),e._v(", according to the "),n("code",[e._v("ReactorNettyTcpStompClient")]),e._v(" foundation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/stomp.html#stomp"}},[e._v("STOMP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"web-services-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#web-services-changes-2"}},[e._v("#")]),e._v(" Web Services Changes")]),e._v(" "),n("p",[e._v("You can now supply "),n("code",[e._v("WebServiceOutboundGateway")]),e._v(" instances with an externally configured "),n("code",[e._v("WebServiceTemplate")]),e._v(" instances.")]),e._v(" "),n("p",[n("code",[e._v("DefaultSoapHeaderMapper")]),e._v(" can now map a "),n("code",[e._v("javax.xml.transform.Source")]),e._v(" user-defined header to a SOAP header element.")]),e._v(" "),n("p",[e._v("Simple WebService inbound and outbound gateways can now deal with the complete "),n("code",[e._v("WebServiceMessage")]),e._v(" as a "),n("code",[e._v("payload")]),e._v(", allowing the manipulation of MTOM attachments.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ws.html#ws"}},[e._v("Web Services Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"redis-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-changes"}},[e._v("#")]),e._v(" Redis Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RedisStoreWritingMessageHandler")]),e._v(" is supplied now with additional "),n("code",[e._v("String")]),e._v("-based setters for SpEL expressions (for convenience with Java configuration).\nYou can now configure the "),n("code",[e._v("zsetIncrementExpression")]),e._v(" on the "),n("code",[e._v("RedisStoreWritingMessageHandler")]),e._v(" as well.\nIn addition, this property has been changed from "),n("code",[e._v("true")]),e._v(" to "),n("code",[e._v("false")]),e._v(" since the "),n("code",[e._v("INCR")]),e._v(" option on "),n("code",[e._v("ZADD")]),e._v(" Redis command is optional.")]),e._v(" "),n("p",[e._v("You can now supply the "),n("code",[e._v("RedisInboundChannelAdapter")]),e._v(" with an "),n("code",[e._v("Executor")]),e._v(" for executing Redis listener invokers.\nIn addition, the received messages now contain a "),n("code",[e._v("RedisHeaders.MESSAGE_SOURCE")]),e._v(" header to indicate the source of the message (topic or pattern).")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis"}},[e._v("Redis Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"tcp-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-changes-3"}},[e._v("#")]),e._v(" TCP Changes")]),e._v(" "),n("p",[e._v("We added a new "),n("code",[e._v("ThreadAffinityClientConnectionFactory")]),e._v(" to bind TCP connections to threads.")]),e._v(" "),n("p",[e._v("You can now configure the TCP connection factories to support "),n("code",[e._v("PushbackInputStream")]),e._v(" instances, letting deserializers “unread” (push back) bytes after “reading ahead”.")]),e._v(" "),n("p",[e._v("We added a "),n("code",[e._v("ByteArrayElasticRawDeserializer")]),e._v(" without "),n("code",[e._v("maxMessageSize")]),e._v(" to control and buffer incoming data as needed.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip"}},[e._v("TCP and UDP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"gemfire-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gemfire-changes"}},[e._v("#")]),e._v(" Gemfire Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("GemfireMetadataStore")]),e._v(" now implements "),n("code",[e._v("ListenableMetadataStore")]),e._v(", letting you listen to cache events by providing "),n("code",[e._v("MetadataStoreListener")]),e._v(" instances to the store.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gemfire.html#gemfire"}},[e._v("Pivotal GemFire and Apache Geode Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"jdbc-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-changes-2"}},[e._v("#")]),e._v(" JDBC Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("JdbcMessageChannelStore")]),e._v(" now provides a setter for "),n("code",[e._v("ChannelMessageStorePreparedStatementSetter")]),e._v(", letting you customize message insertion in the store.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ExpressionEvaluatingSqlParameterSourceFactory")]),e._v(" now provides a setter for "),n("code",[e._v("sqlParameterTypes")]),e._v(", letting you customize the SQL types of the parameters.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc"}},[e._v("JDBC Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"metrics-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#metrics-changes"}},[e._v("#")]),e._v(" Metrics Changes")]),e._v(" "),n("p",[n("a",{attrs:{href:"https://micrometer.io/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Micrometer"),n("OutboundLink")],1),e._v(" application monitoring is now supported (since version 5.0.2).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/metrics.html#micrometer-integration"}},[e._v("Micrometer Integration")]),e._v(" for more information.")],1),e._v(" "),n("table",[n("thead",[n("tr",[n("th"),e._v(" "),n("th",[e._v("Changes were made to the Micrometer "),n("code",[e._v("Meters")]),e._v(" in version 5.0.3 to make them more suitable for use in dimensional systems."),n("br"),e._v("Further changes were made in 5.0.4."),n("br"),e._v("If you use Micrometer, we recommend a minimum of version 5.0.4.")])])]),e._v(" "),n("tbody")]),e._v(" "),n("h5",{attrs:{id:"endpointid-annotations"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#endpointid-annotations"}},[e._v("#")]),e._v(" "),n("code",[e._v("@EndpointId")]),e._v(" Annotations")]),e._v(" "),n("p",[e._v("Introduced in version 5.0.4, this annotation provides control over bean naming when you use Java configuration.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/overview.html#endpoint-bean-names"}},[e._v("Endpoint Bean Names")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-4-2-and-4-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-4-2-and-4-3"}},[e._v("#")]),e._v(" Changes between 4.2 and 4.3")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-4.2-to-4.3-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v("for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("Wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-6"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-6"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 4.3 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"amqp-async-outbound-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-async-outbound-gateway"}},[e._v("#")]),e._v(" AMQP Async Outbound Gateway")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-async-outbound-gateway"}},[e._v("Asynchronous Outbound Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"messagegroupfactory"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#messagegroupfactory"}},[e._v("#")]),e._v(" "),n("code",[e._v("MessageGroupFactory")])]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("MessageGroupFactory")]),e._v(" strategy to allow control over "),n("code",[e._v("MessageGroup")]),e._v(" instances in "),n("code",[e._v("MessageGroupStore")]),e._v(" logic.\nWe added "),n("code",[e._v("SimpleMessageGroupFactory")]),e._v(" implementation for the "),n("code",[e._v("SimpleMessageGroup")]),e._v(", with the "),n("code",[e._v("GroupType.HASH_SET")]),e._v(" as the default\nfactory for the standard "),n("code",[e._v("MessageGroupStore")]),e._v(" implementations.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-store.html#message-store"}},[e._v("Message Store")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"persistentmessagegroup"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#persistentmessagegroup"}},[e._v("#")]),e._v(" "),n("code",[e._v("PersistentMessageGroup")])]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("PersistentMessageGroup")]),e._v(" (lazy-load proxy) implementation for persistent "),n("code",[e._v("MessageGroupStore")]),e._v(" instances,\nwhich return this instance for the "),n("code",[e._v("getMessageGroup()")]),e._v(" when their "),n("code",[e._v("lazyLoadMessageGroups")]),e._v(" is "),n("code",[e._v("true")]),e._v(" (the default).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-store.html#message-store"}},[e._v("Message Store")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-sftp-streaming-inbound-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-streaming-inbound-channel-adapters"}},[e._v("#")]),e._v(" FTP and SFTP Streaming Inbound Channel Adapters")]),e._v(" "),n("p",[e._v("We added inbound channel adapters that return an "),n("code",[e._v("InputStream")]),e._v(" for each file, letting you retrieve remote files without writing them to the local file system.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-streaming"}},[e._v("FTP Streaming Inbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-streaming"}},[e._v("SFTP Streaming Inbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"streamtransformer"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#streamtransformer"}},[e._v("#")]),e._v(" "),n("code",[e._v("StreamTransformer")])]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("StreamTransformer")]),e._v(" to transform an "),n("code",[e._v("InputStream")]),e._v(" payload to either a "),n("code",[e._v("byte[]")]),e._v(" or a "),n("code",[e._v("String")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#stream-transformer"}},[e._v("Stream Transformer")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"integration-graph"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integration-graph"}},[e._v("#")]),e._v(" Integration Graph")]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("IntegrationGraphServer")]),e._v(", together with the "),n("code",[e._v("IntegrationGraphController")]),e._v(" REST service, to expose the runtime model of a Spring Integration application as a graph.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/graph.html#integration-graph"}},[e._v("Integration Graph")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"jdbc-lock-registry"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-lock-registry"}},[e._v("#")]),e._v(" JDBC Lock Registry")]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("JdbcLockRegistry")]),e._v(" for distributed locks shared through a database table.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-lock-registry"}},[e._v("JDBC Lock Registry")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"leaderinitiator-for-lockregistry"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#leaderinitiator-for-lockregistry"}},[e._v("#")]),e._v(" "),n("code",[e._v("LeaderInitiator")]),e._v(" for "),n("code",[e._v("LockRegistry")])]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("LeaderInitiator")]),e._v(" implementation based on the "),n("code",[e._v("LockRegistry")]),e._v(" strategy.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/endpoint.html#leadership-event-handling"}},[e._v("Leadership Event Handling")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-6"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-6"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes that version 4.3 brought to Spring Integration.")]),e._v(" "),n("h5",{attrs:{id:"core-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#core-changes-2"}},[e._v("#")]),e._v(" Core Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the core of Spring Integration.")]),e._v(" "),n("h6",{attrs:{id:"outbound-gateway-within-a-chain"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#outbound-gateway-within-a-chain"}},[e._v("#")]),e._v(" Outbound Gateway within a Chain")]),e._v(" "),n("p",[e._v("Previously, you could specify a "),n("code",[e._v("reply-channel")]),e._v(" on an outbound gateway within a chain.\nIt was completely ignored.\nThe gateway’s reply goes to the next chain element or, if the gateway is the last element, to the chain’s output channel.\nThis condition is now detected and disallowed.\nIf you have such a configuration, remove the "),n("code",[e._v("reply-channel")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"asynchronous-service-activator"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#asynchronous-service-activator"}},[e._v("#")]),e._v(" Asynchronous Service Activator")]),e._v(" "),n("p",[e._v("We added an option to make the service activator be synchronous.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/service-activator.html#async-service-activator"}},[e._v("Asynchronous Service Activator")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"messaging-annotation-support-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#messaging-annotation-support-changes"}},[e._v("#")]),e._v(" Messaging Annotation Support changes")]),e._v(" "),n("p",[e._v("The messaging annotation support does not require a "),n("code",[e._v("@MessageEndpoint")]),e._v(" (or any other "),n("code",[e._v("@Component")]),e._v(") annotation declaration on the class level.\nTo restore the previous behavior, set the "),n("code",[e._v("spring.integration.messagingAnnotations.require.componentAnnotation")]),e._v(" of"),n("code",[e._v("spring.integration.properties")]),e._v(" to "),n("code",[e._v("true")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#global-properties"}},[e._v("Global Properties")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mail-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mail-changes-4"}},[e._v("#")]),e._v(" Mail Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration Mail functionality.")]),e._v(" "),n("h6",{attrs:{id:"customizable-user-flag"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#customizable-user-flag"}},[e._v("#")]),e._v(" Customizable User Flag")]),e._v(" "),n("p",[e._v("The customizable "),n("code",[e._v("userFlag")]),e._v(" (added in 4.2.2 to provide customization of the flag used to denote that the mail has been\nseen) is now available in the XML namespace.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#imap-seen"}},[e._v("Marking IMAP Messages When "),n("code",[e._v("\\Recent")]),e._v(" Is Not Supported")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"mail-message-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mail-message-mapping"}},[e._v("#")]),e._v(" Mail Message Mapping")]),e._v(" "),n("p",[e._v("You can now map inbound mail messages with the "),n("code",[e._v("MessageHeaders")]),e._v(" containing the mail headers and the payload containing the email content.\nPreviously, the payload was always the raw "),n("code",[e._v("MimeMessage")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#mail-mapping"}},[e._v("Inbound Mail Message Mapping")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"jms-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-changes-2"}},[e._v("#")]),e._v(" JMS Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration JMS functionality.")]),e._v(" "),n("h6",{attrs:{id:"header-mapper"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#header-mapper"}},[e._v("#")]),e._v(" Header Mapper")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("DefaultJmsHeaderMapper")]),e._v(" now maps the standard "),n("code",[e._v("correlationId")]),e._v(" header as a message property by invoking its "),n("code",[e._v("toString()")]),e._v(" method.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-header-mapping"}},[e._v("Mapping Message Headers to and from JMS Message")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"asynchronous-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#asynchronous-gateway"}},[e._v("#")]),e._v(" Asynchronous Gateway")]),e._v(" "),n("p",[e._v("The JMS outbound gateway now has an "),n("code",[e._v("async")]),e._v(" property.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-async-gateway"}},[e._v("Async Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-changes-2"}},[e._v("#")]),e._v(" Aggregator Changes")]),e._v(" "),n("p",[e._v("There is a change in behavior when a POJO aggregator releases a collection of "),n("code",[e._v("Message<?>")]),e._v(" objects.\nThis is rare, but, if your application does that, you need to make a small change to your POJO.\nSee this "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#agg-message-collection"}},[e._v("IMPORTANT: The "),n("code",[e._v("SimpleMessageGroup.getMessages()")]),e._v(" method returns an "),n("code",[e._v("unmodifiableCollection")]),e._v(".")]),e._v(" note for more information.")],1),e._v(" "),n("h5",{attrs:{id:"tcp-udp-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-udp-changes-2"}},[e._v("#")]),e._v(" TCP/UDP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration TCP/UDP functionality.")]),e._v(" "),n("h6",{attrs:{id:"events"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#events"}},[e._v("#")]),e._v(" Events")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("TcpConnectionServerListeningEvent")]),e._v(" is emitted when a server connection factory is started.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-events"}},[e._v("TCP Connection Events")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("You can now use the "),n("code",[e._v("destination-expression")]),e._v(" and "),n("code",[e._v("socket-expression")]),e._v(" attributes on "),n("code",[e._v("<int-ip:udp-outbound-channel-adapter>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#udp-adapters"}},[e._v("UDP Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"stream-deserializers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stream-deserializers"}},[e._v("#")]),e._v(" Stream Deserializers")]),e._v(" "),n("p",[e._v("The various deserializers that cannot allocate the final buffer until the whole message has been assembled now support pooling the raw buffer into which the data is received rather than creating and discarding a buffer for each message.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-connection-factories"}},[e._v("TCP Connection Factories")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"tcp-message-mapper"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-message-mapper"}},[e._v("#")]),e._v(" TCP Message Mapper")]),e._v(" "),n("p",[e._v("The message mapper now, optionally, sets a configured content type header.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip-msg-headers"}},[e._v("IP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"file-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-changes-4"}},[e._v("#")]),e._v(" File Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration File functionality.")]),e._v(" "),n("h6",{attrs:{id:"destination-directory-creation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#destination-directory-creation"}},[e._v("#")]),e._v(" Destination Directory Creation")]),e._v(" "),n("p",[e._v("The generated file name for the "),n("code",[e._v("FileWritingMessageHandler")]),e._v(" can represent a sub-path to save the desired directory structure for a file in the target directory.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-writing-file-names"}},[e._v("Generating File Names")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileReadingMessageSource")]),e._v(" now hides the "),n("code",[e._v("WatchService")]),e._v(" directory scanning logic in the inner class.\nWe added the "),n("code",[e._v("use-watch-service")]),e._v(" and "),n("code",[e._v("watch-events")]),e._v(" options to enable this behavior.\nWe deprecated the top-level "),n("code",[e._v("WatchServiceDirectoryScanner")]),e._v(" because of inconsistency around the API.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#watch-service-directory-scanner"}},[n("code",[e._v("WatchServiceDirectoryScanner")])]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"buffer-size"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#buffer-size"}},[e._v("#")]),e._v(" Buffer Size")]),e._v(" "),n("p",[e._v("When writing files, you can now specify the buffer size.")]),e._v(" "),n("h6",{attrs:{id:"appending-and-flushing"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#appending-and-flushing"}},[e._v("#")]),e._v(" Appending and Flushing")]),e._v(" "),n("p",[e._v("You can now avoid flushing files when appending and use a number of strategies to flush the data during idle periods.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-flushing"}},[e._v("Flushing Files When Using "),n("code",[e._v("APPEND_NO_FLUSH")])]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"preserving-timestamps"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#preserving-timestamps"}},[e._v("#")]),e._v(" Preserving Timestamps")]),e._v(" "),n("p",[e._v("You can now configure the outbound channel adapter to set the destination file’s "),n("code",[e._v("lastmodified")]),e._v(" timestamp.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-timestamps"}},[e._v("File Timestamps")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"splitter-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#splitter-changes-2"}},[e._v("#")]),e._v(" Splitter Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileSplitter")]),e._v(" now automatically closes an FTP or SFTP session when the file is completely read.\nThis applies when the outbound gateway returns an "),n("code",[e._v("InputStream")]),e._v(" or when you use the new FTP or SFTP streaming channel adapters.\nWe also introduced a new "),n("code",[e._v("markers-json")]),e._v(" option to convert "),n("code",[e._v("FileSplitter.FileMarker")]),e._v(" to JSON "),n("code",[e._v("String")]),e._v(" for relaxed downstream network interaction.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-splitter"}},[e._v("File Splitter")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"file-filters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-filters"}},[e._v("#")]),e._v(" File Filters")]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("ChainFileListFilter")]),e._v(" as an alternative to "),n("code",[e._v("CompositeFileListFilter")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-reading"}},[e._v("Reading Files")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"amqp-changes-6"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-6"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration AMQP functionality.")]),e._v(" "),n("h6",{attrs:{id:"content-type-message-converter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#content-type-message-converter"}},[e._v("#")]),e._v(" Content Type Message Converter")]),e._v(" "),n("p",[e._v("The outbound endpoints now support a "),n("code",[e._v("RabbitTemplate")]),e._v(" configured with a "),n("code",[e._v("ContentTypeDelegatingMessageConverter")]),e._v(" such\nthat you can choose the converter based on the message content type.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#content-type-conversion-outbound"}},[e._v("Outbound Message Conversion")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"headers-for-delayed-message-handling"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#headers-for-delayed-message-handling"}},[e._v("#")]),e._v(" Headers for Delayed Message Handling")]),e._v(" "),n("p",[e._v("Spring AMQP 1.6 adds support for "),n("a",{attrs:{href:"https://www.rabbitmq.com/blog/2015/04/16/scheduling-messages-with-rabbitmq/",target:"_blank",rel:"noopener noreferrer"}},[e._v("delayed message exchanges"),n("OutboundLink")],1),e._v(".\nHeader mapping now supports the headers ("),n("code",[e._v("amqp_delay")]),e._v(" and "),n("code",[e._v("amqp_receivedDelay")]),e._v(") used by this feature.")]),e._v(" "),n("h6",{attrs:{id:"amqp-backed-channels"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-backed-channels"}},[e._v("#")]),e._v(" AMQP-Backed Channels")]),e._v(" "),n("p",[e._v("AMQP-backed channels now support message mapping.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-channels"}},[e._v("AMQP-backed Message Channels")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"redis-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-changes-2"}},[e._v("#")]),e._v(" Redis Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration Redis functionality.")]),e._v(" "),n("h6",{attrs:{id:"list-push-pop-direction"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#list-push-pop-direction"}},[e._v("#")]),e._v(" List Push/Pop Direction")]),e._v(" "),n("p",[e._v("Previously, the queue channel adapters always used the Redis list in a fixed direction, pushing to the left end and reading from the right end.\nYou can now configure the reading and writing direction with the "),n("code",[e._v("rightPop")]),e._v(" and "),n("code",[e._v("leftPush")]),e._v(" options for the"),n("code",[e._v("RedisQueueMessageDrivenEndpoint")]),e._v(" and "),n("code",[e._v("RedisQueueOutboundChannelAdapter")]),e._v(", respectively.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-queue-inbound-channel-adapter"}},[e._v("Redis Queue Inbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-queue-outbound-channel-adapter"}},[e._v("Redis Queue Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"queue-inbound-gateway-default-serializer"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#queue-inbound-gateway-default-serializer"}},[e._v("#")]),e._v(" Queue Inbound Gateway Default Serializer")]),e._v(" "),n("p",[e._v("The default serializer in the inbound gateway has been changed to a "),n("code",[e._v("JdkSerializationRedisSerializer")]),e._v(" for compatibility with the outbound gateway.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-queue-inbound-gateway"}},[e._v("Redis Queue Inbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"http-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-changes-4"}},[e._v("#")]),e._v(" HTTP Changes")]),e._v(" "),n("p",[e._v("Previously, with requests that had a body (such as "),n("code",[e._v("POST")]),e._v(") that had no "),n("code",[e._v("content-type")]),e._v(" header, the body was ignored.\nWith this release, the content type of such requests is considered to be "),n("code",[e._v("application/octet-stream")]),e._v(" as recommended\nby RFC 2616.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-inbound"}},[e._v("Http Inbound Components")]),e._v(" for more information.")],1),e._v(" "),n("p",[n("code",[e._v("uriVariablesExpression")]),e._v(" now uses a "),n("code",[e._v("SimpleEvaluationContext")]),e._v(" by default (since 4.3.15).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#mapping-uri-variables"}},[e._v("Mapping URI Variables")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"sftp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#sftp-changes"}},[e._v("#")]),e._v(" SFTP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration SFTP functionality.")]),e._v(" "),n("h6",{attrs:{id:"factory-bean"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#factory-bean"}},[e._v("#")]),e._v(" Factory Bean")]),e._v(" "),n("p",[e._v("We added a new factory bean to simplify the configuration of Jsch proxies for SFTP.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-proxy-factory-bean"}},[e._v("Proxy Factory Bean")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"chmod-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#chmod-changes"}},[e._v("#")]),e._v(" "),n("code",[e._v("chmod")]),e._v(" Changes")]),e._v(" "),n("p",[e._v("The SFTP outbound gateway (for "),n("code",[e._v("put")]),e._v(" and "),n("code",[e._v("mput")]),e._v(" commands) and the SFTP outbound channel adapter now support the "),n("code",[e._v("chmod")]),e._v(" attribute to change the remote file permissions after uploading.\nSee "),n("code",[e._v("[SFTP Outbound Channel Adapter](./sftp.html#sftp-outbound)")]),e._v(" and "),n("code",[e._v("[SFTP Outbound Gateway](./sftp.html#sftp-outbound-gateway)")]),e._v(" for more information.")]),e._v(" "),n("h5",{attrs:{id:"ftp-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-changes-2"}},[e._v("#")]),e._v(" FTP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration FTP functionality.")]),e._v(" "),n("h6",{attrs:{id:"session-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#session-changes"}},[e._v("#")]),e._v(" Session Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FtpSession")]),e._v(" now supports "),n("code",[e._v("null")]),e._v(" for the "),n("code",[e._v("list()")]),e._v(" and "),n("code",[e._v("listNames()")]),e._v(" methods, since underlying FTP Client can use it.\nWith that, you can now configure the "),n("code",[e._v("FtpOutboundGateway")]),e._v(" without the "),n("code",[e._v("remoteDirectory")]),e._v(" expression.\nYou can also configure the "),n("code",[e._v("<int-ftp:inbound-channel-adapter>")]),e._v(" without "),n("code",[e._v("remote-directory")]),e._v(" or "),n("code",[e._v("remote-directory-expression")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"router-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#router-changes-2"}},[e._v("#")]),e._v(" Router Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ErrorMessageExceptionTypeRouter")]),e._v(" now supports the "),n("code",[e._v("Exception")]),e._v(" superclass mappings to avoid duplication for the same channel in case of multiple inheritors.\nFor this purpose, the "),n("code",[e._v("ErrorMessageExceptionTypeRouter")]),e._v(" loads mapping classes during initialization to fail-fast for a "),n("code",[e._v("ClassNotFoundException")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/router.html#router"}},[e._v("Routers")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"header-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#header-mapping"}},[e._v("#")]),e._v(" Header Mapping")]),e._v(" "),n("p",[e._v("This section describes the changes to header mapping between version 4.2 and 4.3.")]),e._v(" "),n("h6",{attrs:{id:"general"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general"}},[e._v("#")]),e._v(" General")]),e._v(" "),n("p",[e._v("AMQP, WS, and XMPP header mappings (such as "),n("code",[e._v("request-header-mapping")]),e._v(" and "),n("code",[e._v("reply-header-mapping")]),e._v(") now support negated patterns.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-message-headers"}},[e._v("AMQP Message Headers")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/ws.html#ws-message-headers"}},[e._v("WS Message Headers")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/xmpp.html#xmpp-message-headers"}},[e._v("XMPP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"amqp-header-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-header-mapping"}},[e._v("#")]),e._v(" AMQP Header Mapping")]),e._v(" "),n("p",[e._v("Previously, only standard AMQP headers were mapped by default.\nYou had to explicitly enable mapping of user-defined headers.\nWith this release, all headers are mapped by default.\nIn addition, the inbound "),n("code",[e._v("amqp_deliveryMode")]),e._v(" header is no longer mapped by default.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-message-headers"}},[e._v("AMQP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"groovy-scripts"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#groovy-scripts"}},[e._v("#")]),e._v(" Groovy Scripts")]),e._v(" "),n("p",[e._v("You can now configure groovy scripts with the "),n("code",[e._v("compile-static")]),e._v(" hint or any other "),n("code",[e._v("CompilerConfiguration")]),e._v(" options.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/groovy.html#groovy-config"}},[e._v("Groovy Configuration")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"inboundchanneladapter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inboundchanneladapter-changes"}},[e._v("#")]),e._v(" "),n("code",[e._v("@InboundChannelAdapter")]),e._v(" Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("@InboundChannelAdapter")]),e._v(" now has an alias "),n("code",[e._v("channel")]),e._v(" attribute for the regular "),n("code",[e._v("value")]),e._v(".\nIn addition, the target "),n("code",[e._v("SourcePollingChannelAdapter")]),e._v(" components can now resolve the target "),n("code",[e._v("outputChannel")]),e._v(" bean from its provided name ("),n("code",[e._v("outputChannelName")]),e._v(" options) in a late-binding manner.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"xmpp-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xmpp-changes"}},[e._v("#")]),e._v(" XMPP Changes")]),e._v(" "),n("p",[e._v("The XMPP channel adapters now support the XMPP Extensions (XEP).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/xmpp.html#xmpp-extensions"}},[e._v("XMPP Extensions")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"wiretap-late-binding"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#wiretap-late-binding"}},[e._v("#")]),e._v(" WireTap Late Binding")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("WireTap")]),e._v(" "),n("code",[e._v("ChannelInterceptor")]),e._v(" now can accept a "),n("code",[e._v("channelName")]),e._v(" that is resolved to the target "),n("code",[e._v("MessageChannel")]),e._v("later, during the first active interceptor operation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-wiretap"}},[e._v("Wire Tap")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"channelmessagestorequeryprovider-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#channelmessagestorequeryprovider-changes"}},[e._v("#")]),e._v(" "),n("code",[e._v("ChannelMessageStoreQueryProvider")]),e._v(" Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ChannelMessageStoreQueryProvider")]),e._v(" now supports H2 databases.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-message-store-channels"}},[e._v("Backing Message Channels")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"websocket-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#websocket-changes"}},[e._v("#")]),e._v(" WebSocket Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ServerWebSocketContainer")]),e._v(" now exposes an "),n("code",[e._v("allowedOrigins")]),e._v(" option, and "),n("code",[e._v("SockJsServiceOptions")]),e._v(" exposes a "),n("code",[e._v("suppressCors")]),e._v(" option.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/web-sockets.html#web-sockets"}},[e._v("WebSockets Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-4-1-and-4-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-4-1-and-4-2"}},[e._v("#")]),e._v(" Changes between 4.1 and 4.2")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-4.1-to-4.2-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-7"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-7"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 4.2 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"major-management-jmx-rework"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#major-management-jmx-rework"}},[e._v("#")]),e._v(" Major Management/JMX Rework")]),e._v(" "),n("p",[e._v("We added a new "),n("code",[e._v("MetricsFactory")]),e._v(" strategy interface.\nThis change, together with other changes in the JMX and management infrastructure, provides much more control over management configuration and runtime performance.")]),e._v(" "),n("p",[e._v("However, this has some important implications for (some) user environments.")]),e._v(" "),n("p",[e._v("For complete details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/metrics.html#metrics-management"}},[e._v("Metrics and Management")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/jmx.html#jmx-42-improvements"}},[e._v("JMX Improvements")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"mongodb-metadata-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-metadata-store"}},[e._v("#")]),e._v(" MongoDB Metadata Store")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("MongoDbMetadataStore")]),e._v(" is now available.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb-metadata-store"}},[e._v("MongoDB Metadata Store")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"securedchannel-annotation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#securedchannel-annotation"}},[e._v("#")]),e._v(" SecuredChannel Annotation")]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("@SecuredChannel")]),e._v(" annotation, replacing the deprecated "),n("code",[e._v("ChannelSecurityInterceptorFactoryBean")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/security.html#security"}},[e._v("Security in Spring Integration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"securitycontext-propagation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#securitycontext-propagation"}},[e._v("#")]),e._v(" "),n("code",[e._v("SecurityContext")]),e._v(" Propagation")]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("SecurityContextPropagationChannelInterceptor")]),e._v(" for the "),n("code",[e._v("SecurityContext")]),e._v(" propagation from one message flow’s thread to another.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/security.html#security"}},[e._v("Security in Spring Integration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"filesplitter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#filesplitter"}},[e._v("#")]),e._v(" FileSplitter")]),e._v(" "),n("p",[e._v("In 4.1.2, we added "),n("code",[e._v("FileSplitter")]),e._v(", which splits text files into lines.\nIt now has full support in the "),n("code",[e._v("int-file:")]),e._v(" namespace.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-splitter"}},[e._v("File Splitter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"zookeeper-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#zookeeper-support"}},[e._v("#")]),e._v(" Zookeeper Support")]),e._v(" "),n("p",[e._v("We added Zookeeper support to the framework to assist when running on a clustered or multi-host environment.\nThe change impacts the following features:")]),e._v(" "),n("ul",[n("li",[n("p",[n("code",[e._v("ZookeeperMetadataStore")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("ZookeeperLockRegistry")])])]),e._v(" "),n("li",[n("p",[e._v("Zookeeper Leadership")])])]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/zookeeper.html#zookeeper"}},[e._v("Zookeeper Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"thread-barrier"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#thread-barrier"}},[e._v("#")]),e._v(" Thread Barrier")]),e._v(" "),n("p",[e._v("A new thread "),n("code",[e._v("<int:barrier/>")]),e._v(" component is available, letting a thread be suspended until some asynchronous event occurs.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/barrier.html#barrier"}},[e._v("Thread Barrier")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"stomp-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stomp-support"}},[e._v("#")]),e._v(" STOMP Support")]),e._v(" "),n("p",[e._v("We added STOMP support to the framework as an inbound and outbound channel adapters pair.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/stomp.html#stomp"}},[e._v("STOMP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"codec"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#codec"}},[e._v("#")]),e._v(" Codec")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("Codec")]),e._v(" abstraction has been introduced, to encode and decode objects to and from "),n("code",[e._v("byte[]")]),e._v(".\nWe added an implementation that uses Kryo.\nWe also added codec-based transformers and message converters.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/codec.html#codec"}},[e._v("Codec")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"message-preparedstatement-setter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-preparedstatement-setter"}},[e._v("#")]),e._v(" Message PreparedStatement Setter")]),e._v(" "),n("p",[e._v("A new "),n("code",[e._v("MessagePreparedStatementSetter")]),e._v(" functional interface callback is available for the "),n("code",[e._v("JdbcMessageHandler")]),e._v(" ("),n("code",[e._v("<int-jdbc:outbound-gateway>")]),e._v(" and "),n("code",[e._v("<int-jdbc:outbound-channel-adapter>")]),e._v(") as an alternative to using "),n("code",[e._v("SqlParameterSourceFactory")]),e._v(" to populate parameters on the "),n("code",[e._v("PreparedStatement")]),e._v(" with the "),n("code",[e._v("requestMessage")]),e._v(" context.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-outbound-channel-adapter"}},[e._v("Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-7"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-7"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes from version 4.1 to version 4.2.")]),e._v(" "),n("h5",{attrs:{id:"wiretap"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#wiretap"}},[e._v("#")]),e._v(" WireTap")]),e._v(" "),n("p",[e._v("As an alternative to the existing "),n("code",[e._v("selector")]),e._v(" attribute, the "),n("code",[e._v("<wire-tap/>")]),e._v(" element now supports the "),n("code",[e._v("selector-expression")]),e._v(" attribute.")]),e._v(" "),n("h5",{attrs:{id:"file-changes-5"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-changes-5"}},[e._v("#")]),e._v(" File Changes")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#files"}},[e._v("File Support")]),e._v(" for more information about these changes.")],1),e._v(" "),n("h6",{attrs:{id:"appending-new-lines"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#appending-new-lines"}},[e._v("#")]),e._v(" Appending New Lines")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<int-file:outbound-channel-adapter>")]),e._v(" and "),n("code",[e._v("<int-file:outbound-gateway>")]),e._v(" now support an "),n("code",[e._v("append-new-line")]),e._v(" attribute.\nIf set to "),n("code",[e._v("true")]),e._v(", a new line is appended to the file after a message is written.\nThe default attribute value is "),n("code",[e._v("false")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"ignoring-hidden-files"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ignoring-hidden-files"}},[e._v("#")]),e._v(" Ignoring Hidden Files")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("ignore-hidden")]),e._v(" attribute for the "),n("code",[e._v("<int-file:inbound-channel-adapter>")]),e._v(" to let you set whether to pick up hidden files from the source directory.\nIt defaults to "),n("code",[e._v("true")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"writing-inputstream-payloads"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#writing-inputstream-payloads"}},[e._v("#")]),e._v(" Writing "),n("code",[e._v("InputStream")]),e._v(" Payloads")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("FileWritingMessageHandler")]),e._v(" now also accepts "),n("code",[e._v("InputStream")]),e._v(" as a valid message payload type.")]),e._v(" "),n("h6",{attrs:{id:"headdirectoryscanner"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#headdirectoryscanner"}},[e._v("#")]),e._v(" "),n("code",[e._v("HeadDirectoryScanner")])]),e._v(" "),n("p",[e._v("You can now use the "),n("code",[e._v("HeadDirectoryScanner")]),e._v(" with other "),n("code",[e._v("FileListFilter")]),e._v(" implementations.")]),e._v(" "),n("h6",{attrs:{id:"last-modified-filter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#last-modified-filter"}},[e._v("#")]),e._v(" Last Modified Filter")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("LastModifiedFileListFilter")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"watch-service-directory-scanner"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#watch-service-directory-scanner"}},[e._v("#")]),e._v(" Watch Service Directory Scanner")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("WatchServiceDirectoryScanner")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"persistent-file-list-filter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#persistent-file-list-filter-changes"}},[e._v("#")]),e._v(" Persistent File List Filter Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("AbstractPersistentFileListFilter")]),e._v(" has a new property ("),n("code",[e._v("flushOnUpdate")]),e._v(") which, when set to "),n("code",[e._v("true")]),e._v(", calls "),n("code",[e._v("flush()")]),e._v(" on the metadata store if it implements "),n("code",[e._v("Flushable")]),e._v(" (for example, "),n("code",[e._v("PropertiesPersistingMetadataStore")]),e._v(").")]),e._v(" "),n("h5",{attrs:{id:"class-package-change"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#class-package-change"}},[e._v("#")]),e._v(" Class Package Change")]),e._v(" "),n("p",[e._v("We moved the "),n("code",[e._v("ScatterGatherHandler")]),e._v(" class from the "),n("code",[e._v("org.springframework.integration.handler")]),e._v(" to the "),n("code",[e._v("org.springframework.integration.scattergather")]),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"tcp-changes-4"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-changes-4"}},[e._v("#")]),e._v(" TCP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration TCP functionality.")]),e._v(" "),n("h6",{attrs:{id:"tcp-serializers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-serializers"}},[e._v("#")]),e._v(" TCP Serializers")]),e._v(" "),n("p",[e._v("The TCP "),n("code",[e._v("Serializers")]),e._v(" no longer "),n("code",[e._v("flush()")]),e._v(" the "),n("code",[e._v("OutputStream")]),e._v(".\nThis is now done by the "),n("code",[e._v("TcpNxxConnection")]),e._v(" classes.\nIf you use the serializers directly within your code, you may have to "),n("code",[e._v("flush()")]),e._v(" the "),n("code",[e._v("OutputStream")]),e._v(".")]),e._v(" "),n("h6",{attrs:{id:"server-socket-exceptions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#server-socket-exceptions"}},[e._v("#")]),e._v(" Server Socket Exceptions")]),e._v(" "),n("p",[n("code",[e._v("TcpConnectionServerExceptionEvent")]),e._v(" instances are now published whenever an unexpected exception occurs on a TCP server socket (also added to 4.1.3 and 4.0.7).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-events"}},[e._v("TCP Connection Events")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"tcp-server-port"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-server-port"}},[e._v("#")]),e._v(" TCP Server Port")]),e._v(" "),n("p",[e._v("If you configure a TCP server socket factory to listen on a random port, you can now obtain the actual port chosen by the OS by using "),n("code",[e._v("getPort()")]),e._v("."),n("code",[e._v("getServerSocketAddress()")]),e._v(" is also available.")]),e._v(" "),n("p",[e._v('See "'),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-connection-factories"}},[e._v("TCP Connection Factories")]),e._v('" for more information.')],1),e._v(" "),n("h6",{attrs:{id:"tcp-gateway-remote-timeout"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-gateway-remote-timeout"}},[e._v("#")]),e._v(" TCP Gateway Remote Timeout")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("TcpOutboundGateway")]),e._v(" now supports "),n("code",[e._v("remote-timeout-expression")]),e._v(" as an alternative to the existing "),n("code",[e._v("remote-timeout")]),e._v(" attribute.\nThis allows setting the timeout based on each message.")]),e._v(" "),n("p",[e._v("Also, the "),n("code",[e._v("remote-timeout")]),e._v(" no longer defaults to the same value as "),n("code",[e._v("reply-timeout")]),e._v(", which has a completely different meaning.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-ob-gateway-attributes"}},[e._v(".TCP Outbound Gateway Attributes")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"tcp-sslsession-available-for-header-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-sslsession-available-for-header-mapping"}},[e._v("#")]),e._v(" TCP SSLSession Available for Header Mapping")]),e._v(" "),n("p",[n("code",[e._v("TcpConnection")]),e._v(" implementations now support "),n("code",[e._v("getSslSession()")]),e._v(" to let you extract information from the session to add to message headers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip-msg-headers"}},[e._v("IP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"tcp-events"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-events"}},[e._v("#")]),e._v(" TCP Events")]),e._v(" "),n("p",[e._v("New events are now published whenever a correlation exception occurs — such as sending a message to a non-existent socket.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("TcpConnectionEventListeningMessageProducer")]),e._v(" is deprecated.\nUse the generic event adapter instead.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-events"}},[e._v("TCP Connection Events")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"inboundchanneladapter-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inboundchanneladapter-changes-2"}},[e._v("#")]),e._v(" "),n("code",[e._v("@InboundChannelAdapter")]),e._v(" Changes")]),e._v(" "),n("p",[e._v("Previously, the "),n("code",[e._v("@Poller")]),e._v(" on an inbound channel adapter defaulted the "),n("code",[e._v("maxMessagesPerPoll")]),e._v(" attribute to "),n("code",[e._v("-1")]),e._v(" (infinity).\nThis was inconsistent with the XML configuration of "),n("code",[e._v("<inbound-channel-adapter/>")]),e._v(", which defaults to "),n("code",[e._v("1")]),e._v(".\nThe annotation now defaults this attribute to "),n("code",[e._v("1")]),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"api-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#api-changes"}},[e._v("#")]),e._v(" API Changes")]),e._v(" "),n("p",[n("code",[e._v("o.s.integration.util.FunctionIterator")]),e._v(" now requires a "),n("code",[e._v("o.s.integration.util.Function")]),e._v(" instead of a "),n("code",[e._v("reactor.function.Function")]),e._v(".\nThis was done to remove an unnecessary hard dependency on Reactor.\nAny uses of this iterator need to change the import.")]),e._v(" "),n("p",[e._v("Reactor is still supported for functionality such as the "),n("code",[e._v("Promise")]),e._v(" gateway.\nThe dependency was removed for those users who do not need it.")]),e._v(" "),n("h5",{attrs:{id:"jms-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-changes-3"}},[e._v("#")]),e._v(" JMS Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration TCP functionality.")]),e._v(" "),n("h6",{attrs:{id:"reply-listener-lazy-initialization"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#reply-listener-lazy-initialization"}},[e._v("#")]),e._v(" Reply Listener Lazy Initialization")]),e._v(" "),n("p",[e._v("You can now configure the reply listener in JMS outbound gateways to be initialized on-demand and stopped after an idle period, instead of being controlled by the gateway’s lifecycle.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-outbound-gateway"}},[e._v("Outbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"conversion-errors-in-message-driven-endpoints"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#conversion-errors-in-message-driven-endpoints"}},[e._v("#")]),e._v(" Conversion Errors in Message-Driven Endpoints")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("error-channel")]),e._v(" is now used for the conversion errors.\nIn previous versions, they caused transaction rollback and message redelivery.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-message-driven-channel-adapter"}},[e._v("Message-driven Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-inbound-gateway"}},[e._v("Inbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"default-acknowledge-mode"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#default-acknowledge-mode"}},[e._v("#")]),e._v(" Default Acknowledge Mode")]),e._v(" "),n("p",[e._v("When using an implicitly defined "),n("code",[e._v("DefaultMessageListenerContainer")]),e._v(", the default "),n("code",[e._v("acknowledge")]),e._v(" is now "),n("code",[e._v("transacted")]),e._v(".\nWe recommend using "),n("code",[e._v("transacted")]),e._v(" when using this container, to avoid message loss.\nThis default now applies to the message-driven inbound adapter and the inbound gateway.\nIt was already the default for JMS-backed channels.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-message-driven-channel-adapter"}},[e._v("Message-driven Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-inbound-gateway"}},[e._v("Inbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"shared-subscriptions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#shared-subscriptions"}},[e._v("#")]),e._v(" Shared Subscriptions")]),e._v(" "),n("p",[e._v("We added Namespace support for shared subscriptions (JMS 2.0) to message-driven endpoints and the "),n("code",[e._v("<int-jms:publish-subscribe-channel>")]),e._v(".\nPreviously, you had to wire up listener containers as "),n("code",[e._v("<bean/>")]),e._v(" declarations to use shared connections.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms"}},[e._v("JMS Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"conditional-pollers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#conditional-pollers"}},[e._v("#")]),e._v(" Conditional Pollers")]),e._v(" "),n("p",[e._v("We now provide much more flexibility for dynamic polling.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/polling-consumer.html#conditional-pollers"}},[e._v("Conditional Pollers for Message Sources")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"amqp-changes-7"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-changes-7"}},[e._v("#")]),e._v(" AMQP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration AMQP functionality.")]),e._v(" "),n("h6",{attrs:{id:"publisher-confirmations"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#publisher-confirmations"}},[e._v("#")]),e._v(" Publisher Confirmations")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<int-amqp:outbound-gateway>")]),e._v(" now supports "),n("code",[e._v("confirm-correlation-expression")]),e._v(", "),n("code",[e._v("confirm-ack-channel")]),e._v(", and "),n("code",[e._v("confirm-nack-channel")]),e._v(" attributes (which have a purpose similar to that of "),n("code",[e._v("<int-amqp:outbound-channel-adapter>")]),e._v(").")]),e._v(" "),n("h6",{attrs:{id:"correlation-data"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#correlation-data"}},[e._v("#")]),e._v(" Correlation Data")]),e._v(" "),n("p",[e._v("For both the outbound channel adapter and the inbound gateway, if the correlation data is a "),n("code",[e._v("Message<?>")]),e._v(", it becomes the basis of the message on the ack or nack channel, with the additional header(s) added.\nPreviously, any correlation data (including "),n("code",[e._v("Message<?>")]),e._v(") was returned as the payload of the ack or nack message.")]),e._v(" "),n("h6",{attrs:{id:"inbound-gateway-properties"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inbound-gateway-properties"}},[e._v("#")]),e._v(" Inbound Gateway Properties")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<int-amqp:inbound-gateway>")]),e._v(" now exposes the "),n("code",[e._v("amqp-template")]),e._v(" attribute to allow more control over an external bean for the reply "),n("code",[e._v("RabbitTemplate")]),e._v(".\nYou can also provide your own "),n("code",[e._v("AmqpTemplate")]),e._v(" implementation.\nIn addition, you can use "),n("code",[e._v("default-reply-to")]),e._v(" if the request message does not have a "),n("code",[e._v("replyTo")]),e._v(" property.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp"}},[e._v("AMQP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"xpath-splitter-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xpath-splitter-improvements"}},[e._v("#")]),e._v(" XPath Splitter Improvements")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("XPathMessageSplitter")]),e._v(" ("),n("code",[e._v("<int-xml:xpath-splitter>")]),e._v(") now allows the configuration of "),n("code",[e._v("output-properties")]),e._v(" for the internal "),n("code",[e._v("javax.xml.transform.Transformer")]),e._v(" and supports an "),n("code",[e._v("Iterator")]),e._v(" mode (defaults to "),n("code",[e._v("true")]),e._v(") for the XPath evaluation "),n("code",[e._v("org.w3c.dom.NodeList")]),e._v(" result.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/xml.html#xml-xpath-splitting"}},[e._v("Splitting XML Messages")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"http-changes-5"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-changes-5"}},[e._v("#")]),e._v(" HTTP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration HTTP functionality.")]),e._v(" "),n("h6",{attrs:{id:"cors"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#cors"}},[e._v("#")]),e._v(" CORS")]),e._v(" "),n("p",[e._v("The HTTP inbound endpoints ("),n("code",[e._v("<int-http:inbound-channel-adapter>")]),e._v(" and "),n("code",[e._v("<int-http:inbound-gateway>")]),e._v(") now allow the\nconfiguration of Cross-origin Resource Sharing (CORS).")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-cors"}},[e._v("Cross-origin Resource Sharing (CORS) Support")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"inbound-gateway-timeout"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inbound-gateway-timeout"}},[e._v("#")]),e._v(" Inbound Gateway Timeout")]),e._v(" "),n("p",[e._v("You can configure the HTTP inbound gate way to return a status code that you specify when a request times out.\nThe default is now "),n("code",[e._v("500 Internal Server Error")]),e._v(" instead of "),n("code",[e._v("200 OK")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-response-statuscode"}},[e._v("Response Status Code")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"form-data"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#form-data"}},[e._v("#")]),e._v(" Form Data")]),e._v(" "),n("p",[e._v("We added documentation for proxying "),n("code",[e._v("multipart/form-data")]),e._v(" requests.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http"}},[e._v("HTTP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"gateway-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gateway-changes-2"}},[e._v("#")]),e._v(" Gateway Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration Gateway functionality.")]),e._v(" "),n("h6",{attrs:{id:"gateway-methods-can-return-completablefuture"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gateway-methods-can-return-completablefuture"}},[e._v("#")]),e._v(" Gateway Methods can Return "),n("code",[e._v("CompletableFuture<?>")])]),e._v(" "),n("p",[e._v("When using Java 8, gateway methods can now return "),n("code",[e._v("CompletableFuture<?>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gw-completable-future"}},[n("code",[e._v("CompletableFuture")])]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"messaginggateway-annotation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#messaginggateway-annotation"}},[e._v("#")]),e._v(" MessagingGateway Annotation")]),e._v(" "),n("p",[e._v("The request and reply timeout properties are now "),n("code",[e._v("String")]),e._v(" instead of "),n("code",[e._v("Long")]),e._v(" to allow configuration with property placeholders or SpEL.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#messaging-gateway-annotation"}},[n("code",[e._v("@MessagingGateway")]),e._v(" Annotation")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-changes-3"}},[e._v("#")]),e._v(" Aggregator Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration aggregator functionality.")]),e._v(" "),n("h6",{attrs:{id:"aggregator-performance"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-performance"}},[e._v("#")]),e._v(" Aggregator Performance")]),e._v(" "),n("p",[e._v("This release includes some performance improvements for aggregating components (aggregator, resequencer, and others), by more efficiently removing messages from groups when they are released.\nNew methods ("),n("code",[e._v("removeMessagesFromGroup")]),e._v(") have been added to the message store.\nSet the "),n("code",[e._v("removeBatchSize")]),e._v(" property (default: "),n("code",[e._v("100")]),e._v(") to adjust the number of messages deleted in each operation.\nCurrently, the JDBC, Redis, and MongoDB message stores support this property.")]),e._v(" "),n("h6",{attrs:{id:"output-message-group-processor"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#output-message-group-processor"}},[e._v("#")]),e._v(" Output Message Group Processor")]),e._v(" "),n("p",[e._v("When using a "),n("code",[e._v("ref")]),e._v(" or inner bean for the aggregator, you can now directly bind a "),n("code",[e._v("MessageGroupProcessor")]),e._v(".\nIn addition, we added a "),n("code",[e._v("SimpleMessageGroupProcessor")]),e._v(" that returns the collection of messages in the group.\nWhen an output processor produces a collection of "),n("code",[e._v("Message<?>")]),e._v(", the aggregator releases those messages individually.\nConfiguring the "),n("code",[e._v("SimpleMessageGroupProcessor")]),e._v(" makes the aggregator a message barrier, where messages are held up until they all arrive and are then released individually.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-sftp-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-changes-3"}},[e._v("#")]),e._v(" FTP and SFTP Changes")]),e._v(" "),n("p",[e._v("This section describes general changes to the Spring Integration FTP and SFTP functionality.")]),e._v(" "),n("h6",{attrs:{id:"inbound-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inbound-channel-adapters"}},[e._v("#")]),e._v(" Inbound Channel Adapters")]),e._v(" "),n("p",[e._v("You can now specify a "),n("code",[e._v("remote-directory-expression")]),e._v(" on the inbound channel adapters, to determine the directory at runtime.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"gateway-partial-results"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gateway-partial-results"}},[e._v("#")]),e._v(" Gateway Partial Results")]),e._v(" "),n("p",[e._v("When you use FTP or SFTP outbound gateways to operate on multiple files (with "),n("code",[e._v("mget")]),e._v(" and "),n("code",[e._v("mput")]),e._v("), an exception can\noccur after part of the request is completed.\nIf such a condition occurs, a "),n("code",[e._v("PartialSuccessException")]),e._v(" that contains the partial results is thrown.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-outbound-gateway"}},[e._v("FTP Outbound Gateway")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-outbound-gateway"}},[e._v("SFTP Outbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"delegating-session-factory"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#delegating-session-factory"}},[e._v("#")]),e._v(" Delegating Session Factory")]),e._v(" "),n("p",[e._v("We added a delegating session factory, enabling the selection of a particular session factory based on some thread context value.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-dsf"}},[e._v("Delegating Session Factory")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-dsf"}},[e._v("Delegating Session Factory")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"default-sftp-session-factory"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#default-sftp-session-factory"}},[e._v("#")]),e._v(" Default Sftp Session Factory")]),e._v(" "),n("p",[e._v("Previously, the "),n("code",[e._v("DefaultSftpSessionFactory")]),e._v(" unconditionally allowed connections to unknown hosts.\nThis is now configurable (default: "),n("code",[e._v("false")]),e._v(").")]),e._v(" "),n("p",[e._v("The factory now requires a configured "),n("code",[e._v("knownHosts")]),e._v(", file unless the "),n("code",[e._v("allowUnknownKeys")]),e._v(" property is "),n("code",[e._v("true")]),e._v(" (default: "),n("code",[e._v("false")]),e._v(").")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-unk-keys"}},[n("code",[e._v("allowUnknownKeys")]),e._v("::Set to "),n("code",[e._v("true")]),e._v(" to allow connections to hosts with unknown (or changed) keys.")]),e._v(" for more information.")],1),e._v(" "),n("h6",{attrs:{id:"message-session-callback"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-session-callback"}},[e._v("#")]),e._v(" Message Session Callback")]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("MessageSessionCallback<F, T>")]),e._v(" to perform any custom "),n("code",[e._v("Session")]),e._v(" operations with the "),n("code",[e._v("requestMessage")]),e._v(" context in the "),n("code",[e._v("<int-(s)ftp:outbound-gateway/>")]),e._v(".")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-session-callback"}},[e._v("Using "),n("code",[e._v("MessageSessionCallback")])]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-session-callback"}},[e._v("MessageSessionCallback")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"websocket-changes-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#websocket-changes-2"}},[e._v("#")]),e._v(" Websocket Changes")]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("WebSocketHandlerDecoratorFactory")]),e._v(" support to the "),n("code",[e._v("ServerWebSocketContainer")]),e._v(" to allow chained customization for the internal "),n("code",[e._v("WebSocketHandler")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/web-sockets.html#web-sockets-namespace"}},[e._v("WebSockets Namespace Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"application-event-adapters-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#application-event-adapters-changes"}},[e._v("#")]),e._v(" Application Event Adapters changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ApplicationEvent")]),e._v(" adapters can now operate with "),n("code",[e._v("payload")]),e._v(" as an "),n("code",[e._v("event")]),e._v(" to directly allow omitting custom "),n("code",[e._v("ApplicationEvent")]),e._v(" extensions.\nFor this purpose, we introduced the "),n("code",[e._v("publish-payload")]),e._v(" boolean attribute has been introduced on the "),n("code",[e._v("<int-event:outbound-channel-adapter>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/event.html#applicationevent"}},[e._v("Spring "),n("code",[e._v("ApplicationEvent")]),e._v(" Support")]),e._v(" for more information.")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-4-0-and-4-1"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-4-0-and-4-1"}},[e._v("#")]),e._v(" Changes between 4.0 and 4.1")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-4.0-to-4.1-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-8"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-8"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 4.1 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"promise-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#promise-gateway"}},[e._v("#")]),e._v(" Promise<?> Gateway")]),e._v(" "),n("p",[e._v("The messaging gateway methods now support a Reactor "),n("code",[e._v("Promise")]),e._v(" return type.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#async-gateway"}},[e._v("Asynchronous Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"websocket-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#websocket-support"}},[e._v("#")]),e._v(" WebSocket support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("WebSocket")]),e._v(" module is now available.\nIt is fully based on the Spring WebSocket and Spring Messaging modules and provides an "),n("code",[e._v("<inbound-channel-adapter>")]),e._v(" and an "),n("code",[e._v("<outbound-channel-adapter>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/web-sockets.html#web-sockets"}},[e._v("WebSockets Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"scatter-gather-enterprise-integration-pattern"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#scatter-gather-enterprise-integration-pattern"}},[e._v("#")]),e._v(" Scatter-Gather Enterprise Integration Pattern")]),e._v(" "),n("p",[e._v("We implemented the scatter-gather enterprise integration pattern.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/scatter-gather.html#scatter-gather"}},[e._v("Scatter-Gather")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"routing-slip-pattern"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#routing-slip-pattern"}},[e._v("#")]),e._v(" Routing Slip Pattern")]),e._v(" "),n("p",[e._v("We added the routing slip EIP pattern implementation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/router.html#routing-slip"}},[e._v("Routing Slip")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"idempotent-receiver-pattern"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#idempotent-receiver-pattern"}},[e._v("#")]),e._v(" Idempotent Receiver Pattern")]),e._v(" "),n("p",[e._v("We added the idempotent receiver enterprise integration pattern implementation by adding the "),n("code",[e._v("<idempotent-receiver>")]),e._v(" component in XML or the "),n("code",[e._v("IdempotentReceiverInterceptor")]),e._v(" and "),n("code",[e._v("IdempotentReceiver")]),e._v(" annotations for Java configuration.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#idempotent-receiver"}},[e._v("Idempotent Receiver Enterprise Integration Pattern")]),e._v(" and the "),n("a",{attrs:{href:"https://docs.spring.io/spring-integration/api/index.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Javadoc"),n("OutboundLink")],1),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"boon-jsonobjectmapper"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#boon-jsonobjectmapper"}},[e._v("#")]),e._v(" Boon "),n("code",[e._v("JsonObjectMapper")])]),e._v(" "),n("p",[e._v("We added the Boon "),n("code",[e._v("JsonObjectMapper")]),e._v(" for the JSON transformers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"redis-queue-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-queue-gateways"}},[e._v("#")]),e._v(" Redis Queue Gateways")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("<redis-queue-inbound-gateway>")]),e._v(" and "),n("code",[e._v("<redis-queue-outbound-gateway>")]),e._v(" components.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-queue-inbound-gateway"}},[e._v("Redis Queue Inbound Gateway")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-queue-outbound-gateway"}},[e._v("Redis Queue Outbound Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"pollskipadvice"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#pollskipadvice"}},[e._v("#")]),e._v(" "),n("code",[e._v("PollSkipAdvice")])]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("PollSkipAdvice")]),e._v(", which you can use within the "),n("code",[e._v("<advice-chain>")]),e._v(" of the "),n("code",[e._v("<poller>")]),e._v(" to determine if the current poll should be suppressed (skipped) by some condition that you implement with "),n("code",[e._v("PollSkipStrategy")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/polling-consumer.html#polling-consumer"}},[e._v("Poller")]),e._v(" for more information.")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-8"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-8"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes from version 4.0 to version 4.1.")]),e._v(" "),n("h5",{attrs:{id:"amqp-inbound-endpoints-channel"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-inbound-endpoints-channel"}},[e._v("#")]),e._v(" AMQP Inbound Endpoints, Channel")]),e._v(" "),n("p",[e._v("Elements that use a message listener container (inbound endpoints and channel) now support the "),n("code",[e._v("missing-queues-fatal")]),e._v(" attribute.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp"}},[e._v("AMQP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"amqp-outbound-endpoints"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-outbound-endpoints"}},[e._v("#")]),e._v(" AMQP Outbound Endpoints")]),e._v(" "),n("p",[e._v("The AMQP outbound endpoints support a new property called "),n("code",[e._v("lazy-connect")]),e._v(" (default: "),n("code",[e._v("true")]),e._v(").\nWhen "),n("code",[e._v("true")]),e._v(", the connection to the broker is not established until the first message arrives (assuming there are no inbound endpoints, which always try to establish the connection during startup).\nWhen set to "),n("code",[e._v("false")]),e._v(", an attempt to establish the connection is made during application startup.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp"}},[e._v("AMQP Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"simplemessagestore"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#simplemessagestore"}},[e._v("#")]),e._v(" SimpleMessageStore")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("SimpleMessageStore")]),e._v(" no longer makes a copy of the group when calling "),n("code",[e._v("getMessageGroup()")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-store.html#sms-caution"}},[e._v("[WARNING]")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"web-service-outbound-gateway-encode-uri"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#web-service-outbound-gateway-encode-uri"}},[e._v("#")]),e._v(" Web Service Outbound Gateway: "),n("code",[e._v("encode-uri")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<ws:outbound-gateway/>")]),e._v(" now provides an "),n("code",[e._v("encode-uri")]),e._v(" attribute to allow disabling the encoding of the URI object before sending the request.")]),e._v(" "),n("h5",{attrs:{id:"http-inbound-channel-adapter-and-status-code"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-inbound-channel-adapter-and-status-code"}},[e._v("#")]),e._v(" Http Inbound Channel Adapter and Status Code")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<http:inbound-channel-adapter>")]),e._v(" can now be configured with a "),n("code",[e._v("status-code-expression")]),e._v(" to override the default "),n("code",[e._v("200 OK")]),e._v(" status.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-namespace"}},[e._v("HTTP Namespace Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mqtt-adapter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mqtt-adapter-changes"}},[e._v("#")]),e._v(" MQTT Adapter Changes")]),e._v(" "),n("p",[e._v("You can now configure the MQTT channel adapters to connect to multiple servers — for example, to support High Availability (HA).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt"}},[e._v("MQTT Support")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The MQTT message-driven channel adapter now supports specifying the QoS setting for each subscription.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt-inbound"}},[e._v("Inbound (Message-driven) Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("The MQTT outbound channel adapter now supports asynchronous sends, avoiding blocking until delivery is confirmed.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt-outbound"}},[e._v("Outbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("It is now possible to programmatically subscribe to and unsubscribe from topics at runtime.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt-inbound"}},[e._v("Inbound (Message-driven) Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-sftp-adapter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-adapter-changes"}},[e._v("#")]),e._v(" FTP and SFTP Adapter Changes")]),e._v(" "),n("p",[e._v("The FTP and SFTP outbound channel adapters now support appending to remote files and taking specific actions when a remote file already exists.\nThe remote file templates now also supports this, as well as "),n("code",[e._v("rmdir()")]),e._v(" and "),n("code",[e._v("exists()")]),e._v(".\nIn addition, the remote file templates provide access to the underlying client object, enabling access to low-level APIs.")]),e._v(" "),n("p",[e._v("See "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Adapters")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"splitter-and-iterator"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#splitter-and-iterator"}},[e._v("#")]),e._v(" Splitter and Iterator")]),e._v(" "),n("p",[n("code",[e._v("Splitter")]),e._v(" components now support an "),n("code",[e._v("Iterator")]),e._v(" as the result object for producing output messages.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/splitter.html#splitter"}},[e._v("Splitter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"aggregator"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator"}},[e._v("#")]),e._v(" Aggregator")]),e._v(" "),n("p",[n("code",[e._v("Aggregator")]),e._v(" instancess now support a new attribute "),n("code",[e._v("expire-groups-upon-timeout")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"content-enricher-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#content-enricher-improvements"}},[e._v("#")]),e._v(" Content Enricher Improvements")]),e._v(" "),n("p",[e._v("We added a "),n("code",[e._v("null-result-expression")]),e._v(" attribute, which is evaluated and returned if "),n("code",[e._v("<enricher>")]),e._v(" returns "),n("code",[e._v("null")]),e._v(".\nYou can add it in "),n("code",[e._v("<header>")]),e._v(" and "),n("code",[e._v("<property>")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#content-enricher"}},[e._v("Content Enricher")]),e._v(" for more information.")],1),e._v(" "),n("p",[e._v("We added an "),n("code",[e._v("error-channel")]),e._v(" attribute, which is used to handle an error flow if an "),n("code",[e._v("Exception")]),e._v(" occurs downstream of the "),n("code",[e._v("request-channel")]),e._v(".\nThis lets you return an alternative object to use for enrichment.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#content-enricher"}},[e._v("Content Enricher")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"header-channel-registry"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#header-channel-registry"}},[e._v("#")]),e._v(" Header Channel Registry")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<header-enricher/>")]),e._v(" element’s "),n("code",[e._v("<header-channels-to-string/>")]),e._v(" child element can now override the header channel registry’s default time for retaining channel mappings.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#header-channel-registry"}},[e._v("Header Channel Registry")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"orderly-shutdown"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#orderly-shutdown"}},[e._v("#")]),e._v(" Orderly Shutdown")]),e._v(" "),n("p",[e._v("We made improvements to the orderly shutdown algorithm.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/shutdown.html#jmx-shutdown"}},[e._v("Orderly Shutdown")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"management-for-recipientlistrouter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#management-for-recipientlistrouter"}},[e._v("#")]),e._v(" Management for "),n("code",[e._v("RecipientListRouter")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RecipientListRouter")]),e._v(" now provides several management operations to configure recipients at runtime.\nWith that, you can now configure the "),n("code",[e._v("<recipient-list-router>")]),e._v(" without any "),n("code",[e._v("<recipient>")]),e._v(" from the start.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/router.html#recipient-list-router-management"}},[n("code",[e._v("RecipientListRouterManagement")])]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"abstractheadermapper-non-standard-headers-token"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#abstractheadermapper-non-standard-headers-token"}},[e._v("#")]),e._v(" AbstractHeaderMapper: NON_STANDARD_HEADERS token")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("AbstractHeaderMapper")]),e._v(" implementation now provides the additional "),n("code",[e._v("NON_STANDARD_HEADERS")]),e._v(" token to map any user-defined headers, which are not mapped by default.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-message-headers"}},[e._v("AMQP Message Headers")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"amqp-channels-template-channel-transacted"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-channels-template-channel-transacted"}},[e._v("#")]),e._v(" AMQP Channels: "),n("code",[e._v("template-channel-transacted")])]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("template-channel-transacted")]),e._v(" attribute for AMQP "),n("code",[e._v("MessageChannel")]),e._v(" instances.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-channels"}},[e._v("AMQP-backed Message Channels")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"syslog-adapter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#syslog-adapter"}},[e._v("#")]),e._v(" Syslog Adapter")]),e._v(" "),n("p",[e._v("The default syslog message converter now has an option to retain the original message in the payload while still setting the headers.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/syslog.html#syslog-inbound-adapter"}},[e._v("Syslog Inbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"asynchronous-gateway-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#asynchronous-gateway-2"}},[e._v("#")]),e._v(" Asynchronous Gateway")]),e._v(" "),n("p",[e._v("In addition to the "),n("code",[e._v("Promise")]),e._v(" return type "),n("a",{attrs:{href:"#x4.1-promise-gateway"}},[e._v("mentioned earlier")]),e._v(", gateway methods may now return a "),n("code",[e._v("ListenableFuture")]),e._v(", introduced in Spring Framework 4.0.\nYou can also disable asynchronous processing in the gateway, letting a downstream flow directly return a "),n("code",[e._v("Future")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#async-gateway"}},[e._v("Asynchronous Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-advice-chain"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-advice-chain"}},[e._v("#")]),e._v(" Aggregator Advice Chain")]),e._v(" "),n("p",[n("code",[e._v("Aggregator")]),e._v(" and "),n("code",[e._v("Resequencer")]),e._v(" now support "),n("code",[e._v("<expire-advice-chain/>")]),e._v(" and "),n("code",[e._v("<expire-transactional/>")]),e._v(" child elements to advise the "),n("code",[e._v("forceComplete")]),e._v(" operation.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-xml"}},[e._v("Configuring an Aggregator with XML")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"outbound-channel-adapter-and-scripts"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#outbound-channel-adapter-and-scripts"}},[e._v("#")]),e._v(" Outbound Channel Adapter and Scripts")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<int:outbound-channel-adapter/>")]),e._v(" now supports the "),n("code",[e._v("<script/>")]),e._v(" child element.\nThe underlying script must have a "),n("code",[e._v("void")]),e._v(" return type or return "),n("code",[e._v("null")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/groovy.html#groovy"}},[e._v("Groovy support")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/scripting.html#scripting"}},[e._v("Scripting Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"resequencer-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#resequencer-changes"}},[e._v("#")]),e._v(" Resequencer Changes")]),e._v(" "),n("p",[e._v("When a message group in a resequencer times out (using "),n("code",[e._v("group-timeout")]),e._v(" or a "),n("code",[e._v("MessageGroupStoreReaper")]),e._v("), late arriving messages are now, by default, discarded immediately.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/resequencer.html#resequencer"}},[e._v("Resequencer")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"optional-pojo-method-parameter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#optional-pojo-method-parameter"}},[e._v("#")]),e._v(" Optional POJO method parameter")]),e._v(" "),n("p",[e._v("Spring Integration now consistently handles the Java 8’s "),n("code",[e._v("Optional")]),e._v(" type.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/service-activator.html#service-activator-namespace"}},[e._v("Configuring Service Activator")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"queuechannel-backed-queue-type"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#queuechannel-backed-queue-type"}},[e._v("#")]),e._v(" "),n("code",[e._v("QueueChannel")]),e._v(" backed Queue type")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("QueueChannel")]),e._v(" backed "),n("code",[e._v("Queue type")]),e._v(" has been changed from "),n("code",[e._v("BlockingQueue")]),e._v(" to the more generic "),n("code",[e._v("Queue")]),e._v(".\nThis change allows the use of any external "),n("code",[e._v("Queue")]),e._v(" implementation (for example, Reactor’s "),n("code",[e._v("PersistentQueue")]),e._v(").\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-configuration-queuechannel"}},[n("code",[e._v("QueueChannel")]),e._v(" Configuration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"channelinterceptor-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#channelinterceptor-changes"}},[e._v("#")]),e._v(" "),n("code",[e._v("ChannelInterceptor")]),e._v(" Changes")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("ChannelInterceptor")]),e._v(" now supports additional "),n("code",[e._v("afterSendCompletion()")]),e._v(" and "),n("code",[e._v("afterReceiveCompletion()")]),e._v(" methods.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-interceptors"}},[e._v("Channel Interceptors")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"imap-peek"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#imap-peek"}},[e._v("#")]),e._v(" IMAP PEEK")]),e._v(" "),n("p",[e._v("Since version 4.1.1 there is a change of behavior if you explicitly set the "),n("code",[e._v("mail.[protocol].peek")]),e._v(" JavaMail property to "),n("code",[e._v("false")]),e._v(" (where "),n("code",[e._v("[protocol]")]),e._v(" is "),n("code",[e._v("imap")]),e._v(" or "),n("code",[e._v("imaps")]),e._v(").\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mail.html#imap-peek"}},[e._v("[IMPORTANT]")]),e._v(".")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-3-0-and-4-0"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-3-0-and-4-0"}},[e._v("#")]),e._v(" Changes between 3.0 and 4.0")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-3.0-to-4.0-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-9"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-9"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 4.0 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"mqtt-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mqtt-channel-adapters"}},[e._v("#")]),e._v(" MQTT Channel Adapters")]),e._v(" "),n("p",[e._v("The MQTT channel adapters (previously available in the Spring Integration Extensions repository) are now available as part of the normal Spring Integration distribution.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mqtt.html#mqtt"}},[e._v("MQTT Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"enableintegration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#enableintegration"}},[e._v("#")]),e._v(" "),n("code",[e._v("@EnableIntegration")])]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("@EnableIntegration")]),e._v(" annotation to permit declaration of standard Spring Integration beans when using "),n("code",[e._v("@Configuration")]),e._v(" classes.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"integrationcomponentscan"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integrationcomponentscan"}},[e._v("#")]),e._v(" "),n("code",[e._v("@IntegrationComponentScan")])]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("@IntegrationComponentScan")]),e._v(" annotation to permit classpath scanning for Spring Integration-specific components.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"enablemessagehistory"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#enablemessagehistory"}},[e._v("#")]),e._v(" “@EnableMessageHistory”")]),e._v(" "),n("p",[e._v("You can now enable message history with the "),n("code",[e._v("@EnableMessageHistory")]),e._v(" annotation in a "),n("code",[e._v("@Configuration")]),e._v(" class.\nIn addition, a JMX MBean can modify the message history settings.\nAlso, "),n("code",[e._v("MessageHistory")]),e._v(" can track auto-created "),n("code",[e._v("MessageHandler")]),e._v(" instances for annotated endpoints (such as "),n("code",[e._v("@ServiceActivator")]),e._v(", "),n("code",[e._v("@Splitter")]),e._v(", and others).\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-history.html#message-history"}},[e._v("Message History")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"messaginggateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#messaginggateway"}},[e._v("#")]),e._v(" "),n("code",[e._v("@MessagingGateway")])]),e._v(" "),n("p",[e._v("You can now configure messaging gateway interfaces with the "),n("code",[e._v("@MessagingGateway")]),e._v(" annotation.\nIt is an analogue of the "),n("code",[e._v("<int:gateway/>")]),e._v(" XML element.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#messaging-gateway-annotation"}},[n("code",[e._v("@MessagingGateway")]),e._v(" Annotation")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"spring-boot-enableautoconfiguration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spring-boot-enableautoconfiguration"}},[e._v("#")]),e._v(" Spring Boot "),n("code",[e._v("@EnableAutoConfiguration")])]),e._v(" "),n("p",[e._v("As well as the "),n("code",[e._v("@EnableIntegration")]),e._v(" annotation mentioned earlier, we introduced a hook to allow the Spring Integration infrastructure beans to be configured with Spring Boot’s "),n("code",[e._v("@EnableAutoConfiguration")]),e._v(" annotation.\nFor more information, see "),n("a",{attrs:{href:"https://docs.spring.io/spring-boot/docs/current/reference/html/using-boot-auto-configuration.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("“Auto-configuration”"),n("OutboundLink")],1),e._v(" in the Spring Boot Reference Guide.")]),e._v(" "),n("h5",{attrs:{id:"globalchannelinterceptor"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#globalchannelinterceptor"}},[e._v("#")]),e._v(" "),n("code",[e._v("@GlobalChannelInterceptor")])]),e._v(" "),n("p",[e._v("As well as the "),n("code",[e._v("@EnableIntegration")]),e._v(" annotation mentioned above, we introduced the "),n("code",[e._v("@GlobalChannelInterceptor")]),e._v(" annotation.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"integrationconverter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#integrationconverter"}},[e._v("#")]),e._v(" "),n("code",[e._v("@IntegrationConverter")])]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("@IntegrationConverter")]),e._v(" annotation as an analogue of the "),n("code",[e._v("<int:converter/>")]),e._v(" component.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"enablepublisher"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#enablepublisher"}},[e._v("#")]),e._v(" "),n("code",[e._v("@EnablePublisher")])]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("@EnablePublisher")]),e._v(" annotation to allow the specification of a "),n("code",[e._v("default-publisher-channel")]),e._v(" for "),n("code",[e._v("@Publisher")]),e._v(" annotations.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"redis-channel-message-stores"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-channel-message-stores"}},[e._v("#")]),e._v(" Redis Channel Message Stores")]),e._v(" "),n("p",[e._v("We added a Redis "),n("code",[e._v("MessageGroupStore")]),e._v(" that is optimized for use when backing a "),n("code",[e._v("QueueChannel")]),e._v(" for persistence.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-cms"}},[e._v("Redis Channel Message Stores")]),e._v(".")],1),e._v(" "),n("p",[e._v("We added a Redis "),n("code",[e._v("ChannelPriorityMessageStore")]),e._v(".\nYou can use it to retrieve messages by priority.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-cms"}},[e._v("Redis Channel Message Stores")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"mongoddb-channel-message-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongoddb-channel-message-store"}},[e._v("#")]),e._v(" MongodDB Channel Message Store")]),e._v(" "),n("p",[e._v("The MongoDB support now provides the "),n("code",[e._v("MongoDbChannelMessageStore")]),e._v(", which is a channel-specific "),n("code",[e._v("MessageStore")]),e._v(" implementation.\nWith "),n("code",[e._v("priorityEnabled = true")]),e._v(", you can use it in "),n("code",[e._v("<int:priority-queue>")]),e._v(" elements to achieve priority order polling of persisted messages.\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb-priority-channel-message-store"}},[e._v("MongoDB Channel Message Store")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"enableintegrationmbeanexport"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#enableintegrationmbeanexport"}},[e._v("#")]),e._v(" "),n("code",[e._v("@EnableIntegrationMBeanExport")])]),e._v(" "),n("p",[e._v("You can now enable the "),n("code",[e._v("IntegrationMBeanExporter")]),e._v(" with the "),n("code",[e._v("@EnableIntegrationMBeanExport")]),e._v(" annotation in a "),n("code",[e._v("@Configuration")]),e._v(" class.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jmx.html#jmx-mbean-exporter"}},[e._v("MBean Exporter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"channelsecurityinterceptorfactorybean"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#channelsecurityinterceptorfactorybean"}},[e._v("#")]),e._v(" "),n("code",[e._v("ChannelSecurityInterceptorFactoryBean")])]),e._v(" "),n("p",[n("code",[e._v("ChannelSecurityInterceptorFactoryBean")]),e._v(" now supports configuration of Spring Security for message channels that use "),n("code",[e._v("@Configuration")]),e._v(" classes.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/security.html#security"}},[e._v("Security in Spring Integration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redis-command-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-command-gateway"}},[e._v("#")]),e._v(" Redis Command Gateway")]),e._v(" "),n("p",[e._v("The Redis support now provides the "),n("code",[e._v("<outbound-gateway>")]),e._v(" component to perform generic Redis commands by using the "),n("code",[e._v("RedisConnection#execute")]),e._v(" method.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-outbound-gateway"}},[e._v("Redis Outbound Command Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redislockregistry-and-gemfirelockregistry"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redislockregistry-and-gemfirelockregistry"}},[e._v("#")]),e._v(" "),n("code",[e._v("RedisLockRegistry")]),e._v(" and "),n("code",[e._v("GemfireLockRegistry")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RedisLockRegistry")]),e._v(" and "),n("code",[e._v("GemfireLockRegistry")]),e._v(" are now available to support global locks visible to multiple application instances and servers.\nThese can be used with aggregating message handlers across multiple application instances such that group release occurs on only one instance.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-lock-registry"}},[e._v("Redis Lock Registry")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/gemfire.html#gemfire-lock-registry"}},[e._v("Gemfire Lock Registry")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"poller"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#poller"}},[e._v("#")]),e._v(" "),n("code",[e._v("@Poller")])]),e._v(" "),n("p",[e._v("Annotation-based messaging configuration can now have a "),n("code",[e._v("poller")]),e._v(" attribute.\nThis means that methods annotated with "),n("code",[e._v("@ServiceActivator")]),e._v(", "),n("code",[e._v("@Aggregator")]),e._v(", and similar annotations can now use an "),n("code",[e._v("inputChannel")]),e._v(" that is a reference to a "),n("code",[e._v("PollableChannel")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"inboundchanneladapter-and-smartlifecycle-for-annotated-endpoints"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inboundchanneladapter-and-smartlifecycle-for-annotated-endpoints"}},[e._v("#")]),e._v(" "),n("code",[e._v("@InboundChannelAdapter")]),e._v(" and "),n("code",[e._v("SmartLifecycle")]),e._v(" for Annotated Endpoints")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("@InboundChannelAdapter")]),e._v(" method annotation.\nIt is an analogue of the "),n("code",[e._v("<int:inbound-channel-adapter>")]),e._v(" XML component.\nIn addition, all messaging annotations now provide "),n("code",[e._v("SmartLifecycle")]),e._v(" options.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"twitter-search-outbound-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#twitter-search-outbound-gateway"}},[e._v("#")]),e._v(" Twitter Search Outbound Gateway")]),e._v(" "),n("p",[e._v("We added a new twitter endpoint: "),n("code",[e._v("<int-twitter-search-outbound-gateway/>")]),e._v(".\nUnlike the search inbound adapter, which polls by using the same search query each time, the outbound gateway allows on-demand customized queries.\nFor more information, see "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-extensions/tree/main/spring-integration-social-twitter",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration Social Twitter"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"gemfire-metadata-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gemfire-metadata-store"}},[e._v("#")]),e._v(" Gemfire Metadata Store")]),e._v(" "),n("p",[e._v("We added the "),n("code",[e._v("GemfireMetadataStore")]),e._v(", letting it be used, for example, in an "),n("code",[e._v("AbstractPersistentAcceptOnceFileListFilter")]),e._v(" implementation in a multiple application instance or server environment.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/meta-data-store.html#metadata-store"}},[e._v("Metadata Store")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-reading"}},[e._v("Reading Files")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-inbound"}},[e._v("FTP Inbound Channel Adapter")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-inbound"}},[e._v("SFTP Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"bridgefrom-and-bridgeto-annotations"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#bridgefrom-and-bridgeto-annotations"}},[e._v("#")]),e._v(" "),n("code",[e._v("@BridgeFrom")]),e._v(" and "),n("code",[e._v("@BridgeTo")]),e._v(" Annotations")]),e._v(" "),n("p",[e._v("We introduced "),n("code",[e._v("@BridgeFrom")]),e._v(" and "),n("code",[e._v("@BridgeTo")]),e._v(" "),n("code",[e._v("@Bean")]),e._v(" method annotations to mark "),n("code",[e._v("MessageChannel")]),e._v(" beans in "),n("code",[e._v("@Configuration")]),e._v(" classes.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"meta-messaging-annotations"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#meta-messaging-annotations"}},[e._v("#")]),e._v(" Meta-messaging Annotations")]),e._v(" "),n("p",[e._v("Messaging annotations ("),n("code",[e._v("@ServiceActivator")]),e._v(", "),n("code",[e._v("@Router")]),e._v(", "),n("code",[e._v("@MessagingGateway")]),e._v(", and others) can now be configured as meta-annotations for user-defined messaging annotations.\nIn addition, the user-defined annotations can have the same attributes ("),n("code",[e._v("inputChannel")]),e._v(", "),n("code",[e._v("@Poller")]),e._v(", "),n("code",[e._v("autoStartup")]),e._v(", and others).\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-9"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-9"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes from version 3.0 to version 4.0.")]),e._v(" "),n("h5",{attrs:{id:"requires-spring-framework-4-0"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#requires-spring-framework-4-0"}},[e._v("#")]),e._v(" Requires Spring Framework 4.0")]),e._v(" "),n("p",[e._v("We moved the core messaging abstractions ("),n("code",[e._v("Message")]),e._v(", "),n("code",[e._v("MessageChannel")]),e._v(", and others) to the Spring Framework "),n("code",[e._v("spring-messaging")]),e._v(" module.\nDevelopers who reference these classes directly in their code need to make changes, as described in the first section of the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-3.0-to-4.0-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("3.0 to 4.0 Migration Guide"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"header-type-for-xpath-header-enricher"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#header-type-for-xpath-header-enricher"}},[e._v("#")]),e._v(" Header Type for XPath Header Enricher")]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("header-type")]),e._v(" attribute for the "),n("code",[e._v("header")]),e._v(" child element of the "),n("code",[e._v("<int-xml:xpath-header-enricher>")]),e._v(".\nThis attribute provides the target type for the header value (to which the result of the XPath expression evaluation is converted).\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/xml.html#xml-xpath-header-enricher"}},[e._v("XPath Header Enricher")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"object-to-json-transformer-node-result"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#object-to-json-transformer-node-result"}},[e._v("#")]),e._v(" Object To JSON Transformer: Node Result")]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("result-type")]),e._v(" attribute for the "),n("code",[e._v("<int:object-to-json-transformer>")]),e._v(".\nThis attribute provides the target type for the result of mapping an object to JSON.\nIt supports "),n("code",[e._v("STRING")]),e._v(" (the default) and "),n("code",[e._v("NODE")]),e._v(".\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer-xpath-spel-function"}},[e._v("Since version 3.0, Spring Integration also provides a built-in "),n("code",[e._v("#xpath")]),e._v(" SpEL function for use in expressions.")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jms-header-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-header-mapping"}},[e._v("#")]),e._v(" JMS Header Mapping")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("DefaultJmsHeaderMapper")]),e._v(" now maps an incoming "),n("code",[e._v("JMSPriority")]),e._v(" header to the Spring Integration "),n("code",[e._v("priority")]),e._v(" header.\nPreviously, "),n("code",[e._v("priority")]),e._v(" was only considered for outbound messages.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-header-mapping"}},[e._v("Mapping Message Headers to and from JMS Message")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jms-outbound-channel-adapter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-outbound-channel-adapter"}},[e._v("#")]),e._v(" JMS Outbound Channel Adapter")]),e._v(" "),n("p",[e._v("The JMS outbound channel adapter now supports the "),n("code",[e._v("session-transacted")]),e._v(" attribute (default: "),n("code",[e._v("false")]),e._v(").\nPreviously, you had to inject a customized "),n("code",[e._v("JmsTemplate")]),e._v(" to use transactions.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-outbound-channel-adapter"}},[e._v("Outbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jms-inbound-channel-adapter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-inbound-channel-adapter"}},[e._v("#")]),e._v(" JMS Inbound Channel Adapter")]),e._v(" "),n("p",[e._v("The JMS inbound channel adapter now supports the "),n("code",[e._v("session-transacted")]),e._v(" attribute (default: "),n("code",[e._v("false")]),e._v(").\nPreviously, you had to inject a customized "),n("code",[e._v("JmsTemplate")]),e._v(" to use transactions.\nThe adapter allowed 'transacted' in the "),n("code",[e._v("acknowledgeMode")]),e._v(", which was incorrect and didn’t work.\nThis value is no longer allowed.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jms.html#jms-inbound-channel-adapter"}},[e._v("Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"datatype-channels"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#datatype-channels"}},[e._v("#")]),e._v(" Datatype Channels")]),e._v(" "),n("p",[e._v("You can now specify a "),n("code",[e._v("MessageConverter")]),e._v(" to be used when converting (if necessary) payloads to one of the accepted "),n("code",[e._v("datatype")]),e._v(" instances in a Datatype channel.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-datatype-channel"}},[e._v("Datatype Channel Configuration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"simpler-retry-advice-configuration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#simpler-retry-advice-configuration"}},[e._v("#")]),e._v(" Simpler Retry Advice Configuration")]),e._v(" "),n("p",[e._v("We added simplified namespace support to configure a "),n("code",[e._v("RequestHandlerRetryAdvice")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#retry-config"}},[e._v("Configuring the Retry Advice")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"correlation-endpoint-time-based-release-strategy"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#correlation-endpoint-time-based-release-strategy"}},[e._v("#")]),e._v(" Correlation Endpoint: Time-based Release Strategy")]),e._v(" "),n("p",[e._v("We added the mutually exclusive "),n("code",[e._v("group-timeout")]),e._v(" and "),n("code",[e._v("group-timeout-expression")]),e._v(" attributes to "),n("code",[e._v("<int:aggregator>")]),e._v(" and "),n("code",[e._v("<int:resequencer>")]),e._v(".\nThese attributes allow forced completion of a partial "),n("code",[e._v("MessageGroup")]),e._v(", provided the "),n("code",[e._v("ReleaseStrategy")]),e._v(" does not release a group and no further messages arrive within the time specified.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-xml"}},[e._v("Configuring an Aggregator with XML")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redis-metadata-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-metadata-store"}},[e._v("#")]),e._v(" Redis Metadata Store")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("RedisMetadataStore")]),e._v(" now implements "),n("code",[e._v("ConcurrentMetadataStore")]),e._v(", letting it be used, for example, in an "),n("code",[e._v("AbstractPersistentAcceptOnceFileListFilter")]),e._v(" implementation in a multiple application instance or server environment.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-metadata-store"}},[e._v("Redis Metadata Store")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-reading"}},[e._v("Reading Files")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-inbound"}},[e._v("FTP Inbound Channel Adapter")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-inbound"}},[e._v("SFTP Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jdbcchannelmessagestore-and-prioritychannel"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbcchannelmessagestore-and-prioritychannel"}},[e._v("#")]),e._v(" "),n("code",[e._v("JdbcChannelMessageStore")]),e._v(" and "),n("code",[e._v("PriorityChannel")])]),e._v(" "),n("p",[e._v("T"),n("code",[e._v("JdbcChannelMessageStore")]),e._v(" now implements "),n("code",[e._v("PriorityCapableChannelMessageStore")]),e._v(", letting it be used as a "),n("code",[e._v("message-store")]),e._v(" reference for "),n("code",[e._v("priority-queue")]),e._v(" instances.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-message-store-channels"}},[e._v("Backing Message Channels")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"amqp-endpoints-delivery-mode"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-endpoints-delivery-mode"}},[e._v("#")]),e._v(" AMQP Endpoints Delivery Mode")]),e._v(" "),n("p",[e._v("Spring AMQP, by default, creates persistent messages on the broker.\nYou can override this behavior by setting the "),n("code",[e._v("amqp_deliveryMode")]),e._v(" header or customizing the mappers.\nWe added a convenient "),n("code",[e._v("default-delivery-mode")]),e._v(" attribute to the adapters to provide easier configuration of this important setting.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-outbound-channel-adapter"}},[e._v("Outbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp-outbound-gateway"}},[e._v("Outbound Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"ftp-timeouts"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-timeouts"}},[e._v("#")]),e._v(" FTP Timeouts")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("DefaultFtpSessionFactory")]),e._v(" now exposes the "),n("code",[e._v("connectTimeout")]),e._v(", "),n("code",[e._v("defaultTimeout")]),e._v(", and "),n("code",[e._v("dataTimeout")]),e._v(" properties, avoiding the need to subclass the factory to set these common properties.\nThe "),n("code",[e._v("postProcess*")]),e._v(" methods are still available for more advanced configuration.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-session-factory"}},[e._v("FTP Session Factory")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"twitter-statusupdatingmessagehandler"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#twitter-statusupdatingmessagehandler"}},[e._v("#")]),e._v(" Twitter: "),n("code",[e._v("StatusUpdatingMessageHandler")])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("StatusUpdatingMessageHandler")]),e._v(" ("),n("code",[e._v("<int-twitter:outbound-channel-adapter>")]),e._v(") now supports the "),n("code",[e._v("tweet-data-expression")]),e._v(" attribute to build a "),n("code",[e._v("org.springframework.social.twitter.api.TweetData")]),e._v(" object for updating the timeline status.\nThis feature allows, for example, attaching an image.\nSee "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-extensions/tree/main/spring-integration-social-twitter",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration Social Twitter"),n("OutboundLink")],1),e._v(" for more information.")]),e._v(" "),n("h5",{attrs:{id:"jpa-retrieving-gateway-id-expression"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jpa-retrieving-gateway-id-expression"}},[e._v("#")]),e._v(" JPA Retrieving Gateway: "),n("code",[e._v("id-expression")])]),e._v(" "),n("p",[e._v("We introduced the "),n("code",[e._v("id-expression")]),e._v(" attribute for "),n("code",[e._v("<int-jpa:retrieving-outbound-gateway>")]),e._v(" to perform "),n("code",[e._v("EntityManager.find(Class entityClass, Object primaryKey)")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-retrieving-outbound-gateway"}},[e._v("Retrieving Outbound Gateway")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"tcp-deserialization-events"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-deserialization-events"}},[e._v("#")]),e._v(" TCP Deserialization Events")]),e._v(" "),n("p",[e._v("When one of the standard deserializers encounters a problem decoding the input stream to a message, it now emits a "),n("code",[e._v("TcpDeserializationExceptionEvent")]),e._v(", letting applications examine the data at the point at which the exception occurred.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-events"}},[e._v("TCP Connection Events")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"messaging-annotations-on-bean-definitions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#messaging-annotations-on-bean-definitions"}},[e._v("#")]),e._v(" Messaging Annotations on "),n("code",[e._v("@Bean")]),e._v(" Definitions")]),e._v(" "),n("p",[e._v("You can now configure messaging annotations ("),n("code",[e._v("@ServiceActivator")]),e._v(", "),n("code",[e._v("@Router")]),e._v(", "),n("code",[e._v("@InboundChannelAdapter")]),e._v(", and others) on "),n("code",[e._v("@Bean")]),e._v(" definitions in "),n("code",[e._v("@Configuration")]),e._v(" classes.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/configuration.html#annotations"}},[e._v("Annotation Support")]),e._v(".")],1),e._v(" "),n("h3",{attrs:{id:"changes-between-2-2-and-3-0"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-2-2-and-3-0"}},[e._v("#")]),e._v(" Changes Between 2.2 and 3.0")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-2.2-to-3.0-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-10"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-10"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 3.0 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"http-request-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-request-mapping"}},[e._v("#")]),e._v(" HTTP Request Mapping")]),e._v(" "),n("p",[e._v("The HTTP module now provides powerful request mapping support for inbound endpoints.\nWe replaced the "),n("code",[e._v("UriPathHandlerMapping")]),e._v(" class with "),n("code",[e._v("IntegrationRequestMappingHandlerMapping")]),e._v(", which is registered under the bean name of "),n("code",[e._v("integrationRequestMappingHandlerMapping")]),e._v(" in the application context.\nUpon parsing of the HTTP inbound endpoint, either a new "),n("code",[e._v("IntegrationRequestMappingHandlerMapping")]),e._v(" bean is registered or an existing bean is reused.\nTo achieve flexible request mapping configuration, Spring Integration provides the "),n("code",[e._v("<request-mapping/>")]),e._v(" child element for "),n("code",[e._v("<http:inbound-channel-adapter/>")]),e._v(" and the "),n("code",[e._v("<http:inbound-gateway/>")]),e._v(".\nBoth HTTP inbound endpoints are now fully based on the request mapping infrastructure that was introduced with Spring MVC 3.1.\nFor example, multiple paths are supported on a single inbound endpoint.\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-namespace"}},[e._v("HTTP Namespace Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"configuration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#configuration"}},[e._v("#")]),e._v(" Configuration")]),e._v(" "),n("p",[e._v("We added a new "),n("code",[e._v("IntegrationEvaluationContextFactoryBean")]),e._v(" to allow configuration of custom "),n("code",[e._v("PropertyAccessor")]),e._v(" implementations and functions for use in SpEL expressions throughout the framework.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/spel.html#spel"}},[e._v("Spring Expression Language (SpEL)")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"spel-functions-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spel-functions-support"}},[e._v("#")]),e._v(" SpEL Functions Support")]),e._v(" "),n("p",[e._v("To customize the SpEL "),n("code",[e._v("EvaluationContext")]),e._v(" with static "),n("code",[e._v("Method")]),e._v(" functions, we introduced the "),n("code",[e._v("<spel-function/>")]),e._v(" component.\nWe also added two built-in functions: "),n("code",[e._v("#jsonPath")]),e._v(" and "),n("code",[e._v("#xpath")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/spel.html#spel-functions"}},[e._v("SpEL Functions")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"spel-propertyaccessors-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spel-propertyaccessors-support"}},[e._v("#")]),e._v(" SpEL PropertyAccessors Support")]),e._v(" "),n("p",[e._v("To customize the SpEL "),n("code",[e._v("EvaluationContext")]),e._v(" with "),n("code",[e._v("PropertyAccessor")]),e._v(" implementations, we added the "),n("code",[e._v("<spel-property-accessors/>")]),e._v(" component.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/spel.html#spel-property-accessors"}},[e._v("Property Accessors")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redis-new-components"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-new-components"}},[e._v("#")]),e._v(" Redis: New Components")]),e._v(" "),n("p",[e._v("We added a new Redis-based "),n("a",{attrs:{href:"https://docs.spring.io/spring-integration/api/org/springframework/integration/metadata/MetadataStore.html",target:"_blank",rel:"noopener noreferrer"}},[n("code",[e._v("MetadataStore")]),n("OutboundLink")],1),e._v(" implementation.\nYou can use the "),n("code",[e._v("RedisMetadataStore")]),e._v(" to maintain the state of a "),n("code",[e._v("MetadataStore")]),e._v(" across application restarts.\nThis new "),n("code",[e._v("MetadataStore")]),e._v(" implementation can be used with adapters, such as:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("Twitter inbound adapters")])]),e._v(" "),n("li",[n("p",[e._v("Feed inbound channel adapter")])])]),e._v(" "),n("p",[e._v("We added new queue-based components.\nWe added the "),n("code",[e._v("<int-redis:queue-inbound-channel-adapter/>")]),e._v(" and "),n("code",[e._v("<int-redis:queue-outbound-channel-adapter/>")]),e._v(" components to perform 'right pop' and 'left push' operations, respectively, on a Redis List.")]),e._v(" "),n("p",[e._v("For more information, “see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis"}},[e._v("Redis Support")]),e._v("”.")],1),e._v(" "),n("h5",{attrs:{id:"header-channel-registry-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#header-channel-registry-2"}},[e._v("#")]),e._v(" Header Channel Registry")]),e._v(" "),n("p",[e._v("You can now instruct the framework to store reply channels and error channels in a registry for later resolution.\nThis is useful for cases where the "),n("code",[e._v("replyChannel")]),e._v(" or "),n("code",[e._v("errorChannel")]),e._v(" might be lost (for example, when serializing a message).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#header-enricher"}},[e._v("Header Enricher")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"mongodb-support-new-configurablemongodbmessagestore"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-support-new-configurablemongodbmessagestore"}},[e._v("#")]),e._v(" MongoDB support: New "),n("code",[e._v("ConfigurableMongoDbMessageStore")])]),e._v(" "),n("p",[e._v("In addition to the existing "),n("code",[e._v("eMongoDbMessageStore")]),e._v(", we introduced a new "),n("code",[e._v("ConfigurableMongoDbMessageStore")]),e._v(".\nThis provides a more robust and flexible implementation of "),n("code",[e._v("MessageStore")]),e._v(" for MongoDB.\nIt does not have backward compatibility with the existing store, but we recommend using it for new applications.\nExisting applications can use it, but messages in the old store are not available.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb"}},[e._v("MongoDb Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"syslog-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#syslog-support"}},[e._v("#")]),e._v(" Syslog Support")]),e._v(" "),n("p",[e._v("Building on the 2.2 "),n("code",[e._v("SyslogToMapTransformer")]),e._v(", Spring Integration 3.0 introduces "),n("code",[e._v("UDP")]),e._v(" and "),n("code",[e._v("TCP")]),e._v(" inbound channel adapters especially tailored for receiving SYSLOG messages.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/syslog.html#syslog"}},[e._v("Syslog Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"tail-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tail-support"}},[e._v("#")]),e._v(" "),n("code",[e._v("tail")]),e._v(" Support")]),e._v(" "),n("p",[e._v("We added file inbound channel adapters that use the "),n("code",[e._v("tail")]),e._v(" command to generate messages when lines are added to the end of text files.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-tailing"}},[e._v("'tail’ing Files")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jmx-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jmx-support"}},[e._v("#")]),e._v(" JMX Support")]),e._v(" "),n("p",[e._v("We added "),n("code",[e._v("<int-jmx:tree-polling-channel-adapter/>")]),e._v(".\nThis adapter queries the JMX MBean tree and sends a message with a payload that is the graph of objects that match the query.\nBy default, the MBeans are mapped to primitives and simple Objects (such as "),n("code",[e._v("Map")]),e._v(", "),n("code",[e._v("List")]),e._v(", and arrays).\nIt permits simple transformation to, for example, JSON.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("IntegrationMBeanExporter")]),e._v(" now allows the configuration of a custom "),n("code",[e._v("ObjectNamingStrategy")]),e._v(" by using the "),n("code",[e._v("naming-strategy")]),e._v(" attribute.")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jmx.html#jmx"}},[e._v("JMX Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"tcp-ip-connection-events-and-connection-management"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-ip-connection-events-and-connection-management"}},[e._v("#")]),e._v(" TCP/IP Connection Events and Connection Management")]),e._v(" "),n("p",[n("code",[e._v("TcpConnection")]),e._v(" instances now emit "),n("code",[e._v("ApplicationEvent")]),e._v(" instances (specifically "),n("code",[e._v("TcpConnectionEvent")]),e._v(" instances) when connections are opened or closed or when an exception occurs.\nThis change lets applications be informed of changes to TCP connections by using the normal Spring "),n("code",[e._v("ApplicationListener")]),e._v(" mechanism.")]),e._v(" "),n("p",[e._v("We renamed "),n("code",[e._v("AbstractTcpConnection")]),e._v(" to "),n("code",[e._v("TcpConnectionSupport")]),e._v(".\nCustom connections that are subclasses of this class can use its methods to publish events.\nSimilarly, we renamed "),n("code",[e._v("AbstractTcpConnectionInterceptor")]),e._v(" to "),n("code",[e._v("TcpConnectionInterceptorSupport")]),e._v(".")]),e._v(" "),n("p",[e._v("In addition, we added "),n("code",[e._v("<int-ip:tcp-connection-event-inbound-channel-adapter/>")]),e._v(".\nBy default, this adapter sends all "),n("code",[e._v("TcpConnectionEvent")]),e._v(" instances to a "),n("code",[e._v("Channel")]),e._v(".")]),e._v(" "),n("p",[e._v("Further, the TCP connection factories now provide a new method called "),n("code",[e._v("getOpenConnectionIds()")]),e._v(", which returns a list of identifiers for all open connections.\nIt lets applications broadcast to all open connections, among other uses.")]),e._v(" "),n("p",[e._v("Finally, the connection factories also provide a new method called "),n("code",[e._v("closeConnection(String connectionId)")]),e._v(", which lets applications explicitly close a connection by using its ID.")]),e._v(" "),n("p",[e._v("For more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#tcp-events"}},[e._v("TCP Connection Events")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"inbound-channel-adapter-script-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#inbound-channel-adapter-script-support"}},[e._v("#")]),e._v(" Inbound Channel Adapter Script Support")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("<int:inbound-channel-adapter/>")]),e._v(" now supports using "),n("code",[e._v("<expression/>")]),e._v(" and "),n("code",[e._v("<script/>")]),e._v(" child elements to create a "),n("code",[e._v("MessageSource")]),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel-adapter.html#channel-adapter-expressions-and-scripts"}},[e._v("Channel Adapter Expressions and Scripts")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"content-enricher-headers-enrichment-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#content-enricher-headers-enrichment-support"}},[e._v("#")]),e._v(" Content Enricher: Headers Enrichment Support")]),e._v(" "),n("p",[e._v("The content enricher now provides configuration for "),n("code",[e._v("<header/>")]),e._v(" child elements, to enrich the outbound message with headers based on the reply message from the underlying message flow.\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#payload-enricher"}},[e._v("Payload Enricher")]),e._v(".")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-10"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-10"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes from version 2.2 to version 3.0.")]),e._v(" "),n("h5",{attrs:{id:"message-id-generation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-id-generation"}},[e._v("#")]),e._v(" Message ID Generation")]),e._v(" "),n("p",[e._v("Previously, message IDs were generated by using the JDK "),n("code",[e._v("UUID.randomUUID()")]),e._v(" method.\nWith this release, the default mechanism has been changed to use a more efficient and significantly faster algorithm.\nIn addition, we added the ability to change the strategy used to generate message IDs.\nFor more information see "),n("RouterLink",{attrs:{to:"/en/spring-integration/message.html#message-id-generation"}},[e._v("Message ID Generation")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"gateway-changes-3"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gateway-changes-3"}},[e._v("#")]),e._v(" “<gateway>” Changes")]),e._v(" "),n("p",[e._v("You can now set common headers across all gateway methods, and we added more options for adding information to the message about which method was invoked.")]),e._v(" "),n("p",[e._v("You can now entirely customize the way that gateway method calls are mapped to messages.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("GatewayMethodMetadata")]),e._v(" is now a public class.\nIt lets you programmatically configure the "),n("code",[e._v("GatewayProxyFactoryBean")]),e._v(" from Java.")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway"}},[e._v("Messaging Gateways")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"http-endpoint-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-endpoint-changes"}},[e._v("#")]),e._v(" HTTP Endpoint Changes")]),e._v(" "),n("ul",[n("li",[n("p",[n("strong",[e._v("Outbound Endpoint "),n("code",[e._v("encode-uri")])]),e._v(": "),n("code",[e._v("<http:outbound-gateway/>")]),e._v(" and "),n("code",[e._v("<http:outbound-channel-adapter/>")]),e._v(" now provide an "),n("code",[e._v("encode-uri")]),e._v(" attribute to allow disabling the encoding of the URI object before sending the request.")])]),e._v(" "),n("li",[n("p",[n("strong",[e._v("Inbound Endpoint "),n("code",[e._v("merge-with-default-converters")])]),e._v(": "),n("code",[e._v("<http:inbound-gateway/>")]),e._v(" and "),n("code",[e._v("<http:inbound-channel-adapter/>")]),e._v(" now have a "),n("code",[e._v("merge-with-default-converters")]),e._v(" attribute to include the list of default "),n("code",[e._v("HttpMessageConverter")]),e._v(" instances after the custom message converters.")])]),e._v(" "),n("li",[n("p",[n("strong",[n("code",[e._v("If-Modified-Since")]),e._v(" and "),n("code",[e._v("If-Unmodified-Since")]),e._v(" HTTP Headers")]),e._v(": Previously, the "),n("code",[e._v("If-Modified-Since")]),e._v(" and "),n("code",[e._v("If-Unmodified-Since")]),e._v(" HTTP headers were incorrectly processed within from and to HTTP headers mapped in the "),n("code",[e._v("DefaultHttpHeaderMapper")]),e._v(".\nNow, in addition to correcting that issue, "),n("code",[e._v("DefaultHttpHeaderMapper")]),e._v(" provides date parsing from formatted strings for any HTTP headers that accept date-time values.")])]),e._v(" "),n("li",[n("p",[n("strong",[e._v("Inbound Endpoint Expression Variables")]),e._v(": In addition to the existing "),n("code",[e._v("#requestParams")]),e._v(" and "),n("code",[e._v("#pathVariables")]),e._v(", the "),n("code",[e._v("<http:inbound-gateway/>")]),e._v(" and "),n("code",[e._v("<http:inbound-channel-adapter/>")]),e._v(" now support additional useful variables: "),n("code",[e._v("#matrixVariables")]),e._v(", "),n("code",[e._v("#requestAttributes")]),e._v(", "),n("code",[e._v("#requestHeaders")]),e._v(", and "),n("code",[e._v("#cookies")]),e._v(".\nThese variables are available in both payload and header expressions.")])]),e._v(" "),n("li",[n("p",[n("strong",[e._v("Outbound Endpoint 'uri-variables-expression'")]),e._v(": HTTP outbound endpoints now support the "),n("code",[e._v("uri-variables-expression")]),e._v(" attribute to specify an "),n("code",[e._v("Expression")]),e._v(" to evaluate a "),n("code",[e._v("Map")]),e._v(" for all URI variable placeholders within URL template.\nThis allows selection of a different map of expressions based on the outgoing message.")])])]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http"}},[e._v("HTTP Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:""}},[n("a",{staticClass:"header-anchor",attrs:{href:"#"}},[e._v("#")])]),e._v(" "),n("ul",[n("li",[n("p",[e._v("A new abstraction for JSON conversion has been introduced.\nImplementations for Jackson 1.x and Jackson 2 are currently provided, with the version being determined by presence on the classpath.\nPreviously, only Jackson 1.x was supported.")])]),e._v(" "),n("li",[n("p",[e._v("The "),n("code",[e._v("ObjectToJsonTransformer")]),e._v(" and "),n("code",[e._v("JsonToObjectTransformer")]),e._v(" now emit/consume headers containing type information.")])])]),e._v(" "),n("p",[e._v("For more information, see “JSON Transformers” in "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"chain-elements-id-attribute"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#chain-elements-id-attribute"}},[e._v("#")]),e._v(" Chain Elements "),n("code",[e._v("id")]),e._v(" Attribute")]),e._v(" "),n("p",[e._v("Previously, the "),n("code",[e._v("id")]),e._v(" attribute for elements within a "),n("code",[e._v("<chain>")]),e._v(" was ignored and, in some cases, disallowed.\nNow, the "),n("code",[e._v("id")]),e._v(" attribute is allowed for all elements within a "),n("code",[e._v("<chain>")]),e._v(".\nThe bean names of chain elements is a combination of the surrounding chain’s "),n("code",[e._v("id")]),e._v(" and the "),n("code",[e._v("id")]),e._v(" of the element itself.\nFor example: 'myChain$child.myTransformer.handler'.\nFor more information see, "),n("RouterLink",{attrs:{to:"/en/spring-integration/chain.html#chain"}},[e._v("Message Handler Chain")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"aggregator-empty-group-min-timeout-property"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#aggregator-empty-group-min-timeout-property"}},[e._v("#")]),e._v(" Aggregator 'empty-group-min-timeout' property")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("AbstractCorrelatingMessageHandler")]),e._v(" provides a new property called "),n("code",[e._v("empty-group-min-timeout")]),e._v(" to allow empty group expiry to run on a longer schedule than expiring partial groups.\nEmpty groups are not removed from the "),n("code",[e._v("MessageStore")]),e._v(" until they have not been modified for at least this number of milliseconds.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator-xml"}},[e._v("Configuring an Aggregator with XML")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#-2"}},[e._v("#")])]),e._v(" "),n("p",[e._v("New "),n("code",[e._v("FileListFilter")]),e._v(" implementations that use a persistent "),n("code",[e._v("MetadataStore")]),e._v(" are now available.\nYou can use these to prevent duplicate files after a system restart.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-reading"}},[e._v("Reading Files")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-inbound"}},[e._v("FTP Inbound Channel Adapter")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-inbound"}},[e._v("SFTP Inbound Channel Adapter")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"scripting-support-variables-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#scripting-support-variables-changes"}},[e._v("#")]),e._v(" Scripting Support: Variables Changes")]),e._v(" "),n("p",[e._v("We introduced a new "),n("code",[e._v("variables")]),e._v(" attribute for scripting components.\nIn addition, variable bindings are now allowed for inline scripts.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/groovy.html#groovy"}},[e._v("Groovy support")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/scripting.html#scripting"}},[e._v("Scripting Support")]),e._v(" for more information.")],1),e._v(" "),n("h5",{attrs:{id:"direct-channel-load-balancing-configuration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#direct-channel-load-balancing-configuration"}},[e._v("#")]),e._v(" Direct Channel Load Balancing configuration")]),e._v(" "),n("p",[e._v("Previously, when configuring "),n("code",[e._v("LoadBalancingStrategy")]),e._v(" on the channel’s "),n("code",[e._v("dispatcher")]),e._v(" child element, the only available option was to use a pre-defined enumeration of values which did not let developers set a custom implementation of the "),n("code",[e._v("LoadBalancingStrategy")]),e._v(".\nYou can now use "),n("code",[e._v("load-balancer-ref")]),e._v(" to provide a reference to a custom implementation of the "),n("code",[e._v("LoadBalancingStrategy")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-implementations-directchannel"}},[n("code",[e._v("DirectChannel")])]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"publishsubscribechannel-behavior"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#publishsubscribechannel-behavior"}},[e._v("#")]),e._v(" PublishSubscribeChannel Behavior")]),e._v(" "),n("p",[e._v("Previously, sending to a <publish-subscribe-channel/> that had no subscribers would return a "),n("code",[e._v("false")]),e._v(" result.\nIf used in conjunction with a "),n("code",[e._v("MessagingTemplate")]),e._v(", this would result in an exception being thrown.\nNow, the "),n("code",[e._v("PublishSubscribeChannel")]),e._v(" has a property called "),n("code",[e._v("minSubscribers")]),e._v(" (default: "),n("code",[e._v("0")]),e._v(").\nIf the message is sent to at least the minimum number of subscribers, the send operation is deemed to be successful (even if the number is zero).\nIf an application expects to get an exception under these conditions, set the minimum subscribers to at least 1.")]),e._v(" "),n("h5",{attrs:{id:"ftp-sftp-and-ftps-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-sftp-and-ftps-changes"}},[e._v("#")]),e._v(" FTP, SFTP and FTPS Changes")]),e._v(" "),n("p",[e._v("The FTP, SFTP and FTPS endpoints no longer cache sessions by default.")]),e._v(" "),n("p",[e._v("We removed the deprecated "),n("code",[e._v("cached-sessions")]),e._v(" attribute from all endpoints.\nPreviously, the embedded caching mechanism controlled by this attribute’s value did not provide a way to limit the size of the cache, which could grow indefinitely.\nRelease 2.1 introduced "),n("code",[e._v("CachingConnectionFactory")]),e._v(", and it became the preferred (and is now the only) way to cache sessions.")]),e._v(" "),n("p",[n("code",[e._v("CachingConnectionFactory")]),e._v(" now provides a new method: "),n("code",[e._v("resetCache()")]),e._v(".\nThis method immediately closes idle sessions and causes in-use sessions to be closed as and when they are returned to the cache.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("DefaultSftpSessionFactory")]),e._v(" (in conjunction with a "),n("code",[e._v("CachingSessionFactory")]),e._v(") now supports multiplexing channels over a single SSH connection (SFTP Only).")]),e._v(" "),n("h6",{attrs:{id:"ftp-sftp-and-ftps-inbound-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-sftp-and-ftps-inbound-adapters"}},[e._v("#")]),e._v(" FTP, SFTP and FTPS Inbound Adapters")]),e._v(" "),n("p",[e._v("Previously, there was no way to override the default filter used to process files retrieved from a remote server.\nThe "),n("code",[e._v("filter")]),e._v(" attribute determines which files are retrieved, but the "),n("code",[e._v("FileReadingMessageSource")]),e._v(" uses an "),n("code",[e._v("AcceptOnceFileListFilter")]),e._v(".\nThis means that, if a new copy of a file is retrieved with the same name as a previously copied file, no message was sent from the adapter.")]),e._v(" "),n("p",[e._v("With this release, a new attribute "),n("code",[e._v("local-filter")]),e._v(" lets you override the default filter (for example, with an "),n("code",[e._v("AcceptAllFileListFilter")]),e._v(" or some other custom filter).")]),e._v(" "),n("p",[e._v("If you want the behavior of the "),n("code",[e._v("AcceptOnceFileListFilter")]),e._v(" to be maintained across JVM executions, you can now configure a custom filter that retains state, perhaps on the file system.")]),e._v(" "),n("p",[e._v("Inbound channel adapters now support the "),n("code",[e._v("preserve-timestamp")]),e._v(" attribute, which sets the local file modified timestamp to the timestamp from the server (default: "),n("code",[e._v("false")]),e._v(").")]),e._v(" "),n("h6",{attrs:{id:"ftp-sftp-and-ftps-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-sftp-and-ftps-gateways"}},[e._v("#")]),e._v(" FTP, SFTP, and FTPS Gateways")]),e._v(" "),n("p",[e._v("The gateways now support the "),n("code",[e._v("mv")]),e._v(" command, enabling the renaming of remote files.")]),e._v(" "),n("p",[e._v("The gateways now support recursive "),n("code",[e._v("ls")]),e._v(" and "),n("code",[e._v("mget")]),e._v(" commands, enabling the retrieval of a remote file tree.")]),e._v(" "),n("p",[e._v("The gateways now support "),n("code",[e._v("put")]),e._v(" and "),n("code",[e._v("mput")]),e._v(" commands, enabling sending files to the remote server.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("local-filename-generator-expression")]),e._v(" attribute is now supported, enabling the naming of local files during retrieval.\nBy default, the same name as the remote file is used.")]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("local-directory-expression")]),e._v(" attribute is now supported, enabling the naming of local directories during retrieval (based on the remote directory).")]),e._v(" "),n("h6",{attrs:{id:"remote-file-template"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#remote-file-template"}},[e._v("#")]),e._v(" Remote File Template")]),e._v(" "),n("p",[e._v("A new higher-level abstraction ("),n("code",[e._v("RemoteFileTemplate")]),e._v(") is provided over the "),n("code",[e._v("Session")]),e._v(" implementations used by the FTP and SFTP modules.\nWhile it is used internally by endpoints, you can also use this abstraction programmatically.\nLike all Spring "),n("code",[e._v("*Template")]),e._v(" implementations, it reliably closes the underlying session while allowing low level access to the session.")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Adapters")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"requires-reply-attribute-for-outbound-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#requires-reply-attribute-for-outbound-gateways"}},[e._v("#")]),e._v(" 'requires-reply' Attribute for Outbound Gateways")]),e._v(" "),n("p",[e._v("All outbound gateways (such as "),n("code",[e._v("<jdbc:outbound-gateway/>")]),e._v(" or "),n("code",[e._v("<jms:outbound-gateway/>")]),e._v(") are designed for 'request-reply' scenarios.\nA response is expected from the external service and is published to the "),n("code",[e._v("reply-channel")]),e._v(" or the "),n("code",[e._v("replyChannel")]),e._v(" message header.\nHowever, there are some cases where the external system might not always return a result (for example,\na "),n("code",[e._v("<jdbc:outbound-gateway/>")]),e._v(" when a SELECT ends with an empty "),n("code",[e._v("ResultSet")]),e._v(" or perhaps a one-way web service).\nConsequently, developers needed an option to configure whether or not a reply is required.\nFor this purpose, we introduced the "),n("code",[e._v("requires-reply")]),e._v(" attribute for outbound gateway components.\nIn most cases, the default value for "),n("code",[e._v("requires-reply")]),e._v(" is "),n("code",[e._v("true")]),e._v(".\nIf there is no result, a "),n("code",[e._v("ReplyRequiredException")]),e._v(" is thrown.\nChanging the value to "),n("code",[e._v("false")]),e._v(" means that, if an external service does not return anything, the message flow ends at that point, similar to an outbound channel adapter.")]),e._v(" "),n("table",[n("thead",[n("tr",[n("th"),e._v(" "),n("th",[e._v("The WebService outbound gateway has an additional attribute called "),n("code",[e._v("ignore-empty-responses")]),e._v("."),n("br"),e._v("It is used to treat an empty "),n("code",[e._v("String")]),e._v(" response as if no response were received."),n("br"),e._v("By default, it is "),n("code",[e._v("true")]),e._v(", but you can set it to "),n("code",[e._v("false")]),e._v(" to allow the application to receive an empty "),n("code",[e._v("String")]),e._v(" in the reply message payload."),n("br"),e._v("When the attribute is "),n("code",[e._v("true")]),e._v(", an empty string is treated as no response for the purposes of the "),n("code",[e._v("requires-reply")]),e._v(" attribute."),n("br"),e._v("By default, "),n("code",[e._v("requires-reply")]),e._v(" is false for the WebService outbound gateway.")])])]),e._v(" "),n("tbody")]),e._v(" "),n("p",[e._v("Note that the "),n("code",[e._v("requiresReply")]),e._v(" property was previously present but set to "),n("code",[e._v("false")]),e._v(" in the "),n("code",[e._v("AbstractReplyProducingMessageHandler")]),e._v(", and there was no way to configure it on outbound gateways by using the XML namespace.")]),e._v(" "),n("table",[n("thead",[n("tr",[n("th"),e._v(" "),n("th",[e._v("Previously, a gateway receiving no reply would silently end the flow (with a DEBUG log message)."),n("br"),e._v("By default, with this change, an exception is now thrown by most gateways."),n("br"),e._v("To revert to the previous behavior, set "),n("code",[e._v("requires-reply")]),e._v(" to "),n("code",[e._v("false")]),e._v(".")])])]),e._v(" "),n("tbody")]),e._v(" "),n("h5",{attrs:{id:"amqp-outbound-gateway-header-mapping"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-outbound-gateway-header-mapping"}},[e._v("#")]),e._v(" AMQP Outbound Gateway Header Mapping")]),e._v(" "),n("p",[e._v("Previously, the <int-amqp:outbound-gateway/> mapped headers before invoking the message converter, and the converter could overwrite headers such as "),n("code",[e._v("content-type")]),e._v(".\nThe outbound adapter maps the headers after the conversion, which means headers like "),n("code",[e._v("content-type")]),e._v(" from the outbound "),n("code",[e._v("Message")]),e._v(" (if present) are used.")]),e._v(" "),n("p",[e._v("Starting with this release, the gateway now maps the headers after the message conversion, consistent with the adapter.\nIf your application relies on the previous behavior (where the converter’s headers overrode the mapped headers), you either need to filter those headers (before the message reaches the gateway) or set them appropriately.\nThe headers affected by the "),n("code",[e._v("SimpleMessageConverter")]),e._v(" are "),n("code",[e._v("content-type")]),e._v(" and "),n("code",[e._v("content-encoding")]),e._v(".\nCustom message converters may set other headers.")]),e._v(" "),n("h5",{attrs:{id:"stored-procedure-components-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stored-procedure-components-improvements"}},[e._v("#")]),e._v(" Stored Procedure Components Improvements")]),e._v(" "),n("p",[e._v("For more complex database-specific types not supported by the standard "),n("code",[e._v("CallableStatement.getObject")]),e._v(" method, we introduced two new additional attributes to the "),n("code",[e._v("<sql-parameter-definition/>")]),e._v(" element with OUT-direction:")]),e._v(" "),n("ul",[n("li",[n("p",[n("code",[e._v("type-name")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("return-type")])])])]),e._v(" "),n("p",[e._v("The "),n("code",[e._v("row-mapper")]),e._v(" attribute of the stored procedure inbound channel adapter "),n("code",[e._v("<returning-resultset/>")]),e._v(" child element now supports a reference to a "),n("code",[e._v("RowMapper")]),e._v(" bean definition.\nPreviously, it contained only a class name (which is still supported).")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#stored-procedures"}},[e._v("Stored Procedures")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"web-service-outbound-uri-configuration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#web-service-outbound-uri-configuration"}},[e._v("#")]),e._v(" Web Service Outbound URI Configuration")]),e._v(" "),n("p",[e._v("The web service outbound gateway 'uri' attribute now supports "),n("code",[e._v("<uri-variable/>")]),e._v(" substitution for all URI schemes supported by Spring Web Services.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ws.html#outbound-uri"}},[e._v("Outbound URI Configuration")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redis-adapter-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-adapter-changes"}},[e._v("#")]),e._v(" Redis Adapter Changes")]),e._v(" "),n("p",[e._v("The Redis inbound channel adapter can now use a "),n("code",[e._v("null")]),e._v(" value for the "),n("code",[e._v("serializer")]),e._v(" property, with the raw data being the message payload.")]),e._v(" "),n("p",[e._v("The Redis outbound channel adapter now has the "),n("code",[e._v("topic-expression")]),e._v(" property to determine the Redis topic for the "),n("code",[e._v("Message")]),e._v(" at runtime.")]),e._v(" "),n("p",[e._v("The Redis inbound channel adapter, in addition to the existing "),n("code",[e._v("topics")]),e._v(" attribute, now has the "),n("code",[e._v("topic-patterns")]),e._v(" attribute.")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis"}},[e._v("Redis Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"advising-filters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#advising-filters"}},[e._v("#")]),e._v(" Advising Filters")]),e._v(" "),n("p",[e._v("Previously, when a "),n("code",[e._v("<filter/>")]),e._v(" had a "),n("code",[e._v("<request-handler-advice-chain/>")]),e._v(", the discard action was all performed within the scope of the advice chain (including any downstream flow on the "),n("code",[e._v("discard-channel")]),e._v(").\nThe filter element now has an attribute called "),n("code",[e._v("discard-within-advice")]),e._v(" (default: "),n("code",[e._v("true")]),e._v(") to allow the discard action to be performed after the advice chain completes.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#advising-filters"}},[e._v("Advising Filters")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"advising-endpoints-using-annotations"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#advising-endpoints-using-annotations"}},[e._v("#")]),e._v(" Advising Endpoints using Annotations")]),e._v(" "),n("p",[e._v("Request handler advice chains can now be configured using annotations.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#advising-with-annotations"}},[e._v("Advising Endpoints Using Annotations")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"objecttostringtransformer-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#objecttostringtransformer-improvements"}},[e._v("#")]),e._v(" ObjectToStringTransformer Improvements")]),e._v(" "),n("p",[e._v("This transformer now correctly transforms "),n("code",[e._v("byte[]")]),e._v(" and "),n("code",[e._v("char[]")]),e._v(" payloads to "),n("code",[e._v("String")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jpa-support-changes"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jpa-support-changes"}},[e._v("#")]),e._v(" JPA Support Changes")]),e._v(" "),n("p",[e._v("Payloads to persist or merge can now be of type "),n("code",[e._v("[java.lang.Iterable](https://docs.oracle.com/javase/7/docs/api/java/lang/Iterable.html)")]),e._v(".")]),e._v(" "),n("p",[e._v("In that case, each object returned by the "),n("code",[e._v("Iterable")]),e._v(" is treated as an entity and persisted or merged by using the underlying "),n("code",[e._v("EntityManager")]),e._v(".\nNull values returned by the iterator are ignored.")]),e._v(" "),n("p",[e._v("The JPA adapters now have additional attributes to optionally flush and clear entities from the associated persistence context after performing persistence operations.")]),e._v(" "),n("p",[e._v("Retrieving gateways had no mechanism to specify the first record to be retrieved, which is a common use case.\nThe retrieving gateways now support specifying this parameter by adding the "),n("code",[e._v("first-result")]),e._v(" and "),n("code",[e._v("first-result-expression")]),e._v(" attributes to the gateway definition.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-retrieving-outbound-gateway"}},[e._v("Retrieving Outbound Gateway")]),e._v(".")],1),e._v(" "),n("p",[e._v("The JPA retrieving gateway and inbound adapter now have an attribute to specify the maximum number of results in a result set as an expression.\nIn addition, we introduced the "),n("code",[e._v("max-results")]),e._v(" attribute to replace "),n("code",[e._v("max-number-of-results")]),e._v(", which has been deprecated."),n("code",[e._v("max-results")]),e._v(" and "),n("code",[e._v("max-results-expression")]),e._v(" are used to provide the maximum number of results or an expression to compute the maximum number of results, respectively, in the result set.")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa"}},[e._v("JPA Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"delayer-delay-expression"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#delayer-delay-expression"}},[e._v("#")]),e._v(" Delayer: delay expression")]),e._v(" "),n("p",[e._v("Previously, the "),n("code",[e._v("<delayer>")]),e._v(" provided a "),n("code",[e._v("delay-header-name")]),e._v(" attribute to determine the delay value at runtime.\nIn complex cases, the "),n("code",[e._v("<delayer>")]),e._v(" had to be preceded with a "),n("code",[e._v("<header-enricher>")]),e._v(".\nSpring Integration 3.0 introduced the "),n("code",[e._v("expression")]),e._v(" attribute and "),n("code",[e._v("expression")]),e._v(" child element for dynamic delay determination.\nThe "),n("code",[e._v("delay-header-name")]),e._v(" attribute is now deprecated, because you can specify the header evaluation in the "),n("code",[e._v("expression")]),e._v(".\nIn addition, we introduced the "),n("code",[e._v("ignore-expression-failures")]),e._v(" to control the behavior when an expression evaluation fails.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/delayer.html#delayer"}},[e._v("Delayer")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jdbc-message-store-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-message-store-improvements"}},[e._v("#")]),e._v(" JDBC Message Store Improvements")]),e._v(" "),n("p",[e._v("Spring Integration 3.0 adds a new set of DDL scripts for MySQL version 5.6.4 and higher.\nNow MySQL supports fractional seconds and is thus improving the FIFO ordering when polling from a MySQL-based message store.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-message-store-generic"}},[e._v("The Generic JDBC Message Store")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"imap-idle-connection-exceptions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#imap-idle-connection-exceptions"}},[e._v("#")]),e._v(" IMAP Idle Connection Exceptions")]),e._v(" "),n("p",[e._v("Previously, if an IMAP idle connection failed, it was logged, but there was no mechanism to inform an application.\nSuch exceptions now generate "),n("code",[e._v("ApplicationEvent")]),e._v(" instances.\nApplications can obtain these events by using an "),n("code",[e._v("<int-event:inbound-channel-adapter>")]),e._v(" or any "),n("code",[e._v("ApplicationListener")]),e._v(" configured to receive an "),n("code",[e._v("ImapIdleExceptionEvent")]),e._v(" (or one of its super classes).")]),e._v(" "),n("h5",{attrs:{id:"message-headers-and-tcp"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-headers-and-tcp"}},[e._v("#")]),e._v(" Message Headers and TCP")]),e._v(" "),n("p",[e._v("The TCP connection factories now enable the configuration of a flexible mechanism to transfer selected headers (as well as the payload) over TCP.\nA new "),n("code",[e._v("TcpMessageMapper")]),e._v(" enables the selection of the headers, and you need to configure an appropriate serializer or deserializer to write the resulting "),n("code",[e._v("Map")]),e._v(" to the TCP stream.\nWe added a "),n("code",[e._v("MapJsonSerializer")]),e._v(" as a convenient mechanism to transfer headers and payload over TCP.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip-headers"}},[e._v("Transferring Headers")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jms-message-driven-channel-adapter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-message-driven-channel-adapter"}},[e._v("#")]),e._v(" JMS Message Driven Channel Adapter")]),e._v(" "),n("p",[e._v("Previously, when configuring a "),n("code",[e._v("<message-driven-channel-adapter/>")]),e._v(", if you wished to use a specific "),n("code",[e._v("TaskExecutor")]),e._v(", you had to declare a container bean and provide it to the adapter by setting the "),n("code",[e._v("container")]),e._v(" attribute.\nWe added the "),n("code",[e._v("task-executor")]),e._v(", letting it be set directly on the adapter.\nThis is in addition to several other container attributes that were already available.")]),e._v(" "),n("h5",{attrs:{id:"rmi-inbound-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#rmi-inbound-gateway"}},[e._v("#")]),e._v(" RMI Inbound Gateway")]),e._v(" "),n("p",[e._v("The RMI Inbound Gateway now supports an "),n("code",[e._v("error-channel")]),e._v(" attribute.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/rmi.html#rmi-inbound"}},[e._v("Inbound RMI")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"xsltpayloadtransformer"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xsltpayloadtransformer"}},[e._v("#")]),e._v(" "),n("code",[e._v("XsltPayloadTransformer")])]),e._v(" "),n("p",[e._v("You can now specify the transformer factory class name by setting the "),n("code",[e._v("transformer-factory-class")]),e._v(" attribute.\nSee "),n("code",[e._v("[XsltPayloadTransformer](./xml.html#xml-xslt-payload-transformers)")]),e._v(".")]),e._v(" "),n("h3",{attrs:{id:"changes-between-2-1-and-2-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-2-1-and-2-2"}},[e._v("#")]),e._v(" Changes between 2.1 and 2.2")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-2.1-to-2.2-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.\nYou can find migration guides for all versions back to 2.1 on the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki",target:"_blank",rel:"noopener noreferrer"}},[e._v("wiki"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-components-11"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-11"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 2.2 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"redisstore-inbound-and-outbound-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redisstore-inbound-and-outbound-channel-adapters"}},[e._v("#")]),e._v(" "),n("code",[e._v("RedisStore")]),e._v(" Inbound and Outbound Channel Adapters")]),e._v(" "),n("p",[e._v("Spring Integration now has "),n("code",[e._v("RedisStore")]),e._v(" Inbound and Outbound Channel Adapters, letting you write and read "),n("code",[e._v("Message")]),e._v(" payloads to and from Redis collections.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-store-outbound-channel-adapter"}},[e._v("RedisStore Outbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis-store-inbound-channel-adapter"}},[e._v("Redis Store Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"mongodb-inbound-and-outbound-channel-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-inbound-and-outbound-channel-adapters"}},[e._v("#")]),e._v(" MongoDB Inbound and Outbound Channel Adapters")]),e._v(" "),n("p",[e._v("Spring Integration now has MongoDB inbound and outbound channel adapters, letting you write and read "),n("code",[e._v("Message")]),e._v(" payloads to and from a MongoDB document store.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb-outbound-channel-adapter"}},[e._v("MongoDB Outbound Channel Adapter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb-inbound-channel-adapter"}},[e._v("MongoDB Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"jpa-endpoints"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jpa-endpoints"}},[e._v("#")]),e._v(" JPA Endpoints")]),e._v(" "),n("p",[e._v("Spring Integration now includes components for the Java Persistence API (JPA) for retrieving and persisting JPA entity objects.\nThe JPA Adapter includes the following components:")]),e._v(" "),n("ul",[n("li",[n("p",[n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-inbound-channel-adapter"}},[e._v("Inbound channel adapter")])],1)]),e._v(" "),n("li",[n("p",[n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-outbound-channel-adapter"}},[e._v("Outbound channel adapter")])],1)]),e._v(" "),n("li",[n("p",[n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-updating-outbound-gateway"}},[e._v("Updating outbound gateway")])],1)]),e._v(" "),n("li",[n("p",[n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa-retrieving-outbound-gateway"}},[e._v("Retrieving outbound gateway")])],1)])]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jpa.html#jpa"}},[e._v("JPA Support")]),e._v(".")],1),e._v(" "),n("h4",{attrs:{id:"general-changes-11"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#general-changes-11"}},[e._v("#")]),e._v(" General Changes")]),e._v(" "),n("p",[e._v("This section describes general changes from version 2.1 to version 2.2.")]),e._v(" "),n("h5",{attrs:{id:"spring-3-1-used-by-default"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spring-3-1-used-by-default"}},[e._v("#")]),e._v(" Spring 3.1 Used by Default")]),e._v(" "),n("p",[e._v("Spring Integration now uses Spring 3.1.")]),e._v(" "),n("h5",{attrs:{id:"adding-behavior-to-endpoints"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#adding-behavior-to-endpoints"}},[e._v("#")]),e._v(" Adding Behavior to Endpoints")]),e._v(" "),n("p",[e._v("The ability to add an "),n("code",[e._v("<advice-chain/>")]),e._v(" to a poller has been available for some time.\nHowever, the behavior added by this affects the entire integration flow.\nIt did not address the ability to add (for example) retry to an individual endpoint.\nThe 2.2 release introduced the "),n("code",[e._v("<request-handler-advice-chain/>")]),e._v(" to many endpoints.")]),e._v(" "),n("p",[e._v("In addition, we added three standard advice classes for this purpose:")]),e._v(" "),n("ul",[n("li",[n("p",[n("code",[e._v("MessageHandlerRetryAdvice")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("MessageHandlerCircuitBreakerAdvice")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("ExpressionEvaluatingMessageHandlerAdvice")])])])]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/handler-advice.html#message-handler-advice-chain"}},[e._v("Adding Behavior to Endpoints")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"transaction-synchronization-and-pseudo-transactions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#transaction-synchronization-and-pseudo-transactions"}},[e._v("#")]),e._v(" Transaction Synchronization and Pseudo Transactions")]),e._v(" "),n("p",[e._v("Pollers can now participate in Spring’s Transaction Synchronization feature.\nThis allows for synchronizing such operations as renaming files by an inbound channel adapter, depending on whether the transaction commits or rolls back.")]),e._v(" "),n("p",[e._v("In addition, you can enable these features when no “real” transaction is present, by means of a "),n("code",[e._v("PseudoTransactionManager")]),e._v(".")]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/transactions.html#transaction-synchronization"}},[e._v("Transaction Synchronization")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"file-adapter-improved-file-overwrite-and-append-handling"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#file-adapter-improved-file-overwrite-and-append-handling"}},[e._v("#")]),e._v(" File Adapter: Improved File Overwrite and Append Handling")]),e._v(" "),n("p",[e._v("When using the file outbound channel adapter or the file outbound gateway, you can use a new "),n("code",[e._v("mode")]),e._v(" property.\nPrior to Spring Integration 2.2, target files were replaced when they existed.\nNow you can specify the following options:")]),e._v(" "),n("ul",[n("li",[n("p",[n("code",[e._v("REPLACE")]),e._v(" (default)")])]),e._v(" "),n("li",[n("p",[n("code",[e._v("APPEND")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("FAIL")])])]),e._v(" "),n("li",[n("p",[n("code",[e._v("IGNORE")])])])]),e._v(" "),n("p",[e._v("For more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/file.html#file-writing-destination-exists"}},[e._v("Dealing with Existing Destination Files")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"reply-timeout-added-to-more-outbound-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#reply-timeout-added-to-more-outbound-gateways"}},[e._v("#")]),e._v(" Reply-Timeout Added to More Outbound Gateways")]),e._v(" "),n("p",[e._v("The XML Namespace support adds the reply-timeout attribute to the following outbound gateways:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("AMQP Outbound Gateway")])]),e._v(" "),n("li",[n("p",[e._v("File Outbound Gateway")])]),e._v(" "),n("li",[n("p",[e._v("FTP Outbound Gateway")])]),e._v(" "),n("li",[n("p",[e._v("SFTP Outbound Gateway")])]),e._v(" "),n("li",[n("p",[e._v("WS Outbound Gateway")])])]),e._v(" "),n("h5",{attrs:{id:"spring-amqp-1-1"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spring-amqp-1-1"}},[e._v("#")]),e._v(" Spring-AMQP 1.1")]),e._v(" "),n("p",[e._v("Spring Integration now uses Spring AMQP 1.1.\nThis enables several features to be used within a Spring Integration application, including the following:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("A fixed reply queue for the outbound gateway")])]),e._v(" "),n("li",[n("p",[e._v("HA (mirrored) queues")])]),e._v(" "),n("li",[n("p",[e._v("Publisher confirmations")])]),e._v(" "),n("li",[n("p",[e._v("Returned messages")])]),e._v(" "),n("li",[n("p",[e._v("Support for dead letter exchanges and dead letter queues")])])]),e._v(" "),n("h5",{attrs:{id:"jdbc-support-stored-procedures-components"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-support-stored-procedures-components"}},[e._v("#")]),e._v(" JDBC Support - Stored Procedures Components")]),e._v(" "),n("h6",{attrs:{id:"spel-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spel-support"}},[e._v("#")]),e._v(" SpEL Support")]),e._v(" "),n("p",[e._v("When using the stored procedure components of the Spring Integration JDBC Adapter, you can now provide stored procedure names or stored function names by using the Spring Expression Language (SpEL).")]),e._v(" "),n("p",[e._v("Doing so lets you specify the stored procedures to be invoked at runtime.\nFor example, you can provide stored procedure names that you would like to execute through message headers.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#stored-procedures"}},[e._v("Stored Procedures")]),e._v(".")],1),e._v(" "),n("h6",{attrs:{id:"jmx-support-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jmx-support-2"}},[e._v("#")]),e._v(" JMX Support")]),e._v(" "),n("p",[e._v("The stored procedure components now provide basic JMX support, exposing some of their properties as MBeans:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("Stored procedure name")])]),e._v(" "),n("li",[n("p",[e._v("Stored procedure name expression")])]),e._v(" "),n("li",[n("p",[n("code",[e._v("JdbcCallOperations")]),e._v(" cache statistics")])])]),e._v(" "),n("h5",{attrs:{id:"jdbc-support-outbound-gateway"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-support-outbound-gateway"}},[e._v("#")]),e._v(" JDBC Support: Outbound Gateway")]),e._v(" "),n("p",[e._v("When you use the JDBC outbound gateway, the update query is no longer mandatory.\nYou can now provide only a select query by using the request message as a source of parameters.")]),e._v(" "),n("h5",{attrs:{id:"jdbc-support-channel-specific-message-store-implementation"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jdbc-support-channel-specific-message-store-implementation"}},[e._v("#")]),e._v(" JDBC Support: Channel-specific Message Store Implementation")]),e._v(" "),n("p",[e._v("We added a new message channel-specific message store implementation, providing a more scalable solution using database-specific SQL queries.\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc-message-store-channels"}},[e._v("Backing Message Channels")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"orderly-shutdown-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#orderly-shutdown-2"}},[e._v("#")]),e._v(" Orderly Shutdown")]),e._v(" "),n("p",[e._v("We added a method called "),n("code",[e._v("stopActiveComponents()")]),e._v(" to the "),n("code",[e._v("IntegrationMBeanExporter")]),e._v(".\nIt allows a Spring Integration application to be shut down in an orderly manner, disallowing new inbound messages to certain adapters and waiting for some time to allow in-flight messages to complete.")]),e._v(" "),n("h5",{attrs:{id:"jms-outbound-gateway-improvements"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jms-outbound-gateway-improvements"}},[e._v("#")]),e._v(" JMS Outbound Gateway Improvements")]),e._v(" "),n("p",[e._v("You can now configure the JMS outbound gateway to use a "),n("code",[e._v("MessageListener")]),e._v(" container to receive replies.\nDoing so can improve performance of the gateway.")]),e._v(" "),n("h5",{attrs:{id:"objecttojsontransformer-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#objecttojsontransformer-2"}},[e._v("#")]),e._v(" "),n("code",[e._v("ObjectToJsonTransformer")])]),e._v(" "),n("p",[e._v("By default, the "),n("code",[e._v("ObjectToJsonTransformer")]),e._v(" now sets the "),n("code",[e._v("content-type")]),e._v(" header to "),n("code",[e._v("application/json")]),e._v(".\nFor more information, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"http-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#http-support"}},[e._v("#")]),e._v(" HTTP Support")]),e._v(" "),n("p",[e._v("Java serialization over HTTP is no longer enabled by default.\nPreviously, when setting an "),n("code",[e._v("expected-response-type")]),e._v(" on a "),n("code",[e._v("Serializable")]),e._v(" object, the "),n("code",[e._v("Accept")]),e._v(" header was not properly set up.\nWe updated the "),n("code",[e._v("SerializingHttpMessageConverter")]),e._v(" to set the "),n("code",[e._v("Accept")]),e._v(" header to "),n("code",[e._v("application/x-java-serialized-object")]),e._v(".\nHowever, because this could cause incompatibility with existing applications, we decided to no longer automatically add this converter to the HTTP endpoints.")]),e._v(" "),n("p",[e._v("If you wish to use Java serialization, you need to add the "),n("code",[e._v("SerializingHttpMessageConverter")]),e._v(" to the appropriate endpoints by using the "),n("code",[e._v("message-converters")]),e._v(" attribute (when you use XML configuration) or by using the "),n("code",[e._v("setMessageConverters()")]),e._v(" method (in Java).")]),e._v(" "),n("p",[e._v("Alternatively, you may wish to consider using JSON instead.\nIt is enabled by having "),n("code",[e._v("Jackson")]),e._v(" on the classpath.")]),e._v(" "),n("h3",{attrs:{id:"changes-between-2-0-and-2-1"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-2-0-and-2-1"}},[e._v("#")]),e._v(" Changes between 2.0 and 2.1")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-2.0-to-2.1-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.")]),e._v(" "),n("h4",{attrs:{id:"new-components-12"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-components-12"}},[e._v("#")]),e._v(" New Components")]),e._v(" "),n("p",[e._v("Version 2.1 added a number of new components.")]),e._v(" "),n("h5",{attrs:{id:"jsr-223-scripting-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#jsr-223-scripting-support"}},[e._v("#")]),e._v(" JSR-223 Scripting Support")]),e._v(" "),n("p",[e._v("In Spring Integration 2.0, we added support for "),n("a",{attrs:{href:"https://groovy.codehaus.org/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Groovy"),n("OutboundLink")],1),e._v(".\nWith Spring Integration 2.1, we expanded support for additional languages substantially by implementing support for "),n("a",{attrs:{href:"https://www.jcp.org/en/jsr/detail?id=223",target:"_blank",rel:"noopener noreferrer"}},[e._v("JSR-223"),n("OutboundLink")],1),e._v(" (“Scripting for the Java™ Platform”).\nNow you have the ability to use any scripting language that supports JSR-223 including:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("Javascript")])]),e._v(" "),n("li",[n("p",[e._v("Ruby and JRuby")])]),e._v(" "),n("li",[n("p",[e._v("Python and Jython")])]),e._v(" "),n("li",[n("p",[e._v("Groovy")])])]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/scripting.html#scripting"}},[e._v("Scripting Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"gemfire-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#gemfire-support"}},[e._v("#")]),e._v(" GemFire Support")]),e._v(" "),n("p",[e._v("Spring Integration provides support for "),n("a",{attrs:{href:"https://www.vmware.com/products/pivotal-gemfire.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("GemFire"),n("OutboundLink")],1),e._v(" by providing inbound adapters for entry and continuous query events, an outbound adapter to write entries to the cache, and "),n("a",{attrs:{href:"https://docs.spring.io/spring-integration/api/org/springframework/integration/store/MessageStore.html",target:"_blank",rel:"noopener noreferrer"}},[n("code",[e._v("MessageStore")]),n("OutboundLink")],1),e._v(" and "),n("a",{attrs:{href:"https://docs.spring.io/spring-integration/api/org/springframework/integration/store/MessageGroupStore.html",target:"_blank",rel:"noopener noreferrer"}},[n("code",[e._v("MessageGroupStore")]),n("OutboundLink")],1),e._v(" implementations.\nSpring integration leverages the "),n("a",{attrs:{href:"https://spring.io/projects/spring-data-gemfire",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Gemfire"),n("OutboundLink")],1),e._v(" project, providing a thin wrapper over its components.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/gemfire.html#gemfire"}},[e._v("Pivotal GemFire and Apache Geode Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"amqp-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#amqp-support"}},[e._v("#")]),e._v(" AMQP Support")]),e._v(" "),n("p",[e._v("Spring Integration 2.1 added several channel adapters for receiving and sending messages by using the "),n("a",{attrs:{href:"https://www.amqp.org/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Advanced Message Queuing Protocol"),n("OutboundLink")],1),e._v(" (AMQP).\nFurthermore, Spring Integration also provides a point-to-point message channel and a publish-subscribe message channel, both of which are backed by AMQP Exchanges and Queues.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/amqp.html#amqp"}},[e._v("AMQP Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"mongodb-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#mongodb-support"}},[e._v("#")]),e._v(" MongoDB Support")]),e._v(" "),n("p",[e._v("As of version 2.1, Spring Integration provides support for "),n("a",{attrs:{href:"https://www.mongodb.org/",target:"_blank",rel:"noopener noreferrer"}},[e._v("MongoDB"),n("OutboundLink")],1),e._v(" by providing a MongoDB-based "),n("code",[e._v("MessageStore")]),e._v(".")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/mongodb.html#mongodb"}},[e._v("MongoDb Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"redis-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#redis-support"}},[e._v("#")]),e._v(" Redis Support")]),e._v(" "),n("p",[e._v("As of version 2.1, Spring Integration supports "),n("a",{attrs:{href:"https://redis.io/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Redis"),n("OutboundLink")],1),e._v(", an advanced key-value store, by providing a Redis-based "),n("code",[e._v("MessageStore")]),e._v(" as well as publish-subscribe messaging adapters.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/redis.html#redis"}},[e._v("Redis Support")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"support-for-spring-s-resource-abstraction"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#support-for-spring-s-resource-abstraction"}},[e._v("#")]),e._v(" Support for Spring’s Resource abstraction")]),e._v(" "),n("p",[e._v("In version 2.1, we introduced a new resource inbound channel adapter that builds upon Spring’s resource abstraction to support greater flexibility across a variety of actual types of underlying resources, such as a file, a URL, or a classpath resource.\nTherefore, it is similar to but more generic than the file inbound channel adapter.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/resource.html#resource-inbound-channel-adapter"}},[e._v("Resource Inbound Channel Adapter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"stored-procedure-components"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#stored-procedure-components"}},[e._v("#")]),e._v(" Stored Procedure Components")]),e._v(" "),n("p",[e._v("With Spring Integration 2.1, the "),n("code",[e._v("JDBC")]),e._v(" Module also provides stored procedure support by adding several new components, including inbound and outbound channel adapters and an outbound gateway.\nThe stored procedure support leverages Spring’s "),n("a",{attrs:{href:"https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/jdbc/core/simple/SimpleJdbcCall.html",target:"_blank",rel:"noopener noreferrer"}},[n("code",[e._v("SimpleJdbcCall")]),n("OutboundLink")],1),e._v(" class and consequently supports stored procedures for:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("Apache Derby")])]),e._v(" "),n("li",[n("p",[e._v("DB2")])]),e._v(" "),n("li",[n("p",[e._v("MySQL")])]),e._v(" "),n("li",[n("p",[e._v("Microsoft SQL Server")])]),e._v(" "),n("li",[n("p",[e._v("Oracle")])]),e._v(" "),n("li",[n("p",[e._v("PostgreSQL")])]),e._v(" "),n("li",[n("p",[e._v("Sybase")])])]),e._v(" "),n("p",[e._v("The stored procedure components also support SQL functions for the following databases:")]),e._v(" "),n("ul",[n("li",[n("p",[e._v("MySQL")])]),e._v(" "),n("li",[n("p",[e._v("Microsoft SQL Server")])]),e._v(" "),n("li",[n("p",[e._v("Oracle")])]),e._v(" "),n("li",[n("p",[e._v("PostgreSQL")])])]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#stored-procedures"}},[e._v("Stored Procedures")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"xpath-and-xml-validating-filter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xpath-and-xml-validating-filter"}},[e._v("#")]),e._v(" XPath and XML Validating Filter")]),e._v(" "),n("p",[e._v("Spring Integration 2.1 provides a new XPath-based message filter.\nIt is part of the "),n("code",[e._v("XML")]),e._v(" module.\nThe XPath filter lets you filter messages by using XPath Expressions.\nWe also added documentation for the XML validating filter.")]),e._v(" "),n("p",[e._v("For more details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/xml.html#xml-xpath-filter"}},[e._v("Using the XPath Filter")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/xml.html#xml-validating-filter"}},[e._v("XML Validating Filter")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"payload-enricher"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#payload-enricher"}},[e._v("#")]),e._v(" Payload Enricher")]),e._v(" "),n("p",[e._v("Since Spring Integration 2.1, we added the payload enricher.\nA payload enricher defines an endpoint that typically passes a "),n("a",{attrs:{href:"https://docs.spring.io/spring-integration/api/org/springframework/integration/Message.html",target:"_blank",rel:"noopener noreferrer"}},[n("code",[e._v("Message")]),n("OutboundLink")],1),e._v(" to the exposed request channel and then expects a reply message.\nThe reply message then becomes the root object for evaluation of expressions to enrich the target payload.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/content-enrichment.html#payload-enricher"}},[e._v("Payload Enricher")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-sftp-outbound-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-sftp-outbound-gateways"}},[e._v("#")]),e._v(" FTP and SFTP Outbound Gateways")]),e._v(" "),n("p",[e._v("Spring Integration 2.1 provides two new outbound gateways to interact with remote File Transfer Protocol (FTP) or Secure File Transfer Protocol (SFT) servers.\nThese two gateways let you directly execute a limited set of remote commands.")]),e._v(" "),n("p",[e._v("For instance, you can use these outbound gateways to list, retrieve, and delete remote files and have the Spring Integration message flow continue with the remote server’s response.")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-outbound-gateway"}},[e._v("FTP Outbound Gateway")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-outbound-gateway"}},[e._v("SFTP Outbound Gateway")]),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"ftp-session-caching"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-session-caching"}},[e._v("#")]),e._v(" FTP Session Caching")]),e._v(" "),n("p",[e._v("As of version 2.1, we have exposed more flexibility with regards to session management for remote file adapters (for example, FTP, SFTP, and others).")]),e._v(" "),n("p",[e._v("Specifically, we deprecated the "),n("code",[e._v("cache-sessions")]),e._v(" attribute (which is available via the XML namespace support).\nAs an alternative, we added the "),n("code",[e._v("sessionCacheSize")]),e._v(" and "),n("code",[e._v("sessionWaitTimeout")]),e._v(" attributes on the "),n("code",[e._v("CachingSessionFactory")]),e._v(".")]),e._v(" "),n("p",[e._v("For further details, see "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp-session-caching"}},[e._v("FTP Session Caching")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp-session-caching"}},[e._v("SFTP Session Caching")]),e._v(".")],1),e._v(" "),n("h4",{attrs:{id:"framework-refactoring"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#framework-refactoring"}},[e._v("#")]),e._v(" Framework Refactoring")]),e._v(" "),n("p",[e._v("We refactored the Spring Integration framework in a number of ways, all described in this section.")]),e._v(" "),n("h5",{attrs:{id:"standardizing-router-configuration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#standardizing-router-configuration"}},[e._v("#")]),e._v(" Standardizing Router Configuration")]),e._v(" "),n("p",[e._v("We standardized router parameters across all router implementations with Spring Integration 2.1 to provide a more consistent user experience.")]),e._v(" "),n("p",[e._v("In Spring Integration 2.1, we removed the "),n("code",[e._v("ignore-channel-name-resolution-failures")]),e._v(" attribute in favor of consolidating its behavior with the "),n("code",[e._v("resolution-required")]),e._v(" attribute.\nAlso, the "),n("code",[e._v("resolution-required")]),e._v(" attribute now defaults to "),n("code",[e._v("true")]),e._v(".")]),e._v(" "),n("p",[e._v("Starting with Spring Integration 2.1, routers no longer silently drop any messages if no default output channel was defined.\nThis means that, by default, routers now require at least one resolved channel (if no "),n("code",[e._v("default-output-channel")]),e._v(" was set) and, by default, throw a "),n("code",[e._v("MessageDeliveryException")]),e._v(" if no channel was determined (or an attempt to send was not successful).")]),e._v(" "),n("p",[e._v("If, however, you do want to drop messages silently, you can set "),n("code",[e._v('default-output-channel="nullChannel"')]),e._v(".")]),e._v(" "),n("table",[n("thead",[n("tr",[n("th"),e._v(" "),n("th",[e._v("With the standardization of router parameters and the consolidation of the parameters described earlier, older Spring Integration based applications may break.")])])]),e._v(" "),n("tbody")]),e._v(" "),n("p",[e._v("For further details, see "),n("code",[e._v("[Routers](./router.html#router)")]),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"xml-schemas-updated-to-2-1"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xml-schemas-updated-to-2-1"}},[e._v("#")]),e._v(" XML Schemas updated to 2.1")]),e._v(" "),n("p",[e._v("Spring Integration 2.1 ships with an updated XML Schema (version 2.1).\nIt provides many improvements, such as the Router standardizations "),n("a",{attrs:{href:"#x2.1-router-standardization"}},[e._v("discussed earlier")]),e._v(".")]),e._v(" "),n("p",[e._v("From now on, developers must always declare the latest XML schema (currently version 2.1).\nAlternatively, they can use the version-less schema.\nGenerally, the best option is to use version-less namespaces, as these automatically use the latest available version of Spring Integration.")]),e._v(" "),n("p",[e._v("The following example declares a version-less Spring Integration namespace:")]),e._v(" "),n("div",{staticClass:"language- extra-class"},[n("pre",{pre:!0,attrs:{class:"language-text"}},[n("code",[e._v('<?xml version="1.0" encoding="UTF-8"?>\n<beans xmlns="http://www.springframework.org/schema/beans"\n   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\n   xmlns:int="http://www.springframework.org/schema/integration"\n   xsi:schemaLocation="http://www.springframework.org/schema/integration\n           https://www.springframework.org/schema/integration/spring-integration.xsd\n           http://www.springframework.org/schema/beans\n           https://www.springframework.org/schema/beans/spring-beans.xsd">\n...\n</beans>\n')])])]),n("p",[e._v("The following example declares a Spring Integration namespace with an explicit version:")]),e._v(" "),n("div",{staticClass:"language- extra-class"},[n("pre",{pre:!0,attrs:{class:"language-text"}},[n("code",[e._v('<?xml version="1.0" encoding="UTF-8"?>\n<beans xmlns="http://www.springframework.org/schema/beans"\n   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\n   xmlns:int="http://www.springframework.org/schema/integration"\n   xsi:schemaLocation="http://www.springframework.org/schema/integration\n           https://www.springframework.org/schema/integration/spring-integration-2.2.xsd\n           http://www.springframework.org/schema/beans\n           https://www.springframework.org/schema/beans/spring-beans.xsd">\n...\n</beans>\n')])])]),n("p",[e._v("The old 1.0 and 2.0 schemas are still there.\nHowever, if an application context still references one of those deprecated schemas, the validator fails on initialization.")]),e._v(" "),n("h4",{attrs:{id:"source-control-management-and-build-infrastructure"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#source-control-management-and-build-infrastructure"}},[e._v("#")]),e._v(" Source Control Management and Build Infrastructure")]),e._v(" "),n("p",[e._v("Version 2.1 introduced a number of changes to source control management and build infrastructure.\nThis section covers those changes.")]),e._v(" "),n("h5",{attrs:{id:"source-code-now-hosted-on-github"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#source-code-now-hosted-on-github"}},[e._v("#")]),e._v(" Source Code Now Hosted on Github")]),e._v(" "),n("p",[e._v("Since version 2.0, the Spring Integration project uses "),n("a",{attrs:{href:"https://git-scm.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Git"),n("OutboundLink")],1),e._v(" for version control.\nTo increase community visibility even further, the project was moved from SpringSource hosted Git repositories to "),n("a",{attrs:{href:"https://www.github.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Github"),n("OutboundLink")],1),e._v(".\nThe Spring Integration Git repository is located at: "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration",target:"_blank",rel:"noopener noreferrer"}},[e._v("spring-integration"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("p",[e._v("For the project, we also improved the process of providing code contributions.\nFurther, we ensure that every commit is peer-reviewed.\nIn fact, core committers now follow the same process as contributors.\nFor more details, see "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/blob/main/CONTRIBUTING.adoc",target:"_blank",rel:"noopener noreferrer"}},[e._v("Contributing"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h5",{attrs:{id:"improved-source-code-visibility-with-sonar"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#improved-source-code-visibility-with-sonar"}},[e._v("#")]),e._v(" Improved Source Code Visibility with Sonar")]),e._v(" "),n("p",[e._v("In an effort to provide better source code visibility and consequently to monitor the quality of Spring Integration’s source code, we set up an instance of "),n("a",{attrs:{href:"https://www.sonarqube.org/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Sonar"),n("OutboundLink")],1),e._v(".\nWe gather metrics nightly and make them available at "),n("a",{attrs:{href:"https://sonar.spring.io/dashboard?id=org.springframework.integration%3Aspring-integration%3Amain",target:"_blank",rel:"noopener noreferrer"}},[e._v("sonar.spring.io"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-samples"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-samples"}},[e._v("#")]),e._v(" New Samples")]),e._v(" "),n("p",[e._v("For the 2.1 release of Spring Integration, we also expanded the Spring Integration Samples project and added many new samples, such as samples that cover AMQP support, a sample that showcases the new payload enricher, a sample illustrating techniques for testing Spring Integration flow fragments, and a sample for executing stored procedures against Oracle databases.\nFor details, visit "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-samples",target:"_blank",rel:"noopener noreferrer"}},[e._v("spring-integration-samples"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h3",{attrs:{id:"changes-between-versions-1-0-and-2-0"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#changes-between-versions-1-0-and-2-0"}},[e._v("#")]),e._v(" Changes between Versions 1.0 and 2.0")]),e._v(" "),n("p",[e._v("See the "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration/wiki/Spring-Integration-1.0-to-2.0-Migration-Guide",target:"_blank",rel:"noopener noreferrer"}},[e._v("Migration Guide"),n("OutboundLink")],1),e._v(" for important changes that might affect your applications.")]),e._v(" "),n("h4",{attrs:{id:"spring-3-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spring-3-support"}},[e._v("#")]),e._v(" Spring 3 support")]),e._v(" "),n("p",[e._v("Spring Integration 2.0 is built on top of Spring 3.0.5 and makes many of its features available to our users.")]),e._v(" "),n("p",[e._v("[[2.0-spel-support]]\n===== Support for the Spring Expression Language (SpEL)")]),e._v(" "),n("p",[e._v("You can now use SpEL expressions within the transformer, router, filter, splitter, aggregator, service-activator, header-enricher, and many more elements of the Spring Integration core namespace as well as within various adapters.\nThis guide includes many samples.")]),e._v(" "),n("h5",{attrs:{id:"conversion-service-and-converter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#conversion-service-and-converter"}},[e._v("#")]),e._v(" Conversion Service and Converter")]),e._v(" "),n("p",[e._v("You can now benefit from the conversion service support provided with Spring while configuring many Spring Integration components, such as a "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/DatatypeChannel.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("Datatype channel"),n("OutboundLink")],1),e._v(".\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel-implementations"}},[e._v("Message Channel Implementations")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/service-activator.html#service-activator"}},[e._v("Service Activator")]),e._v(".\nAlso, the SpEL support mentioned in the previous point also relies upon the conversion service.\nTherefore, you can register converters once and take advantage of them anywhere you use SpEL expressions.")],1),e._v(" "),n("h5",{attrs:{id:"taskscheduler-and-trigger"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#taskscheduler-and-trigger"}},[e._v("#")]),e._v(" "),n("code",[e._v("TaskScheduler")]),e._v(" and "),n("code",[e._v("Trigger")])]),e._v(" "),n("p",[e._v("Spring 3.0 defines two new strategies related to scheduling: "),n("code",[e._v("TaskScheduler")]),e._v(" and "),n("code",[e._v("Trigger")]),e._v(".\nSpring Integration (which uses a lot of scheduling) now builds upon these.\nIn fact, Spring Integration 1.0 had originally defined some of the components (such as "),n("code",[e._v("CronTrigger")]),e._v(") that have now been migrated into Spring 3.0’s core API.\nNow you can benefit from reusing the same components within the entire application context (not just Spring Integration configuration).\nWe also greatly simplified configuration of Spring Integration pollers by providing attributes for directly configuring rates, delays, cron expressions, and trigger references.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel-adapter.html#channel-adapter"}},[e._v("Channel Adapter")]),e._v(" for sample configurations.")],1),e._v(" "),n("h5",{attrs:{id:"resttemplate-and-httpmessageconverter"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#resttemplate-and-httpmessageconverter"}},[e._v("#")]),e._v(" "),n("code",[e._v("RestTemplate")]),e._v(" and "),n("code",[e._v("HttpMessageConverter")])]),e._v(" "),n("p",[e._v("Our outbound HTTP adapters now delegate to Spring’s "),n("code",[e._v("RestTemplate")]),e._v(" for executing the HTTP request and handling its response.\nThis also means that you can reuse any custom "),n("code",[e._v("HttpMessageConverter")]),e._v(" implementations.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-outbound"}},[e._v("HTTP Outbound Components")]),e._v(" for more details.")],1),e._v(" "),n("h4",{attrs:{id:"enterprise-integration-pattern-additions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#enterprise-integration-pattern-additions"}},[e._v("#")]),e._v(" Enterprise Integration Pattern Additions")]),e._v(" "),n("p",[e._v("Also in 2.0, we have added support for even more of the patterns described in Hohpe and Woolf’s "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Enterprise Integration Patterns"),n("OutboundLink")],1),e._v(" book.")]),e._v(" "),n("h5",{attrs:{id:"message-history"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-history"}},[e._v("#")]),e._v(" Message History")]),e._v(" "),n("p",[e._v("We now provide support for the "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/MessageHistory.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("message history"),n("OutboundLink")],1),e._v(" pattern, letting you keep track of all traversed components, including the name of each channel and endpoint as well as the timestamp of that traversal.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-history.html#message-history"}},[e._v("Message History")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"message-store"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#message-store"}},[e._v("#")]),e._v(" Message Store")]),e._v(" "),n("p",[e._v("We now provide support for the "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/MessageStore.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("message store"),n("OutboundLink")],1),e._v(" pattern.\nThe message store provides a strategy for persisting messages on behalf of any process whose scope extends beyond a single transaction, such as the aggregator and the resequencer.\nMany sections of this guide include samples of how to use a message store, as it affects several areas of Spring Integration.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/message-store.html#message-store"}},[e._v("Message Store")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/claim-check.html#claim-check"}},[e._v("Claim Check")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/channel.html#channel"}},[e._v("Message Channels")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/jdbc.html#jdbc"}},[e._v("JDBC Support")]),e._v('`", and '),n("RouterLink",{attrs:{to:"/en/spring-integration/resequencer.html#resequencer"}},[e._v("Resequencer")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"claim-check"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#claim-check"}},[e._v("#")]),e._v(" Claim Check")]),e._v(" "),n("p",[e._v("We have added an implementation of the "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/StoreInLibrary.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("claim check"),n("OutboundLink")],1),e._v(" pattern.\nThe idea behind the claim check pattern is that you can exchange a message payload for a “claim ticket”.\nThis lets you reduce bandwidth and avoid potential security issues when sending messages across channels.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/claim-check.html#claim-check"}},[e._v("Claim Check")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"control-bus"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#control-bus"}},[e._v("#")]),e._v(" Control Bus")]),e._v(" "),n("p",[e._v("We have provided implementations of the "),n("a",{attrs:{href:"https://www.enterpriseintegrationpatterns.com/ControlBus.html",target:"_blank",rel:"noopener noreferrer"}},[e._v("control bus"),n("OutboundLink")],1),e._v(" pattern, which lets you use messaging to manage and monitor endpoints and channels.\nThe implementations include both a SpEL-based approach and one that runs Groovy scripts.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/control-bus.html#control-bus"}},[e._v("Control Bus")]),e._v(" and "),n("RouterLink",{attrs:{to:"/en/spring-integration/groovy.html#groovy-control-bus"}},[e._v("Control Bus")]),e._v(" for more details.")],1),e._v(" "),n("h4",{attrs:{id:"new-channel-adapters-and-gateways"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-channel-adapters-and-gateways"}},[e._v("#")]),e._v(" New Channel Adapters and Gateways")]),e._v(" "),n("p",[e._v("We have added several new channel adapters and messaging gateways in Spring Integration 2.0.")]),e._v(" "),n("h5",{attrs:{id:"tcp-and-udp-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#tcp-and-udp-adapters"}},[e._v("#")]),e._v(" TCP and UDP Adapters")]),e._v(" "),n("p",[e._v("We have added channel adapters for receiving and sending messages over the TCP and UDP internet protocols.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ip.html#ip"}},[e._v("TCP and UDP Support")]),e._v(" for more details.\nSee also the following blog: "),n("a",{attrs:{href:"https://spring.io/blog/2010/03/29/using-udp-and-tcp-adapters-in-spring-integration-2-0-m3/",target:"_blank",rel:"noopener noreferrer"}},[e._v("“Using UDP and TCP Adapters in Spring Integration 2.0 M3”"),n("OutboundLink")],1),e._v(".")],1),e._v(" "),n("h5",{attrs:{id:"twitter-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#twitter-adapters"}},[e._v("#")]),e._v(" Twitter Adapters")]),e._v(" "),n("p",[e._v("Twitter adapters provides support for sending and receiving Twitter status updates as well as direct messages.\nYou can also perform Twitter Searches with an inbound channel adapter.\nSee "),n("a",{attrs:{href:"https://github.com/spring-projects/spring-integration-extensions/tree/main/spring-integration-social-twitter",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Integration Social Twitter"),n("OutboundLink")],1),e._v(" for more details.")]),e._v(" "),n("h5",{attrs:{id:"xmpp-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#xmpp-adapters"}},[e._v("#")]),e._v(" XMPP Adapters")]),e._v(" "),n("p",[e._v("The new XMPP adapters support both chat messages and presence events.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/xmpp.html#xmpp"}},[e._v("XMPP Support")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"ftp-and-ftps-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#ftp-and-ftps-adapters"}},[e._v("#")]),e._v(" FTP and FTPS Adapters")]),e._v(" "),n("p",[e._v("Inbound and outbound file transfer support over FTP and FTPS is now available.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/ftp.html#ftp"}},[e._v("FTP/FTPS Adapters")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"sftp-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#sftp-adapters"}},[e._v("#")]),e._v(" SFTP Adapters")]),e._v(" "),n("p",[e._v("Inbound and outbound file transfer support over SFTP is now available.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/sftp.html#sftp"}},[e._v("SFTP Adapters")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"feed-adapters"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#feed-adapters"}},[e._v("#")]),e._v(" Feed Adapters")]),e._v(" "),n("p",[e._v("We have also added channel adapters for receiving news feeds (ATOM and RSS).\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/feed.html#feed"}},[e._v("Feed Adapter")]),e._v(" for more details.")],1),e._v(" "),n("h4",{attrs:{id:"other-additions"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#other-additions"}},[e._v("#")]),e._v(" Other Additions")]),e._v(" "),n("p",[e._v("Spring Integration adds a number of other features.\nThis section describes them.")]),e._v(" "),n("h5",{attrs:{id:"groovy-support"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#groovy-support"}},[e._v("#")]),e._v(" Groovy Support")]),e._v(" "),n("p",[e._v("Spring Integration 2.0 added Groovy support, letting you use the Groovy scripting language to provide integration and business logic.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/groovy.html#groovy"}},[e._v("Groovy support")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"map-transformers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#map-transformers"}},[e._v("#")]),e._v(" Map Transformers")]),e._v(" "),n("p",[e._v("These symmetrical transformers convert payload objects to and from "),n("code",[e._v("Map")]),e._v(" objects.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"json-transformers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#json-transformers"}},[e._v("#")]),e._v(" JSON Transformers")]),e._v(" "),n("p",[e._v("These symmetrical transformers convert payload objects to and from JSON.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(" for more details.")],1),e._v(" "),n("h5",{attrs:{id:"serialization-transformers"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#serialization-transformers"}},[e._v("#")]),e._v(" Serialization Transformers")]),e._v(" "),n("p",[e._v("These symmetrical transformers convert payload objects to and from byte arrays.\nThey also support the serializer and deserializer strategy interfaces that Spring 3.0.5 added.\nSee "),n("RouterLink",{attrs:{to:"/en/spring-integration/transformer.html#transformer"}},[e._v("Transformer")]),e._v(" for more details.")],1),e._v(" "),n("h4",{attrs:{id:"framework-refactoring-2"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#framework-refactoring-2"}},[e._v("#")]),e._v(" Framework Refactoring")]),e._v(" "),n("p",[e._v("The core API went through some significant refactoring to make it simpler and more usable.\nAlthough we anticipate that the impact to developers should be minimal, you should read through this document to find what was changed.\nSpecifically, you should read "),n("RouterLink",{attrs:{to:"/en/spring-integration/router.html#dynamic-routers"}},[e._v("Dynamic Routers")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/gateway.html#gateway"}},[e._v("Messaging Gateways")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/http.html#http-outbound"}},[e._v("HTTP Outbound Components")]),e._v(", "),n("RouterLink",{attrs:{to:"/en/spring-integration/message.html#message"}},[e._v("Message")]),e._v(", and "),n("RouterLink",{attrs:{to:"/en/spring-integration/aggregator.html#aggregator"}},[e._v("Aggregator")]),e._v(".\nIf you directly depend on some of the core components ("),n("code",[e._v("Message")]),e._v(", "),n("code",[e._v("MessageHeaders")]),e._v(", "),n("code",[e._v("MessageChannel")]),e._v(", "),n("code",[e._v("MessageBuilder")]),e._v(", and others), you need to update any import statements.\nWe restructured some packaging to provide the flexibility we needed for extending the domain model while avoiding any cyclical dependencies (it is a policy of the framework to avoid such “tangles”).")],1),e._v(" "),n("h4",{attrs:{id:"new-source-control-management-and-build-infrastructure"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-source-control-management-and-build-infrastructure"}},[e._v("#")]),e._v(" New Source Control Management and Build Infrastructure")]),e._v(" "),n("p",[e._v("With Spring Integration 2.0, we switched our build environment to use Git for source control.\nTo access our repository, visit "),n("a",{attrs:{href:"https://git.springsource.org/spring-integration",target:"_blank",rel:"noopener noreferrer"}},[e._v("https://git.springsource.org/spring-integration"),n("OutboundLink")],1),e._v(".\nWe have also switched our build system to "),n("a",{attrs:{href:"https://gradle.org/",target:"_blank",rel:"noopener noreferrer"}},[e._v("Gradle"),n("OutboundLink")],1),e._v(".")]),e._v(" "),n("h4",{attrs:{id:"new-spring-integration-samples"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#new-spring-integration-samples"}},[e._v("#")]),e._v(" New Spring Integration Samples")]),e._v(" "),n("p",[e._v("With Spring Integration 2.0, we have decoupled the samples from our main release distribution.\nPlease read the following blog to get more information: "),n("a",{attrs:{href:"https://spring.io/blog/2010/09/29/new-spring-integration-samples/",target:"_blank",rel:"noopener noreferrer"}},[e._v("New Spring Integration Samples"),n("OutboundLink")],1),e._v(".\nWe have also created many new samples, including samples for every new adapter.")]),e._v(" "),n("h4",{attrs:{id:"spring-tool-suite-visual-editor-for-spring-integration"}},[n("a",{staticClass:"header-anchor",attrs:{href:"#spring-tool-suite-visual-editor-for-spring-integration"}},[e._v("#")]),e._v(" Spring Tool Suite Visual Editor for Spring Integration")]),e._v(" "),n("p",[e._v("There is an amazing new visual editor for Spring Integration included within the latest version of SpringSource Tool Suite.\nIf you are not already using STS, you can download it at "),n("a",{attrs:{href:"https://spring.io/tools/sts",target:"_blank",rel:"noopener noreferrer"}},[e._v("Spring Tool Suite"),n("OutboundLink")],1),e._v(".")])])}),[],!1,null,null,null);t.default=r.exports}}]);