By now, we should all know the default SES route ColdBox offers: addRoute(":handler/:action?"). This means that we can target a handler with or without a package and an action for execution. In ColdBox we have also added a package resolver that will detect this pattern for module and package directories so we can do URL safe and SES friendly URLs for these executions by convention.

If we do not have this feature, this is how the URLs would look like:

However, thanks to package resolving in the SES interceptor we can do links like this:

Much better and nicer huh? Of course! So potentially, with one route we could write entire applications.

A module can also include one or more custom routing files in order to take advantage of our routing DSL and also have better separation as they will be stored outside of the module configuration object. You do this by giving the path to the custom file to include in your routes structure:

routes = [
  "config/routes"
];

This will look for a routes.cfm template in your module's config folder and load it. Please note that you do not need to specify a .cfm if you don't want to. You can load as many route files as you like.