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 667e5c2fcc69 CAMEL-21356: Javadoc compliance with doclint in
camel-main (#29850)
667e5c2fcc69 is described below
commit 667e5c2fcc69e8c0c1b0e4613c191bbcfacf1dd7
Author: Loris Boiteux <[email protected]>
AuthorDate: Fri Nov 13 17:13:20 2026 +0100
CAMEL-21356: Javadoc compliance with doclint in camel-main (#29850)
Replace <tt> with <code> and self-closing <p/> with <p>, and fix
pre-existing wording and punctuation in the touched Javadoc blocks. The
Javadoc of the configuration properties is copied into the generated
main metadata, so camel-main-configuration-metadata.json and main.adoc
are regenerated, together with their copies in camel-catalog.
Co-authored-by: Claude Opus 5.5 <[email protected]>
---
.../org/apache/camel/catalog/docs/main.adoc | 14 ++--
.../main/camel-main-configuration-metadata.json | 14 ++--
.../camel-main-configuration-metadata.json | 14 ++--
core/camel-main/src/main/docs/main.adoc | 14 ++--
.../org/apache/camel/main/BaseMainSupport.java | 10 +--
.../camel/main/DefaultConfigurationConfigurer.java | 2 +-
.../camel/main/DefaultConfigurationProperties.java | 92 +++++++++++-----------
...ttpManagementServerConfigurationProperties.java | 4 +-
.../apache/camel/main/LoggedStartupFailure.java | 2 +-
.../camel/main/MainConfigurationProperties.java | 42 +++++-----
.../java/org/apache/camel/main/MainHelper.java | 7 +-
.../java/org/apache/camel/main/MainSupport.java | 8 +-
.../camel/main/RestConfigurationProperties.java | 44 +++++------
.../RouteControllerConfigurationProperties.java | 16 ++--
14 files changed, 141 insertions(+), 142 deletions(-)
diff --git
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/main.adoc
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/main.adoc
index 31c90b5a4821..605a3615d15f 100644
---
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/main.adoc
+++
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/docs/main.adoc
@@ -26,9 +26,9 @@ The camel.main supports 132 options, which are listed below.
| Name | Description | Default | Type
| `camel.main.additionalSensitiveKeywords` | Camel comes with a default set of
sensitive keywords which are automatically masked. This option allows to add
additional custom keywords to be masked as well. Multiple keywords can be
separated by comma. | | String
| `camel.main.allowUseOriginalMessage` | Sets whether to allow access to the
original message from Camel's error handler, or from
org.apache.camel.spi.UnitOfWork.getOriginalInMessage(). Turning this off can
optimize performance, as defensive copy of the original message is not needed.
Default is false. | false | boolean
-| `camel.main.autoConfigurationEnabled` | Whether auto configuration of
components, dataformats, languages is enabled or not. When enabled the
configuration parameters are loaded from the properties component. You can
prefix the parameters in the properties file with: -
camel.component.name.option1=value1 - camel.component.name.option2=value2 -
camel.dataformat.name.option1=value1 - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=va [...]
+| `camel.main.autoConfigurationEnabled` | Whether auto configuration of
components, dataformats, languages is enabled or not. When enabled the
configuration parameters are loaded from the properties component. You can
prefix the parameters in the properties file with: -
camel.component.name.option1=value1 - camel.component.name.option2=value2 -
camel.dataformat.name.option1=value1 - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=va [...]
| `camel.main.autoConfigurationEnvironmentVariablesEnabled` | Whether auto
configuration should include OS environment variables as well. When enabled
this allows to overrule any configuration using an OS environment variable. For
example to set a shutdown timeout of 5 seconds: CAMEL_MAIN_SHUTDOWNTIMEOUT=5.
This option is default enabled. | true | boolean
-| `camel.main.autoConfigurationFailFast` | Whether auto configuration should
fail fast when configuring one or more properties fails for whatever reason
such as a invalid property name, etc. This option is default enabled. | true |
boolean
+| `camel.main.autoConfigurationFailFast` | Whether auto configuration should
fail fast when configuring one or more properties fails for whatever reason
such as an invalid property name, etc. This option is default enabled. | true |
boolean
| `camel.main.autoConfigurationLogSummary` | Whether auto configuration should
log a summary with the configured properties. This option is default enabled. |
true | boolean
| `camel.main.autoConfigurationSystemPropertiesEnabled` | Whether auto
configuration should include JVM system properties as well. When enabled this
allows to overrule any configuration using a JVM system property. For example
to set a shutdown timeout of 5 seconds: -D camel.main.shutdown-timeout=5. Note
that JVM system properties take precedence over OS environment variables. This
option is default enabled. | true | boolean
| `camel.main.autoStartup` | Sets whether the object should automatically
start when Camel starts. Important: Currently only routes can be disabled, as
CamelContext's are always started. Note: When setting auto startup false on
CamelContext then that takes precedence and no routes are started. You would
need to start CamelContext explicit using the
org.apache.camel.CamelContext.start() method, to start the context, and then
you would need to start the routes manually using CamelContext.g [...]
@@ -62,7 +62,7 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.durationMaxIdleSeconds` | To specify for how long time in
seconds Camel can be idle before automatic terminating the JVM. You can use
this to run Camel for a short while. | | int
| `camel.main.durationMaxMessages` | To specify how many messages to process
by Camel before automatic terminating the JVM. You can use this to run Camel
for a short while. | | int
| `camel.main.durationMaxSeconds` | To specify for how long time in seconds to
keep running the JVM before automatic terminating the JVM. You can use this to
run Camel for a short while. | | int
-| `camel.main.endpointBridgeErrorHandler` | 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. 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. The default
value is false. | false | boolean
+| `camel.main.endpointBridgeErrorHandler` | Allows for bridging the consumer
to the Camel routing Error Handler, which means 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. 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. The default
value is false. | false | boolean
| `camel.main.endpointLazyStartProducer` | Whether the producer should be
started lazy (on the first message). By starting lazy you can use this to allow
CamelContext and routes to startup in situations where a producer may otherwise
fail during starting and cause the route to fail being started. By deferring
this startup to be lazy then the startup failure can be handled during routing
messages via Camel's routing error handlers. Beware that when the first message
is processed then crea [...]
| `camel.main.endpointRuntimeStatisticsEnabled` | Sets whether endpoint
runtime statistics is enabled (gathers runtime usage of each incoming and
outgoing endpoints). The default value is false. | false | boolean
| `camel.main.exchangeFactory` | Controls whether to pool (reuse) exchanges or
create new exchanges (prototype). Using pooled will reduce JVM garbage
collection overhead by avoiding to re-create Exchange instances per message
each consumer receives. The default is prototype mode. | default | String
@@ -85,12 +85,12 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.jmxUpdateRouteEnabled` | Whether to allow updating routes at
runtime via JMX using the ManagedRouteMBean. This is disabled by default, but
can be enabled for development and troubleshooting purposes, such as updating
routes in an existing running Camel via JMX and other tools. | false | boolean
| `camel.main.loadHealthChecks` | Whether to load custom health checks by
scanning classpath. | false | boolean
| `camel.main.loadStatisticsEnabled` | Sets whether Camel load (inflight
messages, not cpu) statistics is enabled (something like the unix load
average). The statistics requires to have camel-management on the classpath as
JMX is required. The default value is false. | false | boolean
-| `camel.main.loadTypeConverters` | Whether to load custom type converters by
scanning classpath. This is used for backwards compatibility with Camel 2.x.
Its recommended to migrate to use fast type converter loading by setting
Converter(loader = true) on your custom type converter classes. | false |
boolean
+| `camel.main.loadTypeConverters` | Whether to load custom type converters by
scanning classpath. This is used for backwards compatibility with Camel 2.x.
It's recommended to migrate to use fast type converter loading by setting
Converter(loader = true) on your custom type converter classes. | false |
boolean
| `camel.main.logDebugMaxChars` | Is used to limit the maximum length of the
logging Camel message bodies. If the message body is longer than the limit, the
log message is clipped. Use -1 to have unlimited length. Use for example 1000
to log at most 1000 characters. | | int
| `camel.main.logExhaustedMessageBody` | Sets whether to log exhausted message
body with message history. Default is false. | false | boolean
| `camel.main.logLanguage` | To configure the language to use for Log EIP. By
default, the simple language is used. However, Camel also supports other
languages such as groovy. | | String
| `camel.main.logMask` | Sets whether log mask is enabled or not. Default is
false. | false | boolean
-| `camel.main.logName` | The global name to use for Log EIP The name is
default the routeId or the source:line if source location is enabled. You can
also specify the name using tokens: $\{class} - the logger class name
(org.apache.camel.processor.LogProcessor) $\{contextId} - the camel context id
$\{routeId} - the route id $\{groupId} - the route group id $\{nodeId} - the
node id $\{nodePrefixId} - the node prefix id $\{source} - the source:line
(source location must be enabled) ${sourc [...]
+| `camel.main.logName` | The global name to use for Log EIP. The name is by
default the routeId or the source:line if source location is enabled. You can
also specify the name using tokens: $\{class} - the logger class name
(org.apache.camel.processor.LogProcessor) $\{contextId} - the camel context id
$\{routeId} - the route id $\{groupId} - the route group id $\{nodeId} - the
node id $\{nodePrefixId} - the node prefix id $\{source} - the source:line
(source location must be enabled) ${s [...]
| `camel.main.mainListenerClasses` | Sets classes names that will be used for
MainListener that makes it possible to do custom logic during starting and
stopping camel-main. | | String
| `camel.main.mainListeners` | Sets main listener objects that will be used
for MainListener that makes it possible to do custom logic during starting and
stopping camel-main. | | List
| `camel.main.mdcLoggingKeysPattern` | Sets the pattern used for determine
which custom MDC keys to propagate during message routing when the routing
engine continues routing asynchronously for the given message. Setting this
pattern to * will propagate all custom keys. Or setting the pattern to
foo*,bar* will propagate any keys starting with either foo or bar. Notice that
a set of standard Camel MDC keys are always propagated which starts with camel.
as key name. The match rules are app [...]
@@ -112,7 +112,7 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.routesReloadDirectoryRecursive` | Whether the directory to scan
should include sub directories. Depending on the number of sub directories,
then this can cause the JVM to startup slower as Camel uses the JDK file-watch
service to scan for file changes. | false | boolean
| `camel.main.routesReloadEnabled` | Used for enabling automatic routes
reloading. If enabled then Camel will watch for file changes in the given
reload directory, and trigger reloading routes if files are changed. | false |
boolean
| `camel.main.routesReloadInterval` | How often to scan the reload directory
for changed files, in millis. A change is reloaded at the next scan, so a
shorter interval reloads it sooner. A longer interval groups more of one save
together: two files saved a second apart are one change at 2000 and two at
1000. | 2000 | long
-| `camel.main.routesReloadPattern` | Used for inclusive filtering of routes
from directories. Typical used for specifying to accept routes in XML or YAML
files, such as *.yaml,*.xml. Multiple patterns can be specified separated by
comma. | | String
+| `camel.main.routesReloadPattern` | Used for inclusive filtering of routes
from directories. Typically used for specifying to accept routes in XML or YAML
files, such as *.yaml,*.xml. Multiple patterns can be specified separated by
comma. | | String
| `camel.main.routesReloadRemoveAllRoutes` | When reloading routes should all
existing routes be stopped and removed. By default, Camel will stop and remove
all existing routes before reloading routes. This ensures that only the
reloaded routes will be active. If disabled then only routes with the same
route id is updated, and any existing routes are continued to run. | true |
boolean
| `camel.main.routesReloadRestartDuration` | Whether to restart max duration
when routes are reloaded. For example if max duration is 60 seconds, and a
route is reloaded after 25 seconds, then this will restart the count and wait
60 seconds again. | false | boolean
| `camel.main.shutdownLogInflightExchangesOnTimeout` | Sets whether to log
information about the inflight Exchanges which are still running during a
shutdown which didn't complete without the given timeout. This requires to
enable the option inflightRepositoryBrowseEnabled. | true | boolean
@@ -256,7 +256,7 @@ The camel.management supports 31 options, which are listed
below.
| `camel.management.authenticationPath` | Set HTTP url path of embedded server
that is protected by authentication configuration. | | String
| `camel.management.authenticationRealm` | Sets the authentication realm | |
String
| `camel.management.basicPropertiesFile` | Name of the file that contains
basic authentication info for Vert.x file auth provider. | | String
-| `camel.management.devConsoleEnabled` | Whether to enable developer console
(not intended for production use). Dev console must also be enabled on
CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code camelContext.setDevConsole(true); If
enabled then you can access a basic developer console on context-path: /q/dev.
| false | boolean
+| `camel.management.devConsoleEnabled` | Whether to enable developer console
(not intended for production use). Dev console must also be enabled on
CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code camelContext.setDevConsole(true);. If
enabled then you can access a basic developer console on context-path: /q/dev.
| false | boolean
| `camel.management.downloadEnabled` | Whether to enable file download via
HTTP. This makes it possible to browse and download resource source files such
as Camel XML or YAML routes. Only enable this for development, troubleshooting
or special situations for management and monitoring. | false | boolean
| `camel.management.enabled` | Whether embedded HTTP server is enabled. By
default, the server is not enabled. | false | boolean
| `camel.management.healthCheckEnabled` | Whether to enable health-check
console. If enabled then you can access health-check status on context-path:
/observe/health | false | boolean
diff --git
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/main/camel-main-configuration-metadata.json
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/main/camel-main-configuration-metadata.json
index cf1d9198bc3b..bb9e0af07fd5 100644
---
a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/main/camel-main-configuration-metadata.json
+++
b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/main/camel-main-configuration-metadata.json
@@ -42,9 +42,9 @@
"properties": [
{ "name": "camel.main.additionalSensitiveKeywords", "required": false,
"description": "Camel comes with a default set of sensitive keywords which are
automatically masked. This option allows to add additional custom keywords to
be masked as well. Multiple keywords can be separated by comma.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "string",
"javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.allowUseOriginalMessage", "required": false,
"description": "Sets whether to allow access to the original message from
Camel's error handler, or from
org.apache.camel.spi.UnitOfWork.getOriginalInMessage(). Turning this off can
optimize performance, as defensive copy of the original message is not needed.
Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secr [...]
- { "name": "camel.main.autoConfigurationEnabled", "required": false,
"description": "Whether auto configuration of components, dataformats,
languages is enabled or not. When enabled the configuration parameters are
loaded from the properties component. You can prefix the parameters in the
properties file with: - camel.component.name.option1=value1 -
camel.component.name.option2=value2 - camel.dataformat.name.option1=value1 -
camel.dataformat.name.option2=value2 - camel.language.name.o [...]
+ { "name": "camel.main.autoConfigurationEnabled", "required": false,
"description": "Whether auto configuration of components, dataformats,
languages is enabled or not. When enabled the configuration parameters are
loaded from the properties component. You can prefix the parameters in the
properties file with: - camel.component.name.option1=value1 -
camel.component.name.option2=value2 - camel.dataformat.name.option1=value1 -
camel.dataformat.name.option2=value2 - camel.language.name.o [...]
{ "name": "camel.main.autoConfigurationEnvironmentVariablesEnabled",
"required": false, "description": "Whether auto configuration should include OS
environment variables as well. When enabled this allows to overrule any
configuration using an OS environment variable. For example to set a shutdown
timeout of 5 seconds: CAMEL_MAIN_SHUTDOWNTIMEOUT=5. This option is default
enabled.", "sourceType": "org.apache.camel.main.MainConfigurationProperties",
"type": "boolean", "javaType": "bool [...]
- { "name": "camel.main.autoConfigurationFailFast", "required": false,
"description": "Whether auto configuration should fail fast when configuring
one or more properties fails for whatever reason such as a invalid property
name, etc. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
+ { "name": "camel.main.autoConfigurationFailFast", "required": false,
"description": "Whether auto configuration should fail fast when configuring
one or more properties fails for whatever reason such as an invalid property
name, etc. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
{ "name": "camel.main.autoConfigurationLogSummary", "required": false,
"description": "Whether auto configuration should log a summary with the
configured properties. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
{ "name": "camel.main.autoConfigurationSystemPropertiesEnabled",
"required": false, "description": "Whether auto configuration should include
JVM system properties as well. When enabled this allows to overrule any
configuration using a JVM system property. For example to set a shutdown
timeout of 5 seconds: -D camel.main.shutdown-timeout=5. Note that JVM system
properties take precedence over OS environment variables. This option is
default enabled.", "sourceType": "org.apache.camel. [...]
{ "name": "camel.main.autoStartup", "required": false, "description":
"Sets whether the object should automatically start when Camel starts.
Important: Currently only routes can be disabled, as CamelContext's are always
started. Note: When setting auto startup false on CamelContext then that takes
precedence and no routes are started. You would need to start CamelContext
explicit using the org.apache.camel.CamelContext.start() method, to start the
context, and then you would need to [...]
@@ -78,7 +78,7 @@
{ "name": "camel.main.durationMaxIdleSeconds", "required": false,
"description": "To specify for how long time in seconds Camel can be idle
before automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
{ "name": "camel.main.durationMaxMessages", "required": false,
"description": "To specify how many messages to process by Camel before
automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
{ "name": "camel.main.durationMaxSeconds", "required": false,
"description": "To specify for how long time in seconds to keep running the JVM
before automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
- { "name": "camel.main.endpointBridgeErrorHandler", "required": false,
"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. 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 igno [...]
+ { "name": "camel.main.endpointBridgeErrorHandler", "required": false,
"description": "Allows for bridging the consumer to the Camel routing Error
Handler, which means 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. 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 ign [...]
{ "name": "camel.main.endpointLazyStartProducer", "required": false,
"description": "Whether the producer should be started lazy (on the first
message). By starting lazy you can use this to allow CamelContext and routes to
startup in situations where a producer may otherwise fail during starting and
cause the route to fail being started. By deferring this startup to be lazy
then the startup failure can be handled during routing messages via Camel's
routing error handlers. Beware that [...]
{ "name": "camel.main.endpointRuntimeStatisticsEnabled", "required":
false, "description": "Sets whether endpoint runtime statistics is enabled
(gathers runtime usage of each incoming and outgoing endpoints). The default
value is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.exchangeFactory", "required": false, "description":
"Controls whether to pool (reuse) exchanges or create new exchanges
(prototype). Using pooled will reduce JVM garbage collection overhead by
avoiding to re-create Exchange instances per message each consumer receives.
The default is prototype mode.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "enum",
"javaType": "java.lang.String", "defaultValue": "default", "secret": false, "
[...]
@@ -101,12 +101,12 @@
{ "name": "camel.main.jmxUpdateRouteEnabled", "required": false,
"description": "Whether to allow updating routes at runtime via JMX using the
ManagedRouteMBean. This is disabled by default, but can be enabled for
development and troubleshooting purposes, such as updating routes in an
existing running Camel via JMX and other tools.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.loadHealthChecks", "required": false, "description":
"Whether to load custom health checks by scanning classpath.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.loadStatisticsEnabled", "required": false,
"description": "Sets whether Camel load (inflight messages, not cpu) statistics
is enabled (something like the unix load average). The statistics requires to
have camel-management on the classpath as JMX is required. The default value is
false.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "boolean", "javaType": "boolean", "defaultValue": false, "secret":
false },
- { "name": "camel.main.loadTypeConverters", "required": false,
"description": "Whether to load custom type converters by scanning classpath.
This is used for backwards compatibility with Camel 2.x. Its recommended to
migrate to use fast type converter loading by setting Converter(loader = true)
on your custom type converter classes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
+ { "name": "camel.main.loadTypeConverters", "required": false,
"description": "Whether to load custom type converters by scanning classpath.
This is used for backwards compatibility with Camel 2.x. It's recommended to
migrate to use fast type converter loading by setting Converter(loader = true)
on your custom type converter classes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.logDebugMaxChars", "required": false, "description":
"Is used to limit the maximum length of the logging Camel message bodies. If
the message body is longer than the limit, the log message is clipped. Use -1
to have unlimited length. Use for example 1000 to log at most 1000
characters.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "integer",
"javaType": "int", "secret": false },
{ "name": "camel.main.logExhaustedMessageBody", "required": false,
"description": "Sets whether to log exhausted message body with message
history. Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.logLanguage", "required": false, "description": "To
configure the language to use for Log EIP. By default, the simple language is
used. However, Camel also supports other languages such as groovy.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.logMask", "required": false, "description": "Sets
whether log mask is enabled or not. Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
- { "name": "camel.main.logName", "required": false, "description": "The
global name to use for Log EIP The name is default the routeId or the
source:line if source location is enabled. You can also specify the name using
tokens: ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) ${contextId} - the camel context id
${routeId} - the route id ${groupId} - the route group id ${nodeId} - the node
id ${nodePrefixId} - the node prefix id ${source} - the source:line (s [...]
+ { "name": "camel.main.logName", "required": false, "description": "The
global name to use for Log EIP. The name is by default the routeId or the
source:line if source location is enabled. You can also specify the name using
tokens: ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) ${contextId} - the camel context id
${routeId} - the route id ${groupId} - the route group id ${nodeId} - the node
id ${nodePrefixId} - the node prefix id ${source} - the source:lin [...]
{ "name": "camel.main.mainListenerClasses", "required": false,
"description": "Sets classes names that will be used for MainListener that
makes it possible to do custom logic during starting and stopping camel-main.",
"sourceType": "org.apache.camel.main.MainConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.mainListeners", "required": false, "description":
"Sets main listener objects that will be used for MainListener that makes it
possible to do custom logic during starting and stopping camel-main.",
"sourceType": "org.apache.camel.main.MainConfigurationProperties", "type":
"array", "javaType": "java.util.List", "secret": false },
{ "name": "camel.main.mdcLoggingKeysPattern", "required": false,
"description": "Sets the pattern used for determine which custom MDC keys to
propagate during message routing when the routing engine continues routing
asynchronously for the given message. Setting this pattern to * will propagate
all custom keys. Or setting the pattern to foo*,bar* will propagate any keys
starting with either foo or bar. Notice that a set of standard Camel MDC keys
are always propagated which starts wi [...]
@@ -128,7 +128,7 @@
{ "name": "camel.main.routesReloadDirectoryRecursive", "required": false,
"description": "Whether the directory to scan should include sub directories.
Depending on the number of sub directories, then this can cause the JVM to
startup slower as Camel uses the JDK file-watch service to scan for file
changes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.routesReloadEnabled", "required": false,
"description": "Used for enabling automatic routes reloading. If enabled then
Camel will watch for file changes in the given reload directory, and trigger
reloading routes if files are changed.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.routesReloadInterval", "required": false,
"description": "How often to scan the reload directory for changed files, in
millis. A change is reloaded at the next scan, so a shorter interval reloads it
sooner. A longer interval groups more of one save together: two files saved a
second apart are one change at 2000 and two at 1000.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "integer",
"javaType": "long", "defaultValue": 2000, "se [...]
- { "name": "camel.main.routesReloadPattern", "required": false,
"description": "Used for inclusive filtering of routes from directories.
Typical used for specifying to accept routes in XML or YAML files, such as
*.yaml,*.xml. Multiple patterns can be specified separated by comma.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
+ { "name": "camel.main.routesReloadPattern", "required": false,
"description": "Used for inclusive filtering of routes from directories.
Typically used for specifying to accept routes in XML or YAML files, such as
*.yaml,*.xml. Multiple patterns can be specified separated by comma.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.routesReloadRemoveAllRoutes", "required": false,
"description": "When reloading routes should all existing routes be stopped and
removed. By default, Camel will stop and remove all existing routes before
reloading routes. This ensures that only the reloaded routes will be active. If
disabled then only routes with the same route id is updated, and any existing
routes are continued to run.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "ty [...]
{ "name": "camel.main.routesReloadRestartDuration", "required": false,
"description": "Whether to restart max duration when routes are reloaded. For
example if max duration is 60 seconds, and a route is reloaded after 25
seconds, then this will restart the count and wait 60 seconds again.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.shutdownLogInflightExchangesOnTimeout", "required":
false, "description": "Sets whether to log information about the inflight
Exchanges which are still running during a shutdown which didn't complete
without the given timeout. This requires to enable the option
inflightRepositoryBrowseEnabled.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
@@ -310,7 +310,7 @@
{ "name": "camel.management.authenticationPath", "required": false,
"description": "Set HTTP url path of embedded server that is protected by
authentication configuration.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.management.authenticationRealm", "required": false,
"description": "Sets the authentication realm", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.management.basicPropertiesFile", "required": false,
"description": "Name of the file that contains basic authentication info for
Vert.x file auth provider.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
- { "name": "camel.management.devConsoleEnabled", "required": false,
"description": "Whether to enable developer console (not intended for
production use). Dev console must also be enabled on CamelContext. For example
by setting camel.context.dev-console=true in application.properties, or via
code camelContext.setDevConsole(true); If enabled then you can access a basic
developer console on context-path: \/q\/dev.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationP [...]
+ { "name": "camel.management.devConsoleEnabled", "required": false,
"description": "Whether to enable developer console (not intended for
production use). Dev console must also be enabled on CamelContext. For example
by setting camel.context.dev-console=true in application.properties, or via
code camelContext.setDevConsole(true);. If enabled then you can access a basic
developer console on context-path: \/q\/dev.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfiguration [...]
{ "name": "camel.management.downloadEnabled", "required": false,
"description": "Whether to enable file download via HTTP. This makes it
possible to browse and download resource source files such as Camel XML or YAML
routes. Only enable this for development, troubleshooting or special situations
for management and monitoring.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": [...]
{ "name": "camel.management.enabled", "required": false, "description":
"Whether embedded HTTP server is enabled. By default, the server is not
enabled.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.management.healthCheckEnabled", "required": false,
"description": "Whether to enable health-check console. If enabled then you can
access health-check status on context-path: \/observe\/health", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
diff --git
a/core/camel-main/src/generated/resources/META-INF/camel-main-configuration-metadata.json
b/core/camel-main/src/generated/resources/META-INF/camel-main-configuration-metadata.json
index cf1d9198bc3b..bb9e0af07fd5 100644
---
a/core/camel-main/src/generated/resources/META-INF/camel-main-configuration-metadata.json
+++
b/core/camel-main/src/generated/resources/META-INF/camel-main-configuration-metadata.json
@@ -42,9 +42,9 @@
"properties": [
{ "name": "camel.main.additionalSensitiveKeywords", "required": false,
"description": "Camel comes with a default set of sensitive keywords which are
automatically masked. This option allows to add additional custom keywords to
be masked as well. Multiple keywords can be separated by comma.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "string",
"javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.allowUseOriginalMessage", "required": false,
"description": "Sets whether to allow access to the original message from
Camel's error handler, or from
org.apache.camel.spi.UnitOfWork.getOriginalInMessage(). Turning this off can
optimize performance, as defensive copy of the original message is not needed.
Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secr [...]
- { "name": "camel.main.autoConfigurationEnabled", "required": false,
"description": "Whether auto configuration of components, dataformats,
languages is enabled or not. When enabled the configuration parameters are
loaded from the properties component. You can prefix the parameters in the
properties file with: - camel.component.name.option1=value1 -
camel.component.name.option2=value2 - camel.dataformat.name.option1=value1 -
camel.dataformat.name.option2=value2 - camel.language.name.o [...]
+ { "name": "camel.main.autoConfigurationEnabled", "required": false,
"description": "Whether auto configuration of components, dataformats,
languages is enabled or not. When enabled the configuration parameters are
loaded from the properties component. You can prefix the parameters in the
properties file with: - camel.component.name.option1=value1 -
camel.component.name.option2=value2 - camel.dataformat.name.option1=value1 -
camel.dataformat.name.option2=value2 - camel.language.name.o [...]
{ "name": "camel.main.autoConfigurationEnvironmentVariablesEnabled",
"required": false, "description": "Whether auto configuration should include OS
environment variables as well. When enabled this allows to overrule any
configuration using an OS environment variable. For example to set a shutdown
timeout of 5 seconds: CAMEL_MAIN_SHUTDOWNTIMEOUT=5. This option is default
enabled.", "sourceType": "org.apache.camel.main.MainConfigurationProperties",
"type": "boolean", "javaType": "bool [...]
- { "name": "camel.main.autoConfigurationFailFast", "required": false,
"description": "Whether auto configuration should fail fast when configuring
one or more properties fails for whatever reason such as a invalid property
name, etc. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
+ { "name": "camel.main.autoConfigurationFailFast", "required": false,
"description": "Whether auto configuration should fail fast when configuring
one or more properties fails for whatever reason such as an invalid property
name, etc. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
{ "name": "camel.main.autoConfigurationLogSummary", "required": false,
"description": "Whether auto configuration should log a summary with the
configured properties. This option is default enabled.", "sourceType":
"org.apache.camel.main.MainConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
{ "name": "camel.main.autoConfigurationSystemPropertiesEnabled",
"required": false, "description": "Whether auto configuration should include
JVM system properties as well. When enabled this allows to overrule any
configuration using a JVM system property. For example to set a shutdown
timeout of 5 seconds: -D camel.main.shutdown-timeout=5. Note that JVM system
properties take precedence over OS environment variables. This option is
default enabled.", "sourceType": "org.apache.camel. [...]
{ "name": "camel.main.autoStartup", "required": false, "description":
"Sets whether the object should automatically start when Camel starts.
Important: Currently only routes can be disabled, as CamelContext's are always
started. Note: When setting auto startup false on CamelContext then that takes
precedence and no routes are started. You would need to start CamelContext
explicit using the org.apache.camel.CamelContext.start() method, to start the
context, and then you would need to [...]
@@ -78,7 +78,7 @@
{ "name": "camel.main.durationMaxIdleSeconds", "required": false,
"description": "To specify for how long time in seconds Camel can be idle
before automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
{ "name": "camel.main.durationMaxMessages", "required": false,
"description": "To specify how many messages to process by Camel before
automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
{ "name": "camel.main.durationMaxSeconds", "required": false,
"description": "To specify for how long time in seconds to keep running the JVM
before automatic terminating the JVM. You can use this to run Camel for a short
while.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "integer", "javaType": "int", "secret": false },
- { "name": "camel.main.endpointBridgeErrorHandler", "required": false,
"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. 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 igno [...]
+ { "name": "camel.main.endpointBridgeErrorHandler", "required": false,
"description": "Allows for bridging the consumer to the Camel routing Error
Handler, which means 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. 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 ign [...]
{ "name": "camel.main.endpointLazyStartProducer", "required": false,
"description": "Whether the producer should be started lazy (on the first
message). By starting lazy you can use this to allow CamelContext and routes to
startup in situations where a producer may otherwise fail during starting and
cause the route to fail being started. By deferring this startup to be lazy
then the startup failure can be handled during routing messages via Camel's
routing error handlers. Beware that [...]
{ "name": "camel.main.endpointRuntimeStatisticsEnabled", "required":
false, "description": "Sets whether endpoint runtime statistics is enabled
(gathers runtime usage of each incoming and outgoing endpoints). The default
value is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.exchangeFactory", "required": false, "description":
"Controls whether to pool (reuse) exchanges or create new exchanges
(prototype). Using pooled will reduce JVM garbage collection overhead by
avoiding to re-create Exchange instances per message each consumer receives.
The default is prototype mode.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "enum",
"javaType": "java.lang.String", "defaultValue": "default", "secret": false, "
[...]
@@ -101,12 +101,12 @@
{ "name": "camel.main.jmxUpdateRouteEnabled", "required": false,
"description": "Whether to allow updating routes at runtime via JMX using the
ManagedRouteMBean. This is disabled by default, but can be enabled for
development and troubleshooting purposes, such as updating routes in an
existing running Camel via JMX and other tools.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.loadHealthChecks", "required": false, "description":
"Whether to load custom health checks by scanning classpath.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.loadStatisticsEnabled", "required": false,
"description": "Sets whether Camel load (inflight messages, not cpu) statistics
is enabled (something like the unix load average). The statistics requires to
have camel-management on the classpath as JMX is required. The default value is
false.", "sourceType": "org.apache.camel.main.DefaultConfigurationProperties",
"type": "boolean", "javaType": "boolean", "defaultValue": false, "secret":
false },
- { "name": "camel.main.loadTypeConverters", "required": false,
"description": "Whether to load custom type converters by scanning classpath.
This is used for backwards compatibility with Camel 2.x. Its recommended to
migrate to use fast type converter loading by setting Converter(loader = true)
on your custom type converter classes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
+ { "name": "camel.main.loadTypeConverters", "required": false,
"description": "Whether to load custom type converters by scanning classpath.
This is used for backwards compatibility with Camel 2.x. It's recommended to
migrate to use fast type converter loading by setting Converter(loader = true)
on your custom type converter classes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.logDebugMaxChars", "required": false, "description":
"Is used to limit the maximum length of the logging Camel message bodies. If
the message body is longer than the limit, the log message is clipped. Use -1
to have unlimited length. Use for example 1000 to log at most 1000
characters.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "integer",
"javaType": "int", "secret": false },
{ "name": "camel.main.logExhaustedMessageBody", "required": false,
"description": "Sets whether to log exhausted message body with message
history. Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.logLanguage", "required": false, "description": "To
configure the language to use for Log EIP. By default, the simple language is
used. However, Camel also supports other languages such as groovy.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.logMask", "required": false, "description": "Sets
whether log mask is enabled or not. Default is false.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
- { "name": "camel.main.logName", "required": false, "description": "The
global name to use for Log EIP The name is default the routeId or the
source:line if source location is enabled. You can also specify the name using
tokens: ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) ${contextId} - the camel context id
${routeId} - the route id ${groupId} - the route group id ${nodeId} - the node
id ${nodePrefixId} - the node prefix id ${source} - the source:line (s [...]
+ { "name": "camel.main.logName", "required": false, "description": "The
global name to use for Log EIP. The name is by default the routeId or the
source:line if source location is enabled. You can also specify the name using
tokens: ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) ${contextId} - the camel context id
${routeId} - the route id ${groupId} - the route group id ${nodeId} - the node
id ${nodePrefixId} - the node prefix id ${source} - the source:lin [...]
{ "name": "camel.main.mainListenerClasses", "required": false,
"description": "Sets classes names that will be used for MainListener that
makes it possible to do custom logic during starting and stopping camel-main.",
"sourceType": "org.apache.camel.main.MainConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.mainListeners", "required": false, "description":
"Sets main listener objects that will be used for MainListener that makes it
possible to do custom logic during starting and stopping camel-main.",
"sourceType": "org.apache.camel.main.MainConfigurationProperties", "type":
"array", "javaType": "java.util.List", "secret": false },
{ "name": "camel.main.mdcLoggingKeysPattern", "required": false,
"description": "Sets the pattern used for determine which custom MDC keys to
propagate during message routing when the routing engine continues routing
asynchronously for the given message. Setting this pattern to * will propagate
all custom keys. Or setting the pattern to foo*,bar* will propagate any keys
starting with either foo or bar. Notice that a set of standard Camel MDC keys
are always propagated which starts wi [...]
@@ -128,7 +128,7 @@
{ "name": "camel.main.routesReloadDirectoryRecursive", "required": false,
"description": "Whether the directory to scan should include sub directories.
Depending on the number of sub directories, then this can cause the JVM to
startup slower as Camel uses the JDK file-watch service to scan for file
changes.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.routesReloadEnabled", "required": false,
"description": "Used for enabling automatic routes reloading. If enabled then
Camel will watch for file changes in the given reload directory, and trigger
reloading routes if files are changed.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.routesReloadInterval", "required": false,
"description": "How often to scan the reload directory for changed files, in
millis. A change is reloaded at the next scan, so a shorter interval reloads it
sooner. A longer interval groups more of one save together: two files saved a
second apart are one change at 2000 and two at 1000.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "integer",
"javaType": "long", "defaultValue": 2000, "se [...]
- { "name": "camel.main.routesReloadPattern", "required": false,
"description": "Used for inclusive filtering of routes from directories.
Typical used for specifying to accept routes in XML or YAML files, such as
*.yaml,*.xml. Multiple patterns can be specified separated by comma.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
+ { "name": "camel.main.routesReloadPattern", "required": false,
"description": "Used for inclusive filtering of routes from directories.
Typically used for specifying to accept routes in XML or YAML files, such as
*.yaml,*.xml. Multiple patterns can be specified separated by comma.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.main.routesReloadRemoveAllRoutes", "required": false,
"description": "When reloading routes should all existing routes be stopped and
removed. By default, Camel will stop and remove all existing routes before
reloading routes. This ensures that only the reloaded routes will be active. If
disabled then only routes with the same route id is updated, and any existing
routes are continued to run.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "ty [...]
{ "name": "camel.main.routesReloadRestartDuration", "required": false,
"description": "Whether to restart max duration when routes are reloaded. For
example if max duration is 60 seconds, and a route is reloaded after 25
seconds, then this will restart the count and wait 60 seconds again.",
"sourceType": "org.apache.camel.main.DefaultConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.main.shutdownLogInflightExchangesOnTimeout", "required":
false, "description": "Sets whether to log information about the inflight
Exchanges which are still running during a shutdown which didn't complete
without the given timeout. This requires to enable the option
inflightRepositoryBrowseEnabled.", "sourceType":
"org.apache.camel.main.DefaultConfigurationProperties", "type": "boolean",
"javaType": "boolean", "defaultValue": true, "secret": false },
@@ -310,7 +310,7 @@
{ "name": "camel.management.authenticationPath", "required": false,
"description": "Set HTTP url path of embedded server that is protected by
authentication configuration.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.management.authenticationRealm", "required": false,
"description": "Sets the authentication realm", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
{ "name": "camel.management.basicPropertiesFile", "required": false,
"description": "Name of the file that contains basic authentication info for
Vert.x file auth provider.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"string", "javaType": "java.lang.String", "secret": false },
- { "name": "camel.management.devConsoleEnabled", "required": false,
"description": "Whether to enable developer console (not intended for
production use). Dev console must also be enabled on CamelContext. For example
by setting camel.context.dev-console=true in application.properties, or via
code camelContext.setDevConsole(true); If enabled then you can access a basic
developer console on context-path: \/q\/dev.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationP [...]
+ { "name": "camel.management.devConsoleEnabled", "required": false,
"description": "Whether to enable developer console (not intended for
production use). Dev console must also be enabled on CamelContext. For example
by setting camel.context.dev-console=true in application.properties, or via
code camelContext.setDevConsole(true);. If enabled then you can access a basic
developer console on context-path: \/q\/dev.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfiguration [...]
{ "name": "camel.management.downloadEnabled", "required": false,
"description": "Whether to enable file download via HTTP. This makes it
possible to browse and download resource source files such as Camel XML or YAML
routes. Only enable this for development, troubleshooting or special situations
for management and monitoring.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": [...]
{ "name": "camel.management.enabled", "required": false, "description":
"Whether embedded HTTP server is enabled. By default, the server is not
enabled.", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
{ "name": "camel.management.healthCheckEnabled", "required": false,
"description": "Whether to enable health-check console. If enabled then you can
access health-check status on context-path: \/observe\/health", "sourceType":
"org.apache.camel.main.HttpManagementServerConfigurationProperties", "type":
"boolean", "javaType": "boolean", "defaultValue": false, "secret": false },
diff --git a/core/camel-main/src/main/docs/main.adoc
b/core/camel-main/src/main/docs/main.adoc
index 31c90b5a4821..605a3615d15f 100644
--- a/core/camel-main/src/main/docs/main.adoc
+++ b/core/camel-main/src/main/docs/main.adoc
@@ -26,9 +26,9 @@ The camel.main supports 132 options, which are listed below.
| Name | Description | Default | Type
| `camel.main.additionalSensitiveKeywords` | Camel comes with a default set of
sensitive keywords which are automatically masked. This option allows to add
additional custom keywords to be masked as well. Multiple keywords can be
separated by comma. | | String
| `camel.main.allowUseOriginalMessage` | Sets whether to allow access to the
original message from Camel's error handler, or from
org.apache.camel.spi.UnitOfWork.getOriginalInMessage(). Turning this off can
optimize performance, as defensive copy of the original message is not needed.
Default is false. | false | boolean
-| `camel.main.autoConfigurationEnabled` | Whether auto configuration of
components, dataformats, languages is enabled or not. When enabled the
configuration parameters are loaded from the properties component. You can
prefix the parameters in the properties file with: -
camel.component.name.option1=value1 - camel.component.name.option2=value2 -
camel.dataformat.name.option1=value1 - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=va [...]
+| `camel.main.autoConfigurationEnabled` | Whether auto configuration of
components, dataformats, languages is enabled or not. When enabled the
configuration parameters are loaded from the properties component. You can
prefix the parameters in the properties file with: -
camel.component.name.option1=value1 - camel.component.name.option2=value2 -
camel.dataformat.name.option1=value1 - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=va [...]
| `camel.main.autoConfigurationEnvironmentVariablesEnabled` | Whether auto
configuration should include OS environment variables as well. When enabled
this allows to overrule any configuration using an OS environment variable. For
example to set a shutdown timeout of 5 seconds: CAMEL_MAIN_SHUTDOWNTIMEOUT=5.
This option is default enabled. | true | boolean
-| `camel.main.autoConfigurationFailFast` | Whether auto configuration should
fail fast when configuring one or more properties fails for whatever reason
such as a invalid property name, etc. This option is default enabled. | true |
boolean
+| `camel.main.autoConfigurationFailFast` | Whether auto configuration should
fail fast when configuring one or more properties fails for whatever reason
such as an invalid property name, etc. This option is default enabled. | true |
boolean
| `camel.main.autoConfigurationLogSummary` | Whether auto configuration should
log a summary with the configured properties. This option is default enabled. |
true | boolean
| `camel.main.autoConfigurationSystemPropertiesEnabled` | Whether auto
configuration should include JVM system properties as well. When enabled this
allows to overrule any configuration using a JVM system property. For example
to set a shutdown timeout of 5 seconds: -D camel.main.shutdown-timeout=5. Note
that JVM system properties take precedence over OS environment variables. This
option is default enabled. | true | boolean
| `camel.main.autoStartup` | Sets whether the object should automatically
start when Camel starts. Important: Currently only routes can be disabled, as
CamelContext's are always started. Note: When setting auto startup false on
CamelContext then that takes precedence and no routes are started. You would
need to start CamelContext explicit using the
org.apache.camel.CamelContext.start() method, to start the context, and then
you would need to start the routes manually using CamelContext.g [...]
@@ -62,7 +62,7 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.durationMaxIdleSeconds` | To specify for how long time in
seconds Camel can be idle before automatic terminating the JVM. You can use
this to run Camel for a short while. | | int
| `camel.main.durationMaxMessages` | To specify how many messages to process
by Camel before automatic terminating the JVM. You can use this to run Camel
for a short while. | | int
| `camel.main.durationMaxSeconds` | To specify for how long time in seconds to
keep running the JVM before automatic terminating the JVM. You can use this to
run Camel for a short while. | | int
-| `camel.main.endpointBridgeErrorHandler` | 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. 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. The default
value is false. | false | boolean
+| `camel.main.endpointBridgeErrorHandler` | Allows for bridging the consumer
to the Camel routing Error Handler, which means 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. 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. The default
value is false. | false | boolean
| `camel.main.endpointLazyStartProducer` | Whether the producer should be
started lazy (on the first message). By starting lazy you can use this to allow
CamelContext and routes to startup in situations where a producer may otherwise
fail during starting and cause the route to fail being started. By deferring
this startup to be lazy then the startup failure can be handled during routing
messages via Camel's routing error handlers. Beware that when the first message
is processed then crea [...]
| `camel.main.endpointRuntimeStatisticsEnabled` | Sets whether endpoint
runtime statistics is enabled (gathers runtime usage of each incoming and
outgoing endpoints). The default value is false. | false | boolean
| `camel.main.exchangeFactory` | Controls whether to pool (reuse) exchanges or
create new exchanges (prototype). Using pooled will reduce JVM garbage
collection overhead by avoiding to re-create Exchange instances per message
each consumer receives. The default is prototype mode. | default | String
@@ -85,12 +85,12 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.jmxUpdateRouteEnabled` | Whether to allow updating routes at
runtime via JMX using the ManagedRouteMBean. This is disabled by default, but
can be enabled for development and troubleshooting purposes, such as updating
routes in an existing running Camel via JMX and other tools. | false | boolean
| `camel.main.loadHealthChecks` | Whether to load custom health checks by
scanning classpath. | false | boolean
| `camel.main.loadStatisticsEnabled` | Sets whether Camel load (inflight
messages, not cpu) statistics is enabled (something like the unix load
average). The statistics requires to have camel-management on the classpath as
JMX is required. The default value is false. | false | boolean
-| `camel.main.loadTypeConverters` | Whether to load custom type converters by
scanning classpath. This is used for backwards compatibility with Camel 2.x.
Its recommended to migrate to use fast type converter loading by setting
Converter(loader = true) on your custom type converter classes. | false |
boolean
+| `camel.main.loadTypeConverters` | Whether to load custom type converters by
scanning classpath. This is used for backwards compatibility with Camel 2.x.
It's recommended to migrate to use fast type converter loading by setting
Converter(loader = true) on your custom type converter classes. | false |
boolean
| `camel.main.logDebugMaxChars` | Is used to limit the maximum length of the
logging Camel message bodies. If the message body is longer than the limit, the
log message is clipped. Use -1 to have unlimited length. Use for example 1000
to log at most 1000 characters. | | int
| `camel.main.logExhaustedMessageBody` | Sets whether to log exhausted message
body with message history. Default is false. | false | boolean
| `camel.main.logLanguage` | To configure the language to use for Log EIP. By
default, the simple language is used. However, Camel also supports other
languages such as groovy. | | String
| `camel.main.logMask` | Sets whether log mask is enabled or not. Default is
false. | false | boolean
-| `camel.main.logName` | The global name to use for Log EIP The name is
default the routeId or the source:line if source location is enabled. You can
also specify the name using tokens: $\{class} - the logger class name
(org.apache.camel.processor.LogProcessor) $\{contextId} - the camel context id
$\{routeId} - the route id $\{groupId} - the route group id $\{nodeId} - the
node id $\{nodePrefixId} - the node prefix id $\{source} - the source:line
(source location must be enabled) ${sourc [...]
+| `camel.main.logName` | The global name to use for Log EIP. The name is by
default the routeId or the source:line if source location is enabled. You can
also specify the name using tokens: $\{class} - the logger class name
(org.apache.camel.processor.LogProcessor) $\{contextId} - the camel context id
$\{routeId} - the route id $\{groupId} - the route group id $\{nodeId} - the
node id $\{nodePrefixId} - the node prefix id $\{source} - the source:line
(source location must be enabled) ${s [...]
| `camel.main.mainListenerClasses` | Sets classes names that will be used for
MainListener that makes it possible to do custom logic during starting and
stopping camel-main. | | String
| `camel.main.mainListeners` | Sets main listener objects that will be used
for MainListener that makes it possible to do custom logic during starting and
stopping camel-main. | | List
| `camel.main.mdcLoggingKeysPattern` | Sets the pattern used for determine
which custom MDC keys to propagate during message routing when the routing
engine continues routing asynchronously for the given message. Setting this
pattern to * will propagate all custom keys. Or setting the pattern to
foo*,bar* will propagate any keys starting with either foo or bar. Notice that
a set of standard Camel MDC keys are always propagated which starts with camel.
as key name. The match rules are app [...]
@@ -112,7 +112,7 @@ The camel.main supports 132 options, which are listed below.
| `camel.main.routesReloadDirectoryRecursive` | Whether the directory to scan
should include sub directories. Depending on the number of sub directories,
then this can cause the JVM to startup slower as Camel uses the JDK file-watch
service to scan for file changes. | false | boolean
| `camel.main.routesReloadEnabled` | Used for enabling automatic routes
reloading. If enabled then Camel will watch for file changes in the given
reload directory, and trigger reloading routes if files are changed. | false |
boolean
| `camel.main.routesReloadInterval` | How often to scan the reload directory
for changed files, in millis. A change is reloaded at the next scan, so a
shorter interval reloads it sooner. A longer interval groups more of one save
together: two files saved a second apart are one change at 2000 and two at
1000. | 2000 | long
-| `camel.main.routesReloadPattern` | Used for inclusive filtering of routes
from directories. Typical used for specifying to accept routes in XML or YAML
files, such as *.yaml,*.xml. Multiple patterns can be specified separated by
comma. | | String
+| `camel.main.routesReloadPattern` | Used for inclusive filtering of routes
from directories. Typically used for specifying to accept routes in XML or YAML
files, such as *.yaml,*.xml. Multiple patterns can be specified separated by
comma. | | String
| `camel.main.routesReloadRemoveAllRoutes` | When reloading routes should all
existing routes be stopped and removed. By default, Camel will stop and remove
all existing routes before reloading routes. This ensures that only the
reloaded routes will be active. If disabled then only routes with the same
route id is updated, and any existing routes are continued to run. | true |
boolean
| `camel.main.routesReloadRestartDuration` | Whether to restart max duration
when routes are reloaded. For example if max duration is 60 seconds, and a
route is reloaded after 25 seconds, then this will restart the count and wait
60 seconds again. | false | boolean
| `camel.main.shutdownLogInflightExchangesOnTimeout` | Sets whether to log
information about the inflight Exchanges which are still running during a
shutdown which didn't complete without the given timeout. This requires to
enable the option inflightRepositoryBrowseEnabled. | true | boolean
@@ -256,7 +256,7 @@ The camel.management supports 31 options, which are listed
below.
| `camel.management.authenticationPath` | Set HTTP url path of embedded server
that is protected by authentication configuration. | | String
| `camel.management.authenticationRealm` | Sets the authentication realm | |
String
| `camel.management.basicPropertiesFile` | Name of the file that contains
basic authentication info for Vert.x file auth provider. | | String
-| `camel.management.devConsoleEnabled` | Whether to enable developer console
(not intended for production use). Dev console must also be enabled on
CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code camelContext.setDevConsole(true); If
enabled then you can access a basic developer console on context-path: /q/dev.
| false | boolean
+| `camel.management.devConsoleEnabled` | Whether to enable developer console
(not intended for production use). Dev console must also be enabled on
CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code camelContext.setDevConsole(true);. If
enabled then you can access a basic developer console on context-path: /q/dev.
| false | boolean
| `camel.management.downloadEnabled` | Whether to enable file download via
HTTP. This makes it possible to browse and download resource source files such
as Camel XML or YAML routes. Only enable this for development, troubleshooting
or special situations for management and monitoring. | false | boolean
| `camel.management.enabled` | Whether embedded HTTP server is enabled. By
default, the server is not enabled. | false | boolean
| `camel.management.healthCheckEnabled` | Whether to enable health-check
console. If enabled then you can access health-check status on context-path:
/observe/health | false | boolean
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/BaseMainSupport.java
b/core/camel-main/src/main/java/org/apache/camel/main/BaseMainSupport.java
index c969b30e0f61..a80036f9b1e0 100644
--- a/core/camel-main/src/main/java/org/apache/camel/main/BaseMainSupport.java
+++ b/core/camel-main/src/main/java/org/apache/camel/main/BaseMainSupport.java
@@ -231,7 +231,7 @@ public abstract class BaseMainSupport extends BaseService {
/**
* Set the default location for application properties if no locations
have been set. If the value is set to "false"
* or empty, the default location is not taken into account.
- * <p/>
+ * <p>
* Default value is "classpath:application.properties;optional=true".
*/
public void setDefaultPropertyPlaceholderLocation(String
defaultPropertyPlaceholderLocation) {
@@ -2867,11 +2867,11 @@ public abstract class BaseMainSupport extends
BaseService {
}
/**
- * Creates a bean declared as <tt>#class:</tt> whose class has no public
no-arg constructor but a builder (such as a
- * LangChain4j model or a Lombok class), by setting the properties of the
bean (dot style) on the builder before the
- * bean is built, as such a bean cannot be configured after it is created.
+ * Creates a bean declared as <code>#class:</code> whose class has no
public no-arg constructor but a builder (such
+ * as a LangChain4j model or a Lombok class), by setting the properties of
the bean (dot style) on the builder
+ * before the bean is built, as such a bean cannot be configured after it
is created.
*
- * @return the created bean, or <tt>null</tt> if the bean is not created
via an inferred builder
+ * @return the created bean, or <code>null</code> if the bean is not
created via an inferred builder
*/
private static Object createBeanViaInferredBuilder(
CamelContext camelContext, String name, Object value,
OrderedLocationProperties properties,
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationConfigurer.java
b/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationConfigurer.java
index b183dc4d7471..29f389513b65 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationConfigurer.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationConfigurer.java
@@ -432,7 +432,7 @@ public final class DefaultConfigurationConfigurer {
/**
* Performs additional configuration to lookup beans of Camel types to
configure additional configurations on the
* Camel context.
- * <p/>
+ * <p>
* Similar code in camel-core-xml module in class
org.apache.camel.core.xml.AbstractCamelContextFactoryBean.
*/
public static void afterConfigure(final CamelContext camelContext) throws
Exception {
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationProperties.java
b/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationProperties.java
index 5eeea07222d8..a9aaeef62f8b 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationProperties.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/DefaultConfigurationProperties.java
@@ -446,8 +446,8 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Whether to load custom type converters by scanning classpath. This is
used for backwards compatibility with Camel
- * 2.x. Its recommended to migrate to use fast type converter loading by
setting <tt>@Converter(loader = true)</tt>
- * on your custom type converter classes.
+ * 2.x. It's recommended to migrate to use fast type converter loading by
setting
+ * <code>@Converter(loader = true)</code> on your custom type converter
classes.
*/
public void setLoadTypeConverters(boolean loadTypeConverters) {
this.loadTypeConverters = loadTypeConverters;
@@ -852,21 +852,21 @@ public abstract class DefaultConfigurationProperties<T> {
}
/**
- * The global name to use for Log EIP
+ * The global name to use for Log EIP.
*
- * The name is default the routeId or the source:line if source location
is enabled. You can also specify the name
- * using tokens:
+ * The name is by default the routeId or the source:line if source
location is enabled. You can also specify the
+ * name using tokens:
*
- * <br/>
- * ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) <br/>
- * ${contextId} - the camel context id <br/>
- * ${routeId} - the route id <br/>
- * ${groupId} - the route group id <br/>
- * ${nodeId} - the node id <br/>
- * ${nodePrefixId} - the node prefix id <br/>
- * ${source} - the source:line (source location must be enabled) <br/>
- * ${source.name} - the source filename (source location must be enabled)
<br/>
- * ${source.line} - the source line number (source location must be
enabled)
+ * <br>
+ * ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) <br>
+ * ${contextId} - the camel context id <br>
+ * ${routeId} - the route id <br>
+ * ${groupId} - the route group id <br>
+ * ${nodeId} - the node id <br>
+ * ${nodePrefixId} - the node prefix id <br>
+ * ${source} - the source:line (source location must be enabled) <br>
+ * ${source.name} - the source filename (source location must be enabled)
<br>
+ * ${source.line} - the source line number (source location must be
enabled).
*
* For example to use the route and node id you can specify the name as:
${routeId}/${nodeId}
*/
@@ -1031,10 +1031,10 @@ public abstract class DefaultConfigurationProperties<T>
{
}
/**
- * 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.
- * <p/>
+ * Allows for bridging the consumer to the Camel routing Error Handler,
which means 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.
+ * <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.
*
@@ -1466,7 +1466,7 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Used for inclusive filtering of routes from directories.
*
- * Typical used for specifying to accept routes in XML or YAML files, such
as <tt>*.yaml,*.xml</tt>. Multiple
+ * Typically used for specifying to accept routes in XML or YAML files,
such as <code>*.yaml,*.xml</code>. Multiple
* patterns can be specified separated by comma.
*/
public void setRoutesReloadPattern(String routesReloadPattern) {
@@ -1721,7 +1721,7 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Sets global options that can be referenced in the camel context
- * <p/>
+ * <p>
* <b>Important:</b> This has nothing to do with property placeholders,
and is just a plain set of key/value pairs
* which are used to configure global options on CamelContext, such as a
maximum debug logging length etc.
*/
@@ -1730,8 +1730,8 @@ public abstract class DefaultConfigurationProperties<T> {
}
/**
- * Adds a global options that can be referenced in the camel context
- * <p/>
+ * Adds global options that can be referenced in the camel context
+ * <p>
* <b>Important:</b> This has nothing to do with property placeholders,
and is just a plain set of key/value pairs
* which are used to configure global options on CamelContext, such as a
maximum debug logging length etc.
*/
@@ -2030,8 +2030,8 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Whether to load custom type converters by scanning classpath. This is
used for backwards compatibility with Camel
- * 2.x. Its recommended to migrate to use fast type converter loading by
setting <tt>@Converter(loader = true)</tt>
- * on your custom type converter classes.
+ * 2.x. It's recommended to migrate to use fast type converter loading by
setting
+ * <code>@Converter(loader = true)</code> on your custom type converter
classes.
*/
public T withLoadTypeConverters(boolean loadTypeConverters) {
this.loadTypeConverters = loadTypeConverters;
@@ -2322,21 +2322,21 @@ public abstract class DefaultConfigurationProperties<T>
{
}
/**
- * The global name to use for Log EIP
+ * The global name to use for Log EIP.
*
- * The name is default the routeId or the source:line if source location
is enabled. You can also specify the name
- * using tokens:
+ * The name is by default the routeId or the source:line if source
location is enabled. You can also specify the
+ * name using tokens:
*
- * <br/>
- * ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) <br/>
- * ${contextId} - the camel context id <br/>
- * ${routeId} - the route id <br/>
- * ${groupId} - the route group id <br/>
- * ${nodeId} - the node id <br/>
- * ${nodePrefixId} - the node prefix id <br/>
- * ${source} - the source:line (source location must be enabled) <br/>
- * ${source.name} - the source filename (source location must be enabled)
<br/>
- * ${source.line} - the source line number (source location must be
enabled)
+ * <br>
+ * ${class} - the logger class name
(org.apache.camel.processor.LogProcessor) <br>
+ * ${contextId} - the camel context id <br>
+ * ${routeId} - the route id <br>
+ * ${groupId} - the route group id <br>
+ * ${nodeId} - the node id <br>
+ * ${nodePrefixId} - the node prefix id <br>
+ * ${source} - the source:line (source location must be enabled) <br>
+ * ${source.name} - the source filename (source location must be enabled)
<br>
+ * ${source.line} - the source line number (source location must be
enabled).
*
* For example to use the route and node id you can specify the name as:
${routeId}/${nodeId}
*/
@@ -2454,10 +2454,10 @@ public abstract class DefaultConfigurationProperties<T>
{
}
/**
- * 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.
- * <p/>
+ * Allows for bridging the consumer to the Camel routing Error Handler,
which means 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.
+ * <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.
*
@@ -2819,8 +2819,8 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Used for inclusive filtering of routes from directories.
*
- * Typical used for specifying to accept routes in XML or YAML files. The
default pattern is <tt>*.yaml,*.xml</tt>
- * Multiple patterns can be specified separated by comma.
+ * Typically used for specifying to accept routes in XML or YAML files.
The default pattern is
+ * <code>*.yaml,*.xml</code>. Multiple patterns can be specified separated
by comma.
*/
public T withRoutesReloadPattern(String routesReloadPattern) {
this.routesReloadPattern = routesReloadPattern;
@@ -2973,7 +2973,7 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Sets global options that can be referenced in the camel context
- * <p/>
+ * <p>
* <b>Important:</b> This has nothing to do with property placeholders,
and is just a plain set of key/value pairs
* which are used to configure global options on CamelContext, such as a
maximum debug logging length etc.
*/
@@ -2987,7 +2987,7 @@ public abstract class DefaultConfigurationProperties<T> {
/**
* Sets global options that can be referenced in the camel context
- * <p/>
+ * <p>
* <b>Important:</b> This has nothing to do with property placeholders,
and is just a plain set of key/value pairs
* which are used to configure global options on CamelContext, such as a
maximum debug logging length etc.
*/
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/HttpManagementServerConfigurationProperties.java
b/core/camel-main/src/main/java/org/apache/camel/main/HttpManagementServerConfigurationProperties.java
index 19ff8fa6af66..801a3deb2a9c 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/HttpManagementServerConfigurationProperties.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/HttpManagementServerConfigurationProperties.java
@@ -179,7 +179,7 @@ public class HttpManagementServerConfigurationProperties
implements BootstrapClo
/**
* Whether to enable developer console (not intended for production use).
Dev console must also be enabled on
* CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code
- * <tt>camelContext.setDevConsole(true);</tt> If enabled then you can
access a basic developer console on
+ * <code>camelContext.setDevConsole(true);</code>. If enabled then you can
access a basic developer console on
* context-path: /q/dev.
*/
public void setDevConsoleEnabled(boolean devConsoleEnabled) {
@@ -498,7 +498,7 @@ public class HttpManagementServerConfigurationProperties
implements BootstrapClo
/**
* Whether to enable developer console (not intended for production use).
Dev console must also be enabled on
* CamelContext. For example by setting camel.context.dev-console=true in
application.properties, or via code
- * <tt>camelContext.setDevConsole(true);</tt> If enabled then you can
access a basic developer console on
+ * <code>camelContext.setDevConsole(true);</code>. If enabled then you can
access a basic developer console on
* context-path: /observe/dev.
*/
public HttpManagementServerConfigurationProperties
withDevConsoleEnabled(boolean devConsoleEnabled) {
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/LoggedStartupFailure.java
b/core/camel-main/src/main/java/org/apache/camel/main/LoggedStartupFailure.java
index 3058f5c4f9f5..c1c34f795308 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/LoggedStartupFailure.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/LoggedStartupFailure.java
@@ -21,7 +21,7 @@ package org.apache.camel.main;
* logged: the JVM does not print that failure a second time when it leaves
main, also not when a launcher wraps it (the
* launcher of a fat jar calls main by reflection, and wraps the failure in an
InvocationTargetException). Any other
* exception goes to the handler the thread had before, which prints it as the
JVM does.
- * <p/>
+ * <p>
* Spring Boot does the same for an application that fails to start.
*/
final class LoggedStartupFailure implements Thread.UncaughtExceptionHandler {
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/MainConfigurationProperties.java
b/core/camel-main/src/main/java/org/apache/camel/main/MainConfigurationProperties.java
index 33568b57b88b..fb5c221948b7 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/MainConfigurationProperties.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/MainConfigurationProperties.java
@@ -586,14 +586,14 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* configuration parameters are loaded from the properties component. You
can prefix the parameters in the
* properties file with: - camel.component.name.option1=value1 -
camel.component.name.option2=value2 -
* camel.dataformat.name.option1=value1 -
camel.dataformat.name.option2=value2 - camel.language.name.option1=value1
- * - camel.language.name.option2=value2 Where name is the name of the
component, dataformat or language such as
+ * - camel.language.name.option2=value2, where name is the name of the
component, dataformat or language such as
* seda,direct,jaxb.
- * <p/>
- * The auto configuration also works for any options on components that is
a complex type (not standard Java type)
+ * <p>
+ * The auto configuration also works for any options on components that
are a complex type (not standard Java type)
* and there has been an explicit single bean instance registered to the
Camel registry via the
* {@link org.apache.camel.spi.Registry#bind(String, Object)} method or by
using the
* {@link org.apache.camel.BindToRegistry} annotation style.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public void setAutoConfigurationEnabled(boolean autoConfigurationEnabled) {
@@ -608,7 +608,7 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* Whether auto configuration should include OS environment variables as
well. When enabled this allows to overrule
* any configuration using an OS environment variable. For example to set
a shutdown timeout of 5 seconds:
* CAMEL_MAIN_SHUTDOWNTIMEOUT=5.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public void setAutoConfigurationEnvironmentVariablesEnabled(boolean
autoConfigurationEnvironmentVariablesEnabled) {
@@ -623,9 +623,9 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* Whether auto configuration should include JVM system properties as
well. When enabled this allows to overrule any
* configuration using a JVM system property. For example to set a
shutdown timeout of 5 seconds: -D
* camel.main.shutdown-timeout=5.
- * <p/>
+ * <p>
* Note that JVM system properties take precedence over OS environment
variables.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public void setAutoConfigurationSystemPropertiesEnabled(boolean
autoConfigurationSystemPropertiesEnabled) {
@@ -638,8 +638,8 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
/**
* Whether auto configuration should fail fast when configuring one or
more properties fails for whatever reason
- * such as a invalid property name, etc.
- * <p/>
+ * such as an invalid property name, etc.
+ * <p>
* This option is default enabled.
*/
public void setAutoConfigurationFailFast(boolean
autoConfigurationFailFast) {
@@ -652,7 +652,7 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
/**
* Whether auto configuration should log a summary with the configured
properties.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public void setAutoConfigurationLogSummary(boolean
autoConfigurationLogSummary) {
@@ -911,14 +911,14 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* parameters are loaded from the properties component and configured as
defaults (similar to spring-boot
* auto-configuration). You can prefix the parameters in the properties
file with: -
* camel.component.name.option1=value1 -
camel.component.name.option2=value2 - camel.dataformat.name.option1=value1
- * - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=value2
- * Where name is the name of the component, dataformat or language such as
seda,direct,jaxb.
- * <p/>
- * The auto configuration also works for any options on components that is
a complex type (not standard Java type)
+ * - camel.dataformat.name.option2=value2 -
camel.language.name.option1=value1 - camel.language.name.option2=value2,
+ * where name is the name of the component, dataformat or language such as
seda,direct,jaxb.
+ * <p>
+ * The auto configuration also works for any options on components that
are a complex type (not standard Java type)
* and there has been an explicit single bean instance registered to the
Camel registry via the
* {@link org.apache.camel.spi.Registry#bind(String, Object)} method or by
using the
* {@link org.apache.camel.BindToRegistry} annotation style.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public MainConfigurationProperties withAutoConfigurationEnabled(boolean
autoConfigurationEnabled) {
@@ -930,7 +930,7 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* Whether auto configuration should include OS environment variables as
well. When enabled this allows to overrule
* any configuration using an OS environment variable. For example to set
a shutdown timeout of 5 seconds:
* CAMEL_MAIN_SHUTDOWNTIMEOUT=5.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public MainConfigurationProperties
withAutoConfigurationEnvironmentVariablesEnabled(
@@ -943,9 +943,9 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
* Whether auto configuration should include JVM system properties as
well. When enabled this allows to overrule any
* configuration using a JVM system property. For example to set a
shutdown timeout of 5 seconds: -D
* camel.main.shutdown-timeout=5.
- * <p/>
+ * <p>
* Note that JVM system properties take precedence over OS environment
variables.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public MainConfigurationProperties
withAutoConfigurationSystemPropertiesEnabled(
@@ -956,8 +956,8 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
/**
* Whether auto configuration should fail fast when configuring one or
more properties fails for whatever reason
- * such as a invalid property name, etc.
- * <p/>
+ * such as an invalid property name, etc.
+ * <p>
* This option is default enabled.
*/
public MainConfigurationProperties withAutoConfigurationFailFast(boolean
autoConfigurationFailFast) {
@@ -967,7 +967,7 @@ public class MainConfigurationProperties extends
DefaultConfigurationProperties<
/**
* Whether auto configuration should log a summary with the configured
properties.
- * <p/>
+ * <p>
* This option is default enabled.
*/
public MainConfigurationProperties withAutoConfigurationLogSummary(boolean
autoConfigurationLogSummary) {
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/MainHelper.java
b/core/camel-main/src/main/java/org/apache/camel/main/MainHelper.java
index e26a00a1185f..b2b8f73096df 100644
--- a/core/camel-main/src/main/java/org/apache/camel/main/MainHelper.java
+++ b/core/camel-main/src/main/java/org/apache/camel/main/MainHelper.java
@@ -544,10 +544,9 @@ public final class MainHelper {
}
/**
- * Loads the entire stream into memory as a String and returns it.
- * <p/>
- * <b>Notice:</b> This implementation appends a <tt>\n</tt> as line
terminator at the of the text.
- * <p/>
+ * Loads the entire stream into memory and puts each line into the given
map, with the key computed by the given
+ * function.
+ * <p>
* Warning, don't use for crazy big streams :)
*/
private static void loadLines(
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/MainSupport.java
b/core/camel-main/src/main/java/org/apache/camel/main/MainSupport.java
index 92fdc508ce68..6b8eb3e9ca19 100644
--- a/core/camel-main/src/main/java/org/apache/camel/main/MainSupport.java
+++ b/core/camel-main/src/main/java/org/apache/camel/main/MainSupport.java
@@ -124,7 +124,7 @@ public abstract class MainSupport extends BaseMainSupport {
/**
* Callback to run custom logic before CamelContext is being started.
- * <p/>
+ * <p>
* It is recommended to use {@link org.apache.camel.main.MainListener}
instead.
*/
protected void beforeStart() throws Exception {
@@ -135,7 +135,7 @@ public abstract class MainSupport extends BaseMainSupport {
/**
* Callback to run custom logic after CamelContext has been started.
- * <p/>
+ * <p>
* It is recommended to use {@link org.apache.camel.main.MainListener}
instead.
*/
protected void afterStart() throws Exception {
@@ -161,7 +161,7 @@ public abstract class MainSupport extends BaseMainSupport {
/**
* Callback to run custom logic before CamelContext is being stopped.
- * <p/>
+ * <p>
* It is recommended to use {@link org.apache.camel.main.MainListener}
instead.
*/
protected void beforeStop() throws Exception {
@@ -172,7 +172,7 @@ public abstract class MainSupport extends BaseMainSupport {
/**
* Callback to run custom logic after CamelContext has been stopped.
- * <p/>
+ * <p>
* It is recommended to use {@link org.apache.camel.main.MainListener}
instead.
*/
protected void afterStop() throws Exception {
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/RestConfigurationProperties.java
b/core/camel-main/src/main/java/org/apache/camel/main/RestConfigurationProperties.java
index 2e2c222c7569..c88615069d79 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/RestConfigurationProperties.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/RestConfigurationProperties.java
@@ -87,7 +87,7 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* The scheme to use for exposing the REST service. Usually http or https
is supported.
- * <p/>
+ * <p>
* The default value is http
*/
public RestConfigurationProperties withScheme(String scheme) {
@@ -105,7 +105,7 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* To use a specific hostname for the API documentation (such as swagger
or openapi)
- * <p/>
+ * <p>
* This can be used to override the generated host with this configured
hostname
*/
public RestConfigurationProperties withApiHost(String apiHost) {
@@ -140,11 +140,11 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* Sets the location of the api document (swagger api) the REST producer
will use to validate the REST uri and query
- * parameters are valid accordingly to the api document. This requires
adding camel-openapi-java to the classpath,
- * and any miss configuration will let Camel fail on startup and report
the error(s).
- * <p/>
- * The location of the api document is loaded from classpath by default,
but you can use <tt>file:</tt> or
- * <tt>http:</tt> to refer to resources to load from file or http url.
+ * parameters are valid according to the api document. This requires
adding camel-openapi-java to the classpath, and
+ * any misconfiguration will let Camel fail on startup and report the
error(s).
+ * <p>
+ * The location of the api document is loaded from classpath by default,
but you can use <code>file:</code> or
+ * <code>http:</code> to refer to resources to load from file or http url.
*/
public RestConfigurationProperties withProducerApiDoc(String
producerApiDoc) {
setProducerApiDoc(producerApiDoc);
@@ -153,10 +153,10 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* Sets a leading context-path the REST services will be using.
- * <p/>
- * This can be used when using components such as <tt>camel-servlet</tt>
where the deployed web application is
- * deployed using a context-path. Or for components such as
<tt>camel-jetty</tt> or <tt>camel-netty-http</tt> that
- * includes a HTTP server.
+ * <p>
+ * This can be used when using components such as
<code>camel-servlet</code> where the deployed web application is
+ * deployed using a context-path. Or for components such as
<code>camel-jetty</code> or
+ * <code>camel-netty-http</code> that include an HTTP server.
*/
public RestConfigurationProperties withContextPath(String contextPath) {
setContextPath(contextPath);
@@ -164,12 +164,12 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
}
/**
- * The path, such as <tt>/api-doc</tt>, where the REST DSL serves the API
documentation of the REST services, as an
- * OpenAPI document.
- * <p/>
- * The API documentation is only served when this option is set. This
requires <tt>camel-openapi-java</tt> on the
- * classpath. The document is JSON by default, or YAML when the request
path ends with <tt>.yaml</tt>. The path is
- * relative to contextPath, when that option is set.
+ * The path, such as <code>/api-doc</code>, where the REST DSL serves the
API documentation of the REST services, as
+ * an OpenAPI document.
+ * <p>
+ * The API documentation is only served when this option is set. This
requires <code>camel-openapi-java</code> on
+ * the classpath. The document is JSON by default, or YAML when the
request path ends with <code>.yaml</code>. The
+ * path is relative to contextPath, when that option is set.
*/
public RestConfigurationProperties withApiContextPath(String
apiContextPath) {
setApiContextPath(apiContextPath);
@@ -178,7 +178,7 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* Sets the route id to use for the route that services the REST API.
- * <p/>
+ * <p>
* The route will by default use an auto assigned route id.
*/
public RestConfigurationProperties withApiContextRouteId(String
apiContextRouteId) {
@@ -207,8 +207,8 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* Sets the binding mode to use.
- * <p/>
- * The possible values are: auto, off, json, xml, json_xml The default
value is off
+ * <p>
+ * The possible values are: auto, off, json, xml, json_xml. The default
value is off.
*/
public RestConfigurationProperties withBindingMode(String bindingMode) {
setBindingMode(bindingMode);
@@ -260,7 +260,7 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
/**
* Whether to enable CORS headers in the HTTP response.
- * <p/>
+ * <p>
* The default value is false.
*/
public RestConfigurationProperties withEnableCORS(boolean enableCORS) {
@@ -275,7 +275,7 @@ public class RestConfigurationProperties extends
RestConfiguration implements Bo
* service (rest-dsl, and the route linked from rest-dsl). Enabling this
allows Camel to optimize and inline this as
* a single route, however this requires to use direct endpoints, which
must be unique per service.
*
- * This option is default <tt>false</tt>.
+ * This option is default <code>false</code>.
*/
public RestConfigurationProperties withInlineRoutes(boolean inlineRoutes) {
setInlineRoutes(inlineRoutes);
diff --git
a/core/camel-main/src/main/java/org/apache/camel/main/RouteControllerConfigurationProperties.java
b/core/camel-main/src/main/java/org/apache/camel/main/RouteControllerConfigurationProperties.java
index d74fe311793f..9f0d4f22c96d 100644
---
a/core/camel-main/src/main/java/org/apache/camel/main/RouteControllerConfigurationProperties.java
+++
b/core/camel-main/src/main/java/org/apache/camel/main/RouteControllerConfigurationProperties.java
@@ -92,8 +92,8 @@ public class RouteControllerConfigurationProperties
implements BootstrapCloseabl
*
* The pattern is matching on route id, and endpoint uri for the route.
Multiple patterns can be separated by comma.
*
- * For example to include all kafka routes, you can say <tt>kafka:*</tt>.
And to include routes with specific route
- * ids <tt>myRoute,myOtherRoute</tt>. The pattern supports wildcards and
uses the matcher from
+ * For example to include all kafka routes, you can say
<code>kafka:*</code>. And to include routes with specific
+ * route ids <code>myRoute,myOtherRoute</code>. The pattern supports
wildcards and uses the matcher from
* org.apache.camel.support.PatternHelper#matchPattern.
*/
public void setIncludeRoutes(String includeRoutes) {
@@ -109,8 +109,8 @@ public class RouteControllerConfigurationProperties
implements BootstrapCloseabl
*
* The pattern is matching on route id, and endpoint uri for the route.
Multiple patterns can be separated by comma.
*
- * For example to exclude all JMS routes, you can say <tt>jms:*</tt>. And
to exclude routes with specific route ids
- * <tt>mySpecialRoute,myOtherSpecialRoute</tt>. The pattern supports
wildcards and uses the matcher from
+ * For example to exclude all JMS routes, you can say <code>jms:*</code>.
And to exclude routes with specific route
+ * ids <code>mySpecialRoute,myOtherSpecialRoute</code>. The pattern
supports wildcards and uses the matcher from
* org.apache.camel.support.PatternHelper#matchPattern.
*/
public void setExcludeRoutes(String excludeRoutes) {
@@ -307,8 +307,8 @@ public class RouteControllerConfigurationProperties
implements BootstrapCloseabl
*
* The pattern is matching on route id, and endpoint uri for the route.
Multiple patterns can be separated by comma.
*
- * For example to include all kafka routes, you can say <tt>kafka:*</tt>.
And to include routes with specific route
- * ids <tt>myRoute,myOtherRoute</tt>. The pattern supports wildcards and
uses the matcher from
+ * For example to include all kafka routes, you can say
<code>kafka:*</code>. And to include routes with specific
+ * route ids <code>myRoute,myOtherRoute</code>. The pattern supports
wildcards and uses the matcher from
* org.apache.camel.support.PatternHelper#matchPattern.
*/
public RouteControllerConfigurationProperties withIncludeRoutes(String
includeRoutes) {
@@ -321,8 +321,8 @@ public class RouteControllerConfigurationProperties
implements BootstrapCloseabl
*
* The pattern is matching on route id, and endpoint uri for the route.
Multiple patterns can be separated by comma.
*
- * For example to exclude all JMS routes, you can say <tt>jms:*</tt>. And
to exclude routes with specific route ids
- * <tt>mySpecialRoute,myOtherSpecialRoute</tt>. The pattern supports
wildcards and uses the matcher from
+ * For example to exclude all JMS routes, you can say <code>jms:*</code>.
And to exclude routes with specific route
+ * ids <code>mySpecialRoute,myOtherSpecialRoute</code>. The pattern
supports wildcards and uses the matcher from
* org.apache.camel.support.PatternHelper#matchPattern.
*/
public RouteControllerConfigurationProperties withExcludeRoutes(String
excludeRoutes) {
