You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@camel.apache.org by da...@apache.org on 2023/10/20 09:15:57 UTC
[camel] 01/03: camel-core - Update bridgeErrorHandler documentation
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 638344e14850b543201dce0f2907a604f818a63c
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Fri Oct 20 10:54:29 2023 +0200
camel-core - Update bridgeErrorHandler documentation
---
.../java/org/apache/camel/support/DefaultComponent.java | 15 ++++++++++-----
.../java/org/apache/camel/support/DefaultEndpoint.java | 15 ++++++++++-----
2 files changed, 20 insertions(+), 10 deletions(-)
diff --git a/core/camel-support/src/main/java/org/apache/camel/support/DefaultComponent.java b/core/camel-support/src/main/java/org/apache/camel/support/DefaultComponent.java
index 6e7b52ff956..3f261b397b2 100644
--- a/core/camel-support/src/main/java/org/apache/camel/support/DefaultComponent.java
+++ b/core/camel-support/src/main/java/org/apache/camel/support/DefaultComponent.java
@@ -71,8 +71,11 @@ public abstract class DefaultComponent extends ServiceSupport implements Compone
+ " This can be used for automatic configuring JDBC data sources, JMS connection factories, AWS Clients, etc.")
private boolean autowiredEnabled = true;
@Metadata(label = "consumer",
- description = "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while"
- + " the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler."
+ description = "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while"
+ + " the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler."
+ + " Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only,"
+ + " and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component"
+ + " and make this possible for future releases."
+ " By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.")
private boolean bridgeErrorHandler;
@Metadata(label = "producer",
@@ -229,9 +232,11 @@ public abstract class DefaultComponent extends ServiceSupport implements Compone
}
/**
- * Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the
- * consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by
- * the routing Error Handler.
+ * Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while
+ * the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler.
+ * Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only,
+ * and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component
+ * and make this possible for future releases.
* <p/>
* By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be
* logged at WARN/ERROR level and ignored.
diff --git a/core/camel-support/src/main/java/org/apache/camel/support/DefaultEndpoint.java b/core/camel-support/src/main/java/org/apache/camel/support/DefaultEndpoint.java
index f21d6159cf9..4701779a5bd 100644
--- a/core/camel-support/src/main/java/org/apache/camel/support/DefaultEndpoint.java
+++ b/core/camel-support/src/main/java/org/apache/camel/support/DefaultEndpoint.java
@@ -70,8 +70,11 @@ public abstract class DefaultEndpoint extends ServiceSupport implements Endpoint
+ " then creating and starting the producer may take a little time and prolong the total processing time of the processing.")
private boolean lazyStartProducer;
@UriParam(label = "consumer,advanced",
- description = "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while"
- + " the consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler."
+ description = "Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while"
+ + " the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler."
+ + " Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only,"
+ + " and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component"
+ + " and make this possible for future releases."
+ " By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be logged at WARN or ERROR level and ignored.")
private boolean bridgeErrorHandler;
@UriParam(label = "consumer,advanced", optionalPrefix = "consumer.",
@@ -295,9 +298,11 @@ public abstract class DefaultEndpoint extends ServiceSupport implements Endpoint
}
/**
- * Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions occurred while the
- * consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by
- * the routing Error Handler.
+ * Allows for bridging the consumer to the Camel routing Error Handler, which mean any exceptions (if possible) occurred while
+ * the Camel consumer is trying to pickup incoming messages, or the likes, will now be processed as a message and handled by the routing Error Handler.
+ * Important: This is only possible if the 3rd party component allows Camel to be alerted if an exception was thrown. Some components handle this internally only,
+ * and therefore bridgeErrorHandler is not possible. In other situations we may improve the Camel component to hook into the 3rd party component
+ * and make this possible for future releases.
* <p/>
* By default the consumer will use the org.apache.camel.spi.ExceptionHandler to deal with exceptions, that will be
* logged at WARN/ERROR level and ignored.