[camel] 02/02: CAMEL-18619: Stream closed for onException with useOriginalMessage

[da...@apache.org]

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

commit 297dfa6c7f85dc1035603d03663bd9f97843bc42
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Sun Mar 26 14:29:05 2023 +0200

    CAMEL-18619: Stream closed for onException with useOriginalMessage
---
 docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc b/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
index a61a5fd5e33..69052560a69 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-4-migration-guide.adoc
@@ -93,6 +93,13 @@ Removed `lang` attribute for the `<description>` on every EIPs.
 The `InOnly` and `InOut` EIPs has been removed.
 Instead, use `SetExchangePattern` or `To` where you can specify exchange pattern to use.
 
+=== UseOriginalMessage / UseOriginalBody
+
+When `useOriginalMessage` or `useOriginalBody` is enabled in `OnException`, `OnCompletion` or error handlers,
+then the original message body is defensively copied and if possible converted to `StreamCache` to ensure
+the body can be re-read when accessed. Previously the original body was not converted to `StreamCache` which
+could lead to the body not able to be read or the stream has been closed.
+
 == Camel Health
 
 Health checks are now by default only readiness checks out of the box.