The Route icon (Figure 1)
appears in Outline view. It represents an individual route in a routing context file. In
projects consisting of multiple routes, the route icons appear in Outline view in the
order they appear within the camelContext
element of the
routing context file.
In Outline view, select a route's icon to display the route on the canvas and open its Properties editor. This is the easiest way to switch between routes when developing a multiroute project.
Table 112 describes the properties you can specify for a route using the Properties editor.
![]() | Note |
---|---|
Though the Inherit Error Handler property appears in the Properties editor for the route pattern, its use is appropriate with the Load Balance pattern only. |
Table 112. Route Properties
Name | Description |
---|---|
Route Policy Ref | Specifies a reference to a bean that defines and applies a policy that controls routes at runtime. The bean can implement any logic that you want Apache Camel to invoke at route start or at route end. |
Inherit Error Handler | Specifies whether the node should use the error handler configured
for the route. The default is Disabled . Use
this option only with the Load Balance EIP. |
Delayer | Specifies a delay, in milliseconds, that slows down message
processing. This is useful during debugging, making it easier to inspect
the logs while tracking messages. The default is
0 . |
Handle Fault | Specifies whether to convert fault messages into exceptions. Intended
for applications deployed into a JBI container, so the Camel error
handler can react to faults. The default is
Disabled . |
Auto Startup |
Specifies whether to start the route automatically when Camel
starts up. The default is |
Message History | Specifies whether to enable/disable Message History. When enabled,
Apache Camel captures how the exchange is routed as an
org.apache.camel.MessageHistory entity that is
stored on the exchange. This information can be retrieved via Java code
or via the error handler exhausted exceptions logs. For details, see
Apache
Camel: Message History The default is
Enabled . |
Trace | Specifies whether to trace the path of an exchange through a
particular route. The default is
Disabled . |
Stream Cache | Specifies whether to cache streams that otherwise could not be
accessed multiple times. This is necessary for implementing redelivery
during error handling, which requires reading the stream multiple times.
The default is Disabled . |
Group | Specifies the name of a group of which the route is a member. This property is informational only. It is not used by Apache Camel. |
Error Handler Ref | Specifies a reference to a bean that defines and applies an error handler. |
Id | Specifies a unique id for the route. This id appears in the generated XML (Source view) and with the Route icon in Outline view. It also appears in log entries. If left blank, Red Hat JBoss Fuse Tooling for Eclipse assigns the route a default Id. |
Description | Specifies a textual description for the route. This description is included in the generated XML file, but it is informational only. It is not used by Apache Camel. |