Routes Guide

Overview¶

Apache Camel is the technology framework used by Platform 6 to allow users to define and implement routing and mediation rules using a Groovy DSL (Domain Specific Language).

A single Camel Context is created when Platform 6 starts. This context can be loaded with various routing rules automatically when the Platform 6 Routes service starts. Alternatively, routing rules can be added and removed in an ad-hoc manner as the development of a Platform 6 application takes place.

The Routes service is a tool to manage the lifecycle of camel routing rules via startup when deployed in production, or under the control of a developer working on a new solution.

Both Routes service and the Scripts service execute Groovy scripts and have DSL bindings. However, the Routes service has been designed to help the Platform 6 developer organize and assist with routing rule lifecycle:

Route deployment scripts can run automatically when Platform 6 starts.
Route deployment scripts can be templated to hide complexity and repetition, enforcing routing rule creation standards.
Route deployment scripts can be typed for easy search and categorisation.
Route deployment scripts can be started and stopped under user control.

Structure of a route deployment script¶

The route deployment script is just a regular Groovy script with a limited number of bindings that may optionally be executed when the Routes service is started.

Note

In fact, a route deployment script does not have to interact with Camel to define routes at all! Instead, it may just be used as a mechanism to execute some custom code when Platform 6 starts.

Please refer to the section Routes DSL to understand what you can do with the script and how to do it.

For more information about the other route deployment script’s fields and the management of these items, read the guide Routes user interface.

Typical format¶

Development¶

Add routes.
Pause indefinitely.
Remove routes.

This format is ideal for development as it can be started and stopped via the UI under the control of the developer.

Here is a typical route deployment script’s template that defines this:

 try {

  p6.camel.getCtx().addRoutes(new RouteBuilder() {

    void configure() {

      ${addRoutes}

    }
  })

  p6.utils.pause()

} finally {

  ${destroyRoutes}

}

The script executes and pauses until Platform 6 is stopped or the user manually stops the script via the UI. Stopping a route deployment script simply interrupts the running script (blocked in a pause) causing it to remove and destroy the installed Camel routing rules before exiting.

Warning

Each route deployment script formatted in this way will cause the creation of a blocking script job. This may not be the best approach in instances that require a large number of route deployment scripts.

Production¶

Add routes and exit.

p6.camel.getCtx().addRoutes(new RouteBuilder() {

  void configure() {

    ${addRoutes}

  }
})

Auto executing this script when Platform 6 starts simply adds the routing rules to the Camel context and exits.