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 7226ce876b14 CAMEL-24360: docs - note that CAMEL-23588 undertow filter
was not applied before the fix
7226ce876b14 is described below
commit 7226ce876b1432e27e390516401b287501816ddc
Author: Andrea Cosentino <[email protected]>
AuthorDate: Mon Aug 10 07:54:12 2026 +0200
CAMEL-24360: docs - note that CAMEL-23588 undertow filter was not applied
before the fix
Adds NOTE admonitions to the 4.14, 4.18, and 4.21 upgrade guides
clarifying that the UndertowHeaderFilterStrategy filtering described
under CAMEL-23588 was inert on endpoint-configured routes until the
CAMEL-24360 wiring fix shipped in 4.14.9, 4.18.4, and 4.22.0.
Closes #25414
Co-Authored-By: Claude Opus 5 (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 ++++++++++++
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_21.adoc | 12 ++++++++++++
3 files changed, 36 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 4ecedb7cc6da..1c5d0639007a 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
@@ -1251,6 +1251,18 @@ query parameters can supply a custom
`headerFilterStrategy` to restore the previ
=== camel-undertow - potential breaking change
+[NOTE]
+====
+The behaviour described in this section did not take effect in 4.14.8 on
+endpoint-configured routes. `UndertowEndpoint` defaulted its
+`headerFilterStrategy` to the base `HttpHeaderFilterStrategy` and pushed that
+into the `UndertowHttpBinding` it creates lazily, discarding the
+`UndertowHeaderFilterStrategy` this section describes. The filtering takes
+effect from 4.14.9 onwards; see the
+`camel-undertow - UndertowHeaderFilterStrategy is now the endpoint default`
+entry below.
+====
+
`UndertowHeaderFilterStrategy` now also filters the legacy `websocket.*`
Exchange-header prefix (in addition to the `Camel*` / `camel*` /
`org.apache.camel.*` prefixes it already filtered). This applies to both the
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 1e2dcc1ac7a1..d0ff95a15bda 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
@@ -1581,6 +1581,18 @@ to restore the previous behaviour.
=== camel-undertow - potential breaking change
+[NOTE]
+====
+The behaviour described in this section did not take effect in 4.18.3 on
+endpoint-configured routes. `UndertowEndpoint` defaulted its
+`headerFilterStrategy` to the base `HttpHeaderFilterStrategy` and pushed that
+into the `UndertowHttpBinding` it creates lazily, discarding the
+`UndertowHeaderFilterStrategy` this section describes. The filtering takes
+effect from 4.18.4 onwards; see the
+`camel-undertow - UndertowHeaderFilterStrategy is now the endpoint default`
+entry below.
+====
+
`UndertowHeaderFilterStrategy` now also filters the legacy `websocket.*`
Exchange-header prefix (in addition to the `Camel*` / `camel*` /
`org.apache.camel.*` prefixes it already filtered). This applies to both the
diff --git
a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_21.adoc
b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_21.adoc
index 4e8e7d3121d3..94472b7edfa8 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_21.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4x-upgrade-guide-4_21.adoc
@@ -1473,6 +1473,18 @@ A worked example is in `ShiroOverJmsTest` in the
`camel-itest` module.
=== camel-undertow - potential breaking change
+[NOTE]
+====
+The behaviour described in this section did not take effect in 4.21.0 on
+endpoint-configured routes. `UndertowEndpoint` defaulted its
+`headerFilterStrategy` to the base `HttpHeaderFilterStrategy` and pushed that
+into the `UndertowHttpBinding` it creates lazily, discarding the
+`UndertowHeaderFilterStrategy` this section describes. The filtering takes
+effect from 4.22.0 onwards; see the
+`camel-undertow - UndertowHeaderFilterStrategy is now the endpoint default`
+entry in the 4.21 to 4.22 upgrade guide.
+====
+
`UndertowHeaderFilterStrategy` now also filters the legacy `websocket.*`
Exchange-header prefix (in addition to the `Camel*` / `camel*` /
`org.apache.camel.*` prefixes it already filtered). This applies to both the
