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 698c947d3084 CAMEL-16861: Update docs
698c947d3084 is described below
commit 698c947d30845e52fb8b6bfbe04981a0db7604bb
Author: Claus Ibsen <[email protected]>
AuthorDate: Wed Feb 18 15:56:27 2026 +0100
CAMEL-16861: Update docs
---
.../src/main/docs/modules/eips/nav.adoc | 1 +
.../pages/enterprise-integration-patterns.adoc | 3 +
.../src/main/docs/modules/eips/pages/stop-eip.adoc | 4 +
.../modules/eips/pages/throwException-eip.adoc | 111 +++++++++++++++++++++
4 files changed, 119 insertions(+)
diff --git a/core/camel-core-engine/src/main/docs/modules/eips/nav.adoc
b/core/camel-core-engine/src/main/docs/modules/eips/nav.adoc
index 533226bb9b43..19cebbaaa02e 100644
--- a/core/camel-core-engine/src/main/docs/modules/eips/nav.adoc
+++ b/core/camel-core-engine/src/main/docs/modules/eips/nav.adoc
@@ -97,6 +97,7 @@
** xref:step-eip.adoc[Step]
** xref:stickyLoadBalancer-eip.adoc[Sticky Load Balancer]
** xref:stop-eip.adoc[Stop]
+** xref:throwException-eip.adoc[Stop]
** xref:streamConfig-eip.adoc[StreamConfig]
** xref:threads-eip.adoc[Threads]
** xref:throttle-eip.adoc[Throttle]
diff --git
a/core/camel-core-engine/src/main/docs/modules/eips/pages/enterprise-integration-patterns.adoc
b/core/camel-core-engine/src/main/docs/modules/eips/pages/enterprise-integration-patterns.adoc
index f72fa283e8a1..a2861bdde4bc 100644
---
a/core/camel-core-engine/src/main/docs/modules/eips/pages/enterprise-integration-patterns.adoc
+++
b/core/camel-core-engine/src/main/docs/modules/eips/pages/enterprise-integration-patterns.adoc
@@ -197,6 +197,9 @@ a|image::eip/MessageDispatcherIcon.gif[image]
a|image::eip/MessageExpirationIcon.gif[image]
|xref:stop-eip.adoc[Stop] |How can I stop to continue routing a message?
+a|image::eip/MessageExpirationIcon.gif[image]
+|xref:throwException-eip.adoc[Throw Exception] |How can I throw an exception
during routing?
+
a|image::eip/MessagingGatewayIcon.gif[image]
|xref:serviceCall-eip.adoc[Service Call] |How can I call a remote service in a
distributed system
where the service is looked up from a service registry of some sorts?
diff --git
a/core/camel-core-engine/src/main/docs/modules/eips/pages/stop-eip.adoc
b/core/camel-core-engine/src/main/docs/modules/eips/pages/stop-eip.adoc
index 1602b05483f4..b650bd88ddaa 100644
--- a/core/camel-core-engine/src/main/docs/modules/eips/pages/stop-eip.adoc
+++ b/core/camel-core-engine/src/main/docs/modules/eips/pages/stop-eip.adoc
@@ -104,3 +104,7 @@ using Java code:
Exchange exchange = ...
exchange.setRouteStop(true);
----
+
+== See Also
+
+See also the related xref:throwException-eip.adoc[Throw Exception] EIP.
diff --git
a/core/camel-core-engine/src/main/docs/modules/eips/pages/throwException-eip.adoc
b/core/camel-core-engine/src/main/docs/modules/eips/pages/throwException-eip.adoc
new file mode 100644
index 000000000000..637c1ab60227
--- /dev/null
+++
b/core/camel-core-engine/src/main/docs/modules/eips/pages/throwException-eip.adoc
@@ -0,0 +1,111 @@
+= Stop EIP
+:doctitle: Stop
+:shortname: stop
+:description: Stops the processing of the current message
+:since:
+:supportlevel: Stable
+:tabs-sync-option:
+
+How can I throw an exception
+
+image::eip/MessageExpirationIcon.gif[image]
+
+Use a special processor to throw an exception.
+
+== Options
+
+// eip options: START
+include::partial$eip-options.adoc[]
+// eip options: END
+
+== Exchange properties
+
+// eip exchangeProperties: START
+include::partial$eip-exchangeProperties.adoc[]
+// eip exchangeProperties: END
+
+== Using Throw Exception
+
+In a specific situation we want to fail processing the current message by
throwing an exception.
+In the xref:choice-eip.adoc[Content-Based Router] below we use
`throwException` in such a case.
+
+[tabs]
+====
+Java::
++
+[source,java]
+----
+from("direct:start")
+ .choice()
+ .when(simple("${body} contains 'Hello'")).to("mock:hello")
+ .when(simple("${body} contains
'Bye'")).to("mock:bye").throwException(new IllegalArgumentException("Not
allowed"))
+ .otherwise().to("mock:other")
+ .end()
+.to("mock:result");
+----
+
+XML::
++
+In XML you specify the FQN class name via `exceptionType` and the `message` is
the caused text to include in the exception.
++
+[source,xml]
+----
+ <route>
+ <from uri="direct:start"/>
+ <choice>
+ <when>
+ <simple>${body} contains 'Hello'</simple>
+ <to uri="mock:hello"/>
+ </when>
+ <when>
+ <simple>${body} contains 'Bye'</simple>
+ <to uri="mock:bye"/>
+ <throwException
exceptionType="java.lang.IllegalArgumentException" message="Not Allowed"/>
+ </when>
+ <otherwise>
+ <to uri="mock:other"/>
+ </otherwise>
+ </choice>
+ <to uri="mock:result"/>
+ </route>
+----
+
+YAML::
++
+In YML you specify the FQN class name via `exceptionType` and the `message` is
the caused text to include in the exception.
++
+[source,yaml]
+----
+- route:
+ from:
+ uri: direct:start
+ steps:
+ - choice:
+ when:
+ - expression:
+ simple:
+ expression: "${body} contains 'Hello'"
+ steps:
+ - to:
+ uri: mock:hello
+ - expression:
+ simple:
+ expression: "${body} contains 'Bye'"
+ steps:
+ - to:
+ uri: mock:bye
+ - throwException:
+ exceptionType: "java.lang.IllegalArgumentException"
+ message: "Not Allowed"
+ otherwise:
+ steps:
+ - to:
+ uri: mock:other
+ - to:
+ uri: mock:result
+----
+====
+
+== See Also
+
+See also the related xref:stop-eip.adoc[Stop] EIP.
