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 646c5537d847 CAMEL-25224: add 4.22 upgrade guide entry for xslt
implicit DOM source change (#27291)
646c5537d847 is described below
commit 646c5537d84795bad04f723676487601abec57b5
Author: Salvatore Mongiardo <[email protected]>
AuthorDate: Sat Oct 3 10:17:38 2026 +0200
CAMEL-25224: add 4.22 upgrade guide entry for xslt implicit DOM source
change (#27291)
Documents the camel-xslt change backported to 4.22.2 (#27286) in the 4.22
upgrade guide on main.
Co-Authored-By: Claude Sonnet 4.6 (1M context) <[email protected]>
---
.../modules/ROOT/pages/camel-4x-upgrade-guide-4_22.adoc | 15 +++++++++++++++
1 file changed, 15 insertions(+)
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 c9fd6ce14868..e94b8d4219ae 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
@@ -13,6 +13,21 @@ See the xref:camel-upgrade-recipes-tool.adoc[documentation]
page for details.
== Upgrading from 4.22.1 to 4.22.2
+=== camel-xslt and camel-xslt-saxon - implicit DOM sources
+
+When a non-`Source` input is implicitly converted to a `DOMSource` pointing at
its owner document's
+root element, the Saxon-backed XSLT transformer now starts at the document
node. This preserves
+document-root (`match="/"`) template behavior when, for example, a CXF payload
is converted to a DOM
+source. The default JDK XSLT transformer already starts at the document node;
the change also applies
+to `xslt:` when configured with Saxon as its transformer factory.
+The original DOM and source system ID are preserved. Nested and detached
elements are unchanged.
+Explicit `Source` inputs, including a `Source` returned by the endpoint's
`source` expression,
+retain their selected context node, and streaming sources are unchanged.
+
+Custom implicit converters that intentionally select the document element as
the XSLT context
+may observe different template selection. To retain element-context semantics,
provide an explicit
+`DOMSource(element)` as the body or through the endpoint's `source` expression.
+
=== camel-zipfile, camel-tarfile - a maxDecompressedSize of 2 GiB or more is
now enforced
The `maxDecompressedSize` option of the Zip File and Tar File data formats
(and of `ZipSplitter`) was not
