6.x
For Newbies
Getting Started
The Basics
HMVC
Digging Deeper
Architecture Concepts
External links
How are events called?
Events are determined via a special variable that can be sent in via the FORM, URL, or REMOTELY called
event. If no event is detected as an incoming variable, the framework will look in the configuration directives for the DefaultEvent and use that instead. If you did not set a DefaultEvent setting then the framework will use the following convention for you: main.indexHint : You can even change the
event variable name by updating the EventName setting in your coldbox configuration directive.Please note that ColdBox supports both normal variable routing and URL mapping routing, usually referred to as pretty URLs.
Event Syntax
In order to call them you will use the following event syntax notation format:
1
event={module:}{package.}{handler}{.action}
Copied!
- no event : Default event by convention is
main.index - event={handler} : Default action method by convention is
index() - event={handler}.{action} : Explicit handler + action method
- event={package}.{handler}.{action} : Packaged notation
This looks very similar to a Java or CFC method call, example:
String.getLength(), but without the parentheses. Once the event variable is set and detected by the framework, the framework will tokenize the event string to retrieve the CFC and action call to validate it against the internal registry of registered events. It then continues to instantiate the event handler CFC or retrieve it from cache, finally executing the event handler's action method.Examples
1
// Call the users.cfc index() method
2
index.cfm?event=users.index
3
// Call the users.cfc index() method implicitly
4
index.cfm?event=users
5
// Call the users.cfc index() method via URL mappings
6
index.cfm/users/index
7
// Call the users.cfc index() method implicitly via URL mappings
8
index.cfm/users
Copied!
Last modified 4yr ago
Copy link
Edit on GitHub
Contents
Event Syntax