6.x
For Newbies
Getting Started
HMVC
Digging Deeper
Architecture Concepts
External links
ColdBox.cfc
The ColdBox configuration CFC is the heart of your ColdBox application. It contains the initialization variables for your application and extra information used by third-party modules and ultimately how your application boots up. In itself, it is also an event listener or ColdBox Interceptor, so it can listen to life-cycle events of your application.
This CFC is instantiated by ColdBox and decorated at runtime so you can take advantage of some dependencies.
- Controller : Reference to the main ColdBox Controller object (
coldbox.system.web.Controller) - AppMapping : The location of the application on the web server
- LogBoxConfig : A reference to a LogBox configuration object
Configuration Storage
Once the application starts up, a reference to the instantiated configuration CFC will be stored in the configuration settings with the key
coldboxConfig. You can then retrieve it later in your handlers, interceptors, modules, etc.1
// retrieve it
2
config = getSetting( 'coldboxConfig' );
3
​
4
// inject it
5
property name="config" inject="coldbox:setting:coldboxConfig";
Copied!
Configuration Interceptor
Another cool concept for the Configuration CFC is that it is also registered as a ColdBox Interceptor once the application starts up automatically for you. Create functions that will listen to application events:
1
function preProcess( event, interceptData, buffer, rc, prc ){
2
writeDump( 'I just hijacked your app!' );abort;
3
}
Copied!
Note that the config CFC does not have the same variables mixed into it that a "normal" interceptor has. You can still access everything you need, but will need to get it from the
controller in the variables scope.1
function preRender( event, interceptData, buffer, rc, prc ){
2
controller.getWirebox().getInstance( 'loggerService' ).doSomething();
3
}
Copied!
Last modified 3yr ago
Copy link
Edit on GitHub