This is a quick guide to showcase a cool new feature in ColdBox 3.0.0 that helps you create routes based upon your own regular expressions and needs. Before (coldbox < 3.0.0) you created routes with placeholders and these placeholders could be alphanumerical or numerical values. In ColdBox 3.0.0 they can be alphanumerical, alpha, numerical, and custom. Custom is what we are after, which makes URL Mappings in ColdBox 3.0.0 extermely flexible. So let me pinpoint the use case.
I have two URLs that need to be aliased to the same handler+action combination and I want to be creative and have one cool route for them instead of two.
URL1: /en/chat
URL2: /en/assist
So I can use the following route to basically be able to match both URLs in one single route using our fabulous new constraints.
//Using cf9/railo implicit structs ROCK!
addRoute(pattern="/en/:chat",
handler="support",
action="chat"
constraints={
chat = "(chat|assist)"
});
// Using JSON notation for CF engines < 9
addRoute(pattern="/en/:chat",
handler="support",
action="chat"
constraints="{
'chat' : '(chat|assist)'
}");
As you can see there is a new argument in the addRoute method called constraints, which basically is a structure or JSON structure of custom regex constraints on placeholders. This way, you can easily match whatever you like to incoming URLs. In my case my regex was a simple list of two static parts. Yours could be more fancy! Anyways, hope you enjoy this new feature.
Add Your Comment