Interceptor Events

The module configuration object is also treated as an Interceptor once it is created and configured.
Life-cycle Events
There are two life-cycle callback events you can declare in your ModuleConfig.cfc:
onLoad() : Called when the module is loaded and activated
onUnLoad() : Called when the module is unloaded from memory
This gives you great hooks for you to do bootup and shutdown commands for this specific module. You can build a ContentBox or Wordpress like application very easily all built in to the developing platform.
1
function onLoad(){
2
  // Register some tables in my database and activate some features
3
  controller.getWireBox().getInstance('MyModuleService').activate();
4
    log.info( 'Module #this.title# loaded correctly' );
5
}
6
​
7
function onUnLoad(){
8
  // Cleanup some stuff and logit
9
  controller.getWireBox().getInstance('MyModuleService').shutdown();
10
​
11
  // Log we unloaded
12
  log.info( 'My module unloaded successfully!' );
13
}
Copied!
Custom Events
Also, remember that the configuration object itself is an interceptor so you can declare all of the framework's interception points in the configuration object and they will be registered as interceptors.
1
function preProcess(event, interceptData){
2
  // I just intercepted ALL incoming requests to the application
3
  log.info('The event executed is #arguments.event.getCurrentEvent()#');
4
}
Copied!
This is a powerful feature, you can create an entire module based on a single CFC and just treat it as an interceptor. So get your brain into gear and let the gas run, you are going for a ride baby!

Environment Control

Module Event Executions

Last modified 4yr ago

Copy link

Edit on GitHub

Contents

Life-cycle Events

Custom Events