Blog

Cool SES Custom Placeholder Routes on 3.0.0

Luis Majano April 02, 2010

Spread the word

Luis Majano

April 02, 2010

Spread the word


Share your thoughts

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

Recent Entries

Ortus & BoxLang July Recap 2026

Ortus & BoxLang July Recap 2026

July continued to showcase the rapid evolution of the Ortus ecosystem with major BoxLang releases, innovative developer tools, and expanded AI capabilities. From new runtime features and cloud-native integrations to practical learning resources and technical deep dives, this month's highlights reflect Ortus' commitment to building modern, high-performance solutions for the JVM.

The month also featured community initiatives, conference resources, and international events, including CFCa...

Victor Campos
Victor Campos
July 31, 2026