Interceptor Declaration

Master Class Video Training Community Support
Search…
Interceptors can be declared in the Coldbox.cfc configuration file or programmatically at runtime. If you register them in the configuration file, then you have control over the order in which they fire. If you register interceptors programmatically, you won't have control over the order of execution.
In the configuration file, interceptors are declared as an array of structures in an element called interceptors. The elements of each interceptor structure are:
class - The required instantiation path of the CFC.
name - An optional unique name for the interceptor. If this is not passed then the name of the CFC will be used. We highly encourage the use of a name to avoid collisions.
properties - A structure of configuration properties to be passed to the interceptor
In ColdBox.cfc:
1
// Interceptors registration
2
interceptors = [
3
    { 
4
        class = "cfc.path",
5
        name = "unique name/wirebox ID",
6
        properties = { 
7
            // configuration
8
        }
9
    }
10
];
Copied!
Example
1
// Interceptors registration
2
interceptors = [
3
    {
4
        class="coldbox.system.interceptors.SES",
5
        properties={}
6
    },
7
    {
8
        class="interceptors.RequestTrim",
9
        properties={
10
            trimAll=true
11
        }
12
    },
13
    {
14
        class="coldbox.system.interceptors.Security",
15
        name="AppSecurity",
16
        properties={
17
            rulesSource="model",
18
            rulesModel="[email protected]",
19
            rulesModelMethod="getSecurityRules",
20
            validatorModel="[email protected]"
21
        }
22
    }
23
];
Copied!
Info Remember that order is important!
Conventions
Interceptor Registration
Last modified 4yr ago
Copy link
Edit on GitHub