This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 1435fd58462a CAMEL-26587: camel-netty - upgrade guide notes for 4.22.3
and 4.18.6 (#29455)
1435fd58462a is described below
commit 1435fd58462a5e2c809b7180dcec839bd3c9bf6c
Author: Andrea Cosentino <[email protected]>
AuthorDate: Mon Nov 9 10:35:18 2026 +0100
CAMEL-26587: camel-netty - upgrade guide notes for 4.22.3 and 4.18.6
(#29455)
* CAMEL-26587: camel-netty - upgrade guide notes for 4.22.3 and 4.18.6
Co-Authored-By: Claude Fable 5.1 <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 8 ++++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 8 ++++++++
2 files changed, 16 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
index 1071f25d905a..56cfa705003d 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc
@@ -268,6 +268,14 @@ a header in the transferred exchange is no longer used,
also when the receiving
the `CamelNettySSLClientCert*` headers on a connection without a client
certificate). This also applies to the reply
the producer receives. Send any such value of the sender under a header name
of your own.
+=== camel-netty - transferExchange requires explicit endpoint configuration
+
+`NettyPayloadHelper` now checks `transferExchange=true` on the endpoint
configuration before reconstructing exchange data from a
`DefaultExchangeHolder` payload.
+
+Before, a receiver with an object decoder silently reconstructed the exchange
even when `transferExchange=false`. Now, when `transferExchange` is disabled
(the default), the incoming `DefaultExchangeHolder` is left as an opaque body
(both on the consumer side and for the producer's reply via `setOut`).
+
+In addition, the legacy two-argument methods
`NettyPayloadHelper.setIn(Exchange, Object)` and `setOut(Exchange, Object)` are
deprecated and no longer unmarshal `DefaultExchangeHolder` payloads. Callers
should migrate to the three-argument overloads passing the `NettyEndpoint`.
+
=== camel-mina - the producer closes its session when a request times out
A synchronous `mina` producer (`sync=true`) now always closes its session when
a request times out while waiting for a
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
index f9810e86a893..319d126ce652 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc
@@ -209,6 +209,14 @@ a header in the transferred exchange is no longer used,
also when the receiving
the `CamelNettySSLClientCert*` headers on a connection without a client
certificate). This also applies to the reply
the producer receives. Send any such value of the sender under a header name
of your own.
+=== camel-netty - transferExchange requires explicit endpoint configuration
+
+`NettyPayloadHelper` now checks `transferExchange=true` on the endpoint
configuration before reconstructing exchange data from a
`DefaultExchangeHolder` payload.
+
+Before, a receiver with an object decoder silently reconstructed the exchange
even when `transferExchange=false`. Now, when `transferExchange` is disabled
(the default), the incoming `DefaultExchangeHolder` is left as an opaque body
(both on the consumer side and for the producer's reply via `setOut`).
+
+In addition, the legacy two-argument methods
`NettyPayloadHelper.setIn(Exchange, Object)` and `setOut(Exchange, Object)` are
deprecated and no longer unmarshal `DefaultExchangeHolder` payloads. Callers
should migrate to the three-argument overloads passing the `NettyEndpoint`.
+
=== camel-mina - the producer closes its session when a request times out
A synchronous `mina` producer (`sync=true`) now always closes its session when
a request times out while waiting for a
