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 ca1af9cff50b CAMEL-23891: camel-mail - upgrade-guide notes for
MimeMultipartDataFormat header filtering (4.14.9, 4.18.4) (#24456)
ca1af9cff50b is described below
commit ca1af9cff50b67df1f31c52f682da11ee025a36b
Author: Andrea Cosentino <[email protected]>
AuthorDate: Tue Jul 7 07:16:52 2026 +0200
CAMEL-23891: camel-mail - upgrade-guide notes for MimeMultipartDataFormat
header filtering (4.14.9, 4.18.4) (#24456)
The CAMEL-23891 fix (MimeMultipartDataFormat now filters Camel* headers on
headersInline=true unmarshal) was backported to camel-4.18.x (4.18.4) and
camel-4.14.x (4.14.9). Per project policy the upgrade-guide history is
canonical on main, so add the matching behavior-change notes to the 4_18 and
4_14 maintenance upgrade guides here; the 4_22 note already shipped with the
original fix (#24406).
Signed-off-by: Andrea Cosentino <[email protected]>
Co-authored-by: Claude Opus 4.8 (1M context) <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc | 12 ++++++++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_18.adoc | 12 ++++++++++++
2 files changed, 24 insertions(+)
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
index b4f34880e791..6eb32e3be705 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_14.adoc
@@ -11,6 +11,18 @@ Note that manual migration is still required.
See the xref:camel-upgrade-recipes-tool.adoc[documentation] page for details.
====
+== Upgrading from 4.14.8 to 4.14.9
+
+=== camel-mail - MimeMultipartDataFormat inbound header filtering
+
+When unmarshalling a MIME message with `headersInline=true`, the
`mime-multipart` data format now applies a
+`HeaderFilterStrategy` to the headers copied from the MIME content onto the
Camel message. Camel-internal headers
+(the `Camel*` namespace, matched case-insensitively) present in the external
MIME headers are no longer copied onto
+the message, consistent with the inbound header filtering already performed by
the camel-mail consumer.
+
+Ordinary application headers are unaffected. If a route relied on `Camel*`
headers being propagated from the MIME
+content, set them explicitly after unmarshalling.
+
== Upgrading from 4.14.3 to 4.14.8
=== camel-jackson - potential breaking change
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 727f5842b391..cffcb41adda0 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
@@ -11,6 +11,18 @@ Note that manual migration is still required.
See the xref:camel-upgrade-recipes-tool.adoc[documentation] page for details.
====
+== Upgrading from 4.18.3 to 4.18.4
+
+=== camel-mail - MimeMultipartDataFormat inbound header filtering
+
+When unmarshalling a MIME message with `headersInline=true`, the
`mime-multipart` data format now applies a
+`HeaderFilterStrategy` to the headers copied from the MIME content onto the
Camel message. Camel-internal headers
+(the `Camel*` namespace, matched case-insensitively) present in the external
MIME headers are no longer copied onto
+the message, consistent with the inbound header filtering already performed by
the camel-mail consumer.
+
+Ordinary application headers are unaffected. If a route relied on `Camel*`
headers being propagated from the MIME
+content, set them explicitly after unmarshalling.
+
== Upgrading from 4.18.1 to 4.18.3
=== camel-jackson - potential breaking change
