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 06132c10b64d CAMEL-27052: Upgrade guide notes for 4.22.3 and 4.18.6 - 
camel-jaxb part class and namespace headers (#30348)
06132c10b64d is described below

commit 06132c10b64dc06a603ae97498fd2a41071eecdb
Author: Claus Ibsen <[email protected]>
AuthorDate: Wed Nov 18 21:35:58 2026 +0100

    CAMEL-27052: Upgrade guide notes for 4.22.3 and 4.18.6 - camel-jaxb part 
class and namespace headers (#30348)
    
    The upgrade notes of the camel-4.22.x and camel-4.18.x backports of 
CAMEL-27052, in the 4.22 guide (4.22.2 to 4.22.3)
    and the 4.18 guide (4.18.5 to 4.18.6): the CamelJaxbPartClass and 
CamelJaxbPartNamespace headers are used only when
    allowPartClassFromHeader is enabled.
    
    Co-Authored-By: Claude Opus 5.5 <[email protected]>
---
 .../ROOT/pages/camel-4x-upgrade-guide-4_18.adoc       | 19 +++++++++++++++++++
 .../ROOT/pages/camel-4x-upgrade-guide-4_22.adoc       | 15 +++++++++++++++
 2 files changed, 34 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 5e34ec55f2e0..c0a2d800a605 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
@@ -191,6 +191,25 @@ logs a warning the first time. Before, the consumer 
restored the headers and exc
 Set `transferExchange=true` on both the producer and the consumer endpoints to 
keep transferring the headers and
 exchange properties.
 
+=== camel-jaxb - the part class and namespace headers are used only when 
allowed
+
+The JAXB data format has a new option `allowPartClassFromHeader` (default 
`false`). The `CamelJaxbPartClass` and
+`CamelJaxbPartNamespace` headers are now used only when this option is `true`; 
otherwise they are ignored, and the
+`partClass` and `partNamespace` options of the data format apply. Before, the 
headers were always used, and took
+precedence over these options.
+
+With `allowPartClassFromHeader=true`, the headers now apply to their own 
message only. Before, a header also changed
+the `partClass` and `partNamespace` of the data format, so later messages 
without the header used the class or
+namespace of an earlier message.
+
+Routes that set these headers to choose the part class or namespace per 
message must enable the option, for example
+`jaxb.setAllowPartClassFromHeader(true)` in Java, 
`allowPartClassFromHeader="true"` on `<jaxb>` in XML, or
+`allowPartClassFromHeader: true` in YAML. With REST binding, set the data 
format property
+`xml.out.allowPartClassFromHeader=true` on the REST configuration for a REST 
service (the response), or
+`xml.in.allowPartClassFromHeader=true` for the `rest` producer (the request).
+
+The SOAP data format (camel-soap) is built on the JAXB data format, and always 
ignores these headers.
+
 === camel-lra - only an LRA hosted by the configured coordinator is joined
 
 The LRA saga service now joins, completes or compensates an LRA only when its 
URL is under the configured LRA
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 293f40a1df3f..f4a554f2d3fa 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
@@ -228,6 +228,21 @@ logs a warning the first time. Before, the consumer 
restored the headers and exc
 Set `transferExchange=true` on both the producer and the consumer endpoints to 
keep transferring the headers and
 exchange properties.
 
+=== camel-jaxb - the part class and namespace headers are used only when 
allowed
+
+The JAXB data format has a new option `allowPartClassFromHeader` (default 
`false`). The `CamelJaxbPartClass` and
+`CamelJaxbPartNamespace` headers are now used only when this option is `true`; 
otherwise they are ignored, and the
+`partClass` and `partNamespace` options of the data format apply. Before, the 
headers were always used, and took
+precedence over these options.
+
+Routes that set these headers to choose the part class or namespace per 
message must enable the option, for example
+`jaxb.setAllowPartClassFromHeader(true)` in Java, 
`allowPartClassFromHeader="true"` on `<jaxb>` in XML, or
+`allowPartClassFromHeader: true` in YAML. With REST binding, set the data 
format property
+`xml.out.allowPartClassFromHeader=true` on the REST configuration for a REST 
service (the response), or
+`xml.in.allowPartClassFromHeader=true` for the `rest` producer (the request).
+
+The SOAP data format (camel-soap) is built on the JAXB data format, and always 
ignores these headers.
+
 === camel-milo - the OPC UA client validates the server certificate
 
 When the endpoint it selects uses a security policy other than `None`, the 
`milo-client` and `milo-browse` components

Reply via email to