How Do I Configure Endpoints?
There are a few different approaches to configuring components and endpoints.
Using Java
You can explicitly configure a Component using Java code as shown in this example
Or you can explicitly get hold of an Endpoint and configure it using Java code as shown in the Mock endpoint examples.
Using CDI
You can use CDI as dependency injection framework to configure your Component or Endpoint instances.
For example, to configure the SJMS component, you can declare a producer method in a CDI bean:
javaThen, the component is lazily looked-up by Camel CDI whenever it is referenced, e.g., from the Camel Java DSL:
javaBesides, endpoints of that component can be injected in any CDI beans, e.g.,
javaUsing Guice
You can also use Guice as the dependency injection framework. For example see the Guice JMS Example.
Using Spring XML
You can configure your Component or Endpoint instances in your Spring XML as follows.activemq:[queue:|topic:]destinationName
. This works by the SpringCamelContext
lazily fetching components from the spring context for the scheme name you use for Endpoint URIs
Using Endpoint URIs
Another approach is to use the URI syntax. The URI syntax supports the query notation. So for example with the Mail component you can configure the password property via the URI
Referencing Beans from Endpoint URIs
From Camel 2.0:
When configuring endpoints using URI syntax you can now refer to beans in the Registry using the #
notation.
If the parameter value starts with a #
sign then Camel will lookup in the Registry for a bean of the given type. For instance:
Will lookup a bean with the id mySpecialFileSorter
in the Registry.
Configuring Parameter Values Using Raw Values, e.g., such as passwords
From Camel 2.11:
When configuring endpoint options using URI syntax, then the values is by default URI encoded. This can be a problem if you want to configure passwords and just use the value as is without any encoding. For example you may have a plus sign in the password, which would be decimal encoded by default.
From Camel 2.11: we made this easier as you can denote a parameter value to be raw using the following syntax RAW(value)
e.g., the value starts with RAW(
and then ends with the parenthesis )
. Here is a little example:
In the above example, we have declare the password value as raw, and the actual password would be as typed, e.g., se+re?t&23
.
Using Property Placeholders
Camel have extensive support for using property placeholders, which you can read more about here. For example in the ftp example above we can externalize the password to a .properties
file.
For example configuring the property placeholder when using a XML DSL, where we declare the location of the .properties file. Though we can also define this in Java code. See the documentation for more details.
xmlAnd the Camel route now refers to the placeholder using the {{ key }} notation:
javaAnd have a myftp.properties
file with password. Notice we still define the RAW(value) style to ensure the password is used as is
We could still have used the RAW(value) in the Camel route instead:
javaAnd then we would need to remove the RAW from the properties file:
To understand more about property placeholders, read the documentation.
Configuring URIs using Endpoint with Bean Property Style
Available as of Camel 2.15
Sometimes configuring endpoint uris may have many options, and therefore the URI can become long. In Java DSL you can break the URIs into new lines as its just Java code, e.g., just concat the String. When using XML DSL then the URI is an attribute, e.g., <from uri="bla bla"/>
. From Camel 2.15: you can configure the endpoint separately, and from the routes refer to the endpoints using their shorthand IDs.
In the example above, the endpoint with id foo, is defined using <endpoint>
which under the covers assembles this as an URI, with all the options, as if you have defined all the options directly in the URI. You can still configure some options in the URI, and then use <property>
style for additional options, or to override options from the URI, such as:
Configuring Long URIs Using New Lines
Available as of Camel 2.15
Sometimes configuring endpoint URIs may have many options, and therefore the URI can become long. In Java DSL you can break the URIs into new lines as its just Java code, e.g., just concat the String. When using XML DSL then the URI is an attribute, e.g., <from uri="bla bla"/>
. From Camel 2.15: you can break the URI attribute using new line, such as shown below:
Notice that it still requires to use escape &
as &
in XML. Also you can have multiple options in one line, e.g., this is the same: