To Add Another Route to the CBR Routing Context

Goals

In this tutorial you will:

reconfigure the existing route for direct connection to a second route
add a second route to your camelContext
configure the new route to take messages directly from the otherwise branch of the first route
add a content-based router to the new route
add and configure a message header, logging, and target destination to each output branch of the new route's content-based router

Prerequisites

To complete this tutorial you will need the CBRroute project you modified in To Add a Content-Based Router.

	Note
	If you skipped any tutorial after To Create a New Route, you can use the prefabricated `blueprint5.xml` file to work through this tutorial (for details, see Using the Fuse Tooling Resource Files).

Reconfiguring the existing route for direct connection

To configure the existing route for direct connection with the new route:

Open your CBRroute/src/main/resources/OSGI-INF/blueprint/blueprint.xml in the route editor.
Select the terminal file node To_Valid to display its properties in the Properties editor.
In the Uri field, delete the existing text, and then enter direct:OrderFulfillment.
In the Id field, enter _Fulfill.

	Note
	Instead of repurposing the existing To_Valid terminal file node, you could have replaced it with a Components > Direct component, configuring it with the same property values as the To_Valid node.

Adding the second route

	Note
	The route editor displays each route in a multiroute routing context in its own Route_ container.

To add a route to the routing context:

In the Palette, open the Routingdrawer and select the Route () pattern.
Drag the Route pattern to the canvas and drop it next to the Route_route1 container:
The Route pattern becomes the Route_route2 container node on the canvas.
Click the Route_route2 container node to display its properties in the Properties editor.
Leave each of the remaining properties as is.

Note

As your multiroute routing context grows in complexity, you may want to focus the route editor on an individual route while you work on it. To do so, in Project Explorer, double-click the route you want the route editor to display on the canvas; for example Route_route2:

To display all routes in the routing context on the canvas, double-click the project's .xml context file entry (src/main/resources/OSGI-INF/...) at the top of the Camel Contexts folder.

Building and configuring the USA branch of the second route

In the Palette, open the Components drawer and drag a Direct component () to the canvas and drop it in the Route_route2 container:
The Route_route2 container expands to accommodate the From_from2 node.
On the canvas, select the From_from2 node to open its properties in the Properties editor:
In the Uri field, replace name (following direct:) with OrderFulfillment, and in the Id field, enter _direct:OrderFulfillment.
In the Palette, open the Routing drawer and drag a Choice () pattern to the canvas and drop it in the Route_route2 container.
The Route_route2 container expands to accommodate the Choice_choice2 node.
In the Route_route2 container, select the direct:OrderFulfillment node and drag its connector arrow over the Choice_choice2 node, then release it:
In the Properties editor, leave each of the remaining properties as is.
In the Palette, open the Routing drawer and drag a When () pattern to the canvas and drop it in the Choice_choice2 container:
The Choice_choice2 container expands to accommodate the When_when2 node.
On the canvas, select the When_when2 node to open its properties in the Properties editor:

Set the node's properties this way:

Select xpath from the Language drop-down menu.
Enter /order/customer/country = 'USA' in the Expression field.
Leave Trim enabled.
Enter _when/usa in the Id field.

	Note
	Once you select the expression Language, the Properties editor displays its properties in an indented list directly below the Language field. The Id property in this list sets the ID of the expression. The Id property following the Description field sets the ID of the When node.

In the Palette, open the Transformation drawer and drag the Set Header pattern to the canvas and drop on the When_when/usa node:
The When_when/usa container expands to accommodate the SetHeader_setHeader3 node.
On the canvas, select the SetHeader_setHeader3 node to open its properties in the Properties editor:
Set the node's properties this way:
- Select constant from the Language drop-down menu.
- Enter USA in the Expression field.
- Leave Trim enabled.
- Enter Destination in the Header Name field.
- Enter _setHead_usa in the Id field.
In the Palette, open the Components drawer and drag a Log component () to the canvas and drop it in the When_when/usa container.
The When_when/usa container expands to accommodate the Log_log3 node.
On the canvas, select the SetHeader_setHead_usa node and drag its connector arrow over the Log_log3 node, then release it:
On the canvas, select the Log_log3 node to open its properties in the Properties editor:
In the Properties editor:
- Enter Valid order - ship animals to USA customer in the Message field.
- Enter _usa in the Id field.
- Leave Logging Level as is.
In the Palette, open the Components drawer and drag a File component () to the canvas and drop it in the When_when/usa container.
The When_when/usa container expands to accommodate the To_to1 node.
On the canvas, select the Log_usa node and drag its connector arrow over the To_to1 node, then release it:
In the Properties editor:
- Replace directoryName with target/messages/USA in the Uri field.
- Enter _US in the Id field.
On the menu bar, click File > Save to save the routing context file.
The USA branch of Route_route2 should look like this:

Building and configuring the Great Britain branch of the second route

With Route_route2 displayed on the canvas:

In the Palette, open the Routing drawer and drag a When pattern () to the canvas and drop it in the Choice_choice2 container:
The Choice_choice2 container expands to accommodate the When_when2 node.
On the canvas, select the When_when2 node to open its properties in the Properties editor.
In the Properties editor:
- Select xpath from the Language drop-down menu.
- Enter /order/customer/country = 'Great Britain' in the Expression field.
- Leave Trim enabled.
- Enter _when/gb in the Id field.
In the Palette, open the Transformation drawer and drag a Set Header pattern () to the canvas and drop it on the When_when/gb node:
The When_when/gb container expands to accommodate the SetHeader_setHeader3 node.
On the canvas, select the SetHeader_setHeader3 node to open its properties in the Properties editor.
In the Properties editor:
- Select constant from the Language drop-down menu.
- Enter UK in the Expression field.
- Leave Trim as is.
- Enter Destination in the Header Name field.
- Enter_setHead_uk in the Id field.
In the Palette, open the Components drawer and drag a Log pattern () to the canvas and drop it in the When_when/gb container.
The When_when/gb container expands to accommodate the Log_log3 node.
On the canvas, select the SetHeader_setHead_uk node and drag its connector arrow over the Log_log3 node, and then release it:
On the canvas, select the Log_log3 node to open its properties in the Properties editor.
In the Properties editor:
- Enter Valid order - ship animals to UK customer in the Message field.
- Enter _uk in the Id field.
- Leave the Logging Level as is.
From the Components drawer, drag a File pattern () to the canvas and drop it in the When_when/gb container.
The When_when/gb container expands to accommodate the To_to1 node.
On the canvas, select the Log_uk node and drag its connector arrow over the To_to1 node, and then release it:
On the canvas, select the To_to1 node to open its properties in the Properties editor.
In the Properties editor:
- Replace directoryName with target/messages/GreatBritain in the Uri field.
- Enter _UK in the Id field.
On the menu bar, click File > Save to save the routing context file.
The Great Britain branch of Route_route2 should look like this:

Building and configuring the Germany branch of the second route

With Route_route2 displayed on the canvas:

In the Palette, open the Routing drawer and drag a When pattern () to the canvas and drop it in the Choice_choice2 container:
The Choice_choice2 container expands to accommodate the When_when2 node.
On the canvas, select the When_when2 node to open its properties in the Properties editor.
In the Properties editor:
- Select xpath from the Language drop-down menu.
- Enter /order/customer/country = 'Germany' in the Expression field.
- Leave Trim enabled.
- Enter _when/ger in the Id field.
In the Palette, open the Transformation drawer and drag a Set Header pattern () to the canvas and drop it on the When_when/ger node:
The When_when/ger container expands to accommodate the SetHeader_setHeader3 node.
On the canvas, select the SetHeader_setHeader3 node to open its properties in the Properties editor.
In the Properties editor:
- Select constant from the Language drop-down menu.
- Enter Germany in the Expression field.
- Leave Trim as is.
- Enter Destination in the Header Name field.
- Enter_setHead_ger in the Id field.
In the Palette, open the Components drawer and drag a Log pattern () to the canvas and drop it in the When_when/ger container.
The When_when/ger container expands to accommodate the Log_log3 node.
On the canvas, select the SetHeader_setHead_ger node and drag its connector arrow over the Log_log3 node, and then release it:
On the canvas, select the Log_log3 node to open its properties in the Properties editor.
In the Properties editor:
- Enter Valid order - ship animals to Germany customer in the Message field.
- Enter _ger in the Id field.
- Leave the Logging Level as is.
From the Components drawer, drag a File pattern () to the canvas and drop it in the When_when/ger container.
The When_when/ger container expands to accommodate the To_to1 node.
On the canvas, select the Log_ger node and drag its connector arrow over the To_to1 node, and then release it:
On the canvas, select the To_to1 node to open its properties in the Properties editor.
In the Properties editor:
- Replace directoryName with target/messages/Germany in the Uri field.
- Enter _GER in the Id field.
On the menu bar, click File > Save to save the routing context file.
The Germany branch of Route_route2 should look like this:

Building and configuring the France branch of the second route

With Route_route2 displayed on the canvas:

In the Palette, open the Routing drawer and drag an Otherwise pattern () to the canvas and drop it in the Choice_choice2 container:
The Choice_choice2 container expands to accommodate the Otherwise_otherwise1 node.
On the canvas, select the Otherwise_otherwise1 node to open its properties in the Properties editor.
In the Properties editor, enter _else/fr in the Id field.
In the Palette, open the Transformation drawer and drag a Set Header pattern () to the canvas and drop it on the Otherwise_else/fr node:
The Otherwise_else/fr container expands to accommodate the SetHeader_setHeader3 node.
On the canvas, select the SetHeader_setHeader3 node to open its properties in the Properties editor.
In the Properties editor:
- Select constant from the Language drop-down menu.
- Enter France in the Expression field.
- Leave Trim as is.
- Enter Destination in the Header Name field.
- Enter_setHead_fr in the Id field.
In the Palette, open the Components drawer and drag a Log pattern () to the canvas and drop it in the Otherwise_else/fr container.
The Otherwise_else/fr container expands to accommodate the Log_log3 node.
On the canvas, select the SetHeader_setHead_fr node and drag its connector arrow over the Log_log3 node, and then release it:
On the canvas, select the Log_log3 node to open its properties in the Properties editor.
In the Properties editor:
- Enter Valid order - ship animals to France customer in the Message field.
- Enter _fr in the Id field.
- Leave the Logging Level as is.
From the Components drawer, drag a File pattern () to the canvas and drop it in the Otherwise_else/fr container.
The Otherwise_else/fr container expands to accommodate the To_to1 node.
On the canvas, select the Log_fr node and drag its connector arrow over the To_to1 node, and then release it:
On the canvas, select the To_to1 node to open its properties in the Properties editor.
In the Properties editor:
- Replace directoryName with target/messages/France in the Uri field.
- Enter _FR in the Id field.
On the menu bar, click File > Save to save the routing context file.
The France branch of Route_route2 should look like this:

Finishing up

If needed, on the menu bar, select File > Save to save the routing context.
The routes on the canvas should look like this:
Figure 2. Completed route1

Figure 3. Completed route2

Click the Source tab at the bottom, left of the canvas to display the XML for the route.

The camelContext element should look like that shown in Example 4:

Example 4. XML for dual-route content-based router

<?xml version="1.0" encoding="UTF-8"?>
  
<blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://www.osgi.org/xmlns/blueprint/v1.0.0            
    https://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd                         
    http://camel.apache.org/schema/blueprint            
    http://camel.apache.org/schema/blueprint/camel-blueprint.xsd">
    
  <camelContext id="_context1" xmlns="http://camel.apache.org/schema/blueprint">
      <route id="_route1">
          <from id="_from1" uri="file:src/data?noop=true"/>
          <choice id="_choice1">
              <when id="_when1">
                  <xpath>/order/orderline/quantity/text() > /order/orderline/maxAllowed/text()</xpath>
                  <log id="_log1" message="quantity exceeds the maximum allowed - contact customer"/>
                  <setHeader headerName="Destination" id="_setHeader1">
                      <constant>InvalidOrders</constant>
                  </setHeader>
                  <to id="_Invalid" uri="file:target/messages/invalidOrders"/>
              </when>
              <otherwise id="_else2">
                  <log id="_log2" message="valid order - process"/>
                  <setHeader headerName="Destination" id="_setHeader2">
                      <constant>Dispatcher</constant>
                  </setHeader>
                  <to id="_Fulfill" uri="direct:OrderFulfillment"/>
              </otherwise>
          </choice>
      </route>
      <route id="_route2">
          <from id="_direct:OrderFulfillment" uri="direct:OrderFulfillment"/>
          <choice id="_choice2">
              <when id="_when/usa">
                  <xpath>/order/customer/country = 'USA'</xpath>
                  <setHeader headerName="Destination" id="_setHead_usa">
                      <constant>USA</constant>
                  </setHeader>
                  <log id="_usa" message="valid order - ship to USA customer"/>
                  <to id="_US" uri="file:target/messages/USA"/>
              </when>
              <when id="_when/gb">
                  <xpath>/order/customer/country = 'Great Britain'</xpath>
                  <setHeader headerName="Destination" id="_setHead_uk">
                      <constant>UK</constant>
                  </setHeader>
                  <log id="_uk" message="Valid order - ship animals to UK customer"/>
                  <to id="_UK" uri="file:target/messages/GreatBritain"/>
              </when>
              <when id="_when/ger">
                  <xpath>/order/customer/country = 'Germany'</xpath>
                  <setHeader headerName="Destination" id="_setHead_ger">
                      <constant>Germany</constant>
                  </setHeader>
                  <log id="_ger" message="Valid order - ship to Germany customer"/>
                  <to id="_GER" uri="file:target/messages/Germany"/>
              </when>
              <otherwise id="_else/fr">
                  <setHeader headerName="Destination" id="_setHead_fr">
                      <constant>France</constant>
                  </setHeader>
                  <log id="_fr" message="Valid order - ship animals to France customer"/>
                  <to id="_FR" uri="file:target/messages/France"/>
              </otherwise>
          </choice>
      </route>
  </camelContext>
</blueprint>

Next steps

You can run the new route as described in Running the route.

Check the end of the Console's output. You should see these lines:

Check the target destinations in Project Explorer to verify that the routes executed properly:

Select CBRroute.
Right-click it to open the context menu, then select Refresh.
Expand the folder target/messages/ as shown in Figure 4. The message*.xml files should be dispersed in your target destinations like this:
Figure 4. Target message destinations in Project Explorer

Note
To view message content, double-click a message to open it in the route editor's XML editor.

	Note
	To view message content, double-click a message to open it in the route editor's XML editor.

To Add Another Route to the CBR Routing Context

Goals

Prerequisites

Reconfiguring the existing route for direct connection

Adding the second route

Building and configuring the USA branch of the second route

Building and configuring the Great Britain branch of the second route

Building and configuring the Germany branch of the second route

Building and configuring the France branch of the second route

Finishing up

Next steps

Further reading