6.x
For Newbies
Getting Started
The Basics
HMVC
Digging Deeper
Architecture Concepts
External links
Implicit Methods
Every event handler controller has some implicit methods that if you create them, they come alive. Just like the implicit methods in
Application.cfconMissingAction()
With this convention you can create virtual events that do not even need to be created or exist in a handler. Every time an event requests an action from an event handler and that action does not exist in the handler, the framework will check if an
onMissingAction() method has been declared. If it has, it will execute it. This is very similar to ColdFusion's onMissingMethod() but on an event-driven framework.1
function onMissingAction( event, rc, prc, missingAction, eventArguments ){
2
​
3
}
Copied!
This event has an extra argument: missingAction which is the missing action that was requested. You can then do any kind of logic against this missing action and decide to do internal processing, error handling or anything you like. The power of this convention method is extraordinary, you have tons of possibilities as you can create virtual events on specific event handlers.
onError()
This is a localized error handler for your event handler. If any type of runtime error occurs in an event handler and this method exists, then the framework will call your method so you can process the error first. If the method does not exist, then normal error procedures ensue.
Please note that compile time errors will not fire this method, only runtime exceptions.
1
// On Error
2
function onError( event, rc, prc, faultAction, exception, eventArguments ){
3
// prepare a data packet
4
var data = {
5
error = true,
6
messages = exception.message & exception.detail,
7
data = ""
8
}
9
​
10
// log via the log variable already prepared by ColdBox
11
log.error("Exception when executing #arguments.faultAction# #data.messages#", exception);
12
​
13
// render out a json packet according to specs status codes and messages
14
event.renderData(data=data,type="json",statusCode=500,statusMessage="Error ocurred");
15
​
16
}
Copied!
onInvalidHTTPMethod()
This method will be called for you if a request is trying to execute an action in your handler without the proper approved HTTP Verb. It will then be your job to determine what to do next:
1
function onInvalidHTTPMethod( faultAction, event, rc, prc ){
2
return "Go away!";
3
}
Copied!
Last modified 3yr ago
Copy link
Edit on GitHub