Configure() Method
The configure()
method will be run before a module is loaded.
Injected Variables
The following variables will be created for you in the variables scope of the ModuleConfig.cfc
.
shell
- The shell object (kind of the core CommandBox controller)moduleMapping
- The component mapping to the modulemodulePath
- The physical path to the modulelogBox
- The LogBox instancelog
- A named logger, ready to log!wirebox
- Your friendly neighborhood DI enginebinder
- The WireBox binder, handy for mapping models manually
Data Structures
The configure()
method does not accept or return any data. Instead, the config CFC itself represents the data for configuring the module with data structures in the variables scope. It's the job of the configure method to ensure that these data structures are created and populated.
There is no required data, but here is the list of optional data you can set:
settings
- A struct of custom module settings. These defaults can be overridden when the module is loaded with the CommandBox user config.interceptors
- An array of declared interceptor structures that should be loaded in the entire application. Each interceptor structure containsclass
, and optionalproperties
.interceptorSettings
- A structure of settings for interceptor interactivity which includes the sub-keycustomInterceptionPoints
, a list of custom interception points to add to the application wide interceptor service
Here is an example configure()
method. Note these data structures are placed in the variables scope.