This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/master by this push:
new 824c52d CAMEL-13761: Update javadoc about startup listener
824c52d is described below
commit 824c52d66322e18e22ff4bf4325dcf4cb7a96087
Author: Claus Ibsen <[email protected]>
AuthorDate: Thu Jul 18 09:27:12 2019 +0200
CAMEL-13761: Update javadoc about startup listener
---
.../src/main/java/org/apache/camel/StartupListener.java | 11 +++++++----
1 file changed, 7 insertions(+), 4 deletions(-)
diff --git a/core/camel-api/src/main/java/org/apache/camel/StartupListener.java
b/core/camel-api/src/main/java/org/apache/camel/StartupListener.java
index ee33bd7..d7efbe3 100644
--- a/core/camel-api/src/main/java/org/apache/camel/StartupListener.java
+++ b/core/camel-api/src/main/java/org/apache/camel/StartupListener.java
@@ -19,13 +19,16 @@ package org.apache.camel;
/**
* Allows objects to be notified when {@link CamelContext} has almost done all
work when starting.
* <p/>
- * This can be used to perform any custom work when the entire {@link
CamelContext} has been initialized and <b>almost</b>
- * started. For example this ensures that all Camel routes have been started
and are up and running, before this callback
- * is invoked.
- * <p/>
* The state of {@link CamelContext} may still be in <tt>starting</tt> when
this callback is invoked, this is by design.
* The callback is invoked during the routes startup procedure when starting
{@link CamelContext}.
* <p/>
+ * This can be used to perform any custom work when the entire {@link
CamelContext} has been initialized and <b>almost</b>
+ * started. This callback is invoked twice during starting the Camel routes,
once before the route consumers are started,
+ * and once again after the route consumer has just been started. This is by
design to allow Camel components
+ * to react accordingly and for example to register custom startup listeners
during starting consumers.
+ * <p/>
+ * If you want to have only one callback after the route consumers has been
fully started then use the {@link ExtendedStartupListener} instead.
+ * <p/>
* For example the QuartzComponent leverages this to ensure the Quartz
scheduler does not start until after all the
* Camel routes and services have already been started.
* <p/>
