6.x
For Newbies
Getting Started
The Basics
HMVC
Digging Deeper
Architecture Concepts
External links
Executing Routes
A part from using
runEvent() to execute events, you can also abstract it by using the runRoute() method. This method is fairly similar but with the added benefit of executing a NAMED route instead of the direct event it represents. This gives you the added flexibility of abstracting the direct event and leveraging the named route.All the same feature of
runEvent() apply to runRoute()RunRoute()
Just like you can create links based on named routes and params, you can execute named routes and params as well internally via
runRoute()1
/**
2
* Executes internal named routes with or without parameters. If the named route is not found or the route has no event to execute then this method will throw an `InvalidArgumentException`.
3
* If you need a route from a module then append the module address: `@moduleName` or prefix it like in run event calls `moduleName:routeName` in order to find the right route.
4
* The route params will be passed to events as action arguments much how eventArguments work.
5
*
6
* @name The name of the route
7
* @params The parameters of the route to replace
8
* @cache Cached the output of the runnable execution, defaults to false. A unique key will be created according to event string + arguments.
9
* @cacheTimeout The time in minutes to cache the results
10
* @cacheLastAccessTimeout The time in minutes the results will be removed from cache if idle or requested
11
* @cacheSuffix The suffix to add into the cache entry for this event rendering
12
* @cacheProvider The provider to cache this event rendering in, defaults to 'template'
13
* @prePostExempt If true, pre/post handlers will not be fired. Defaults to false
14
*
15
* @throws InvalidArgumentException
16
*/
17
any function runRoute(
18
required name,
19
struct params={},
20
boolean cache=false,
21
cacheTimeout="",
22
cacheLastAccessTimeout="",
23
cacheSuffix="",
24
cacheProvider="template",
25
boolean prePostExempt=false
26
)
Copied!
Parameters
The params argument you pass to the runRoute() method will be translated into event arguments. Therefore they will be passed as arguments to the event the route represents:
1
// Execute
2
runRoute( "userData", { id=4 } )
Copied!
In the example above, the
userData named route points to the user.data event.user.cfc
1
component{
2
​
3
property name="userService" inject;
4
​
5
function data( event, rc, prc, id=0 ){
6
if( id == 0 )
7
return {};
8
9
return userService.getData( id );
10
}
11
}
Copied!
Module Routes
If you want to execute module routes, no problem! Just use our
@ or : notation to tell the controller from which module's router we should pick the route from.1
# Using @ destination
2
runRoute( "[email protected]", { id=4 } )
3
​
4
# Using : prefix
5
runRoute( "user:userData", { id=4 } )
Copied!
​
Last modified 3yr ago
Copy link
Edit on GitHub