How do I execute a subroutine from an event filter?

There is no built-in API shortcut like announceEvent() to execute subroutine from within an event-filter. However, you can execute a subroutine anywhere there is access to the EventContext.

You can execute a subroutine by calling this code:

    <cffunction name="filterEvent" access="public" returntype="boolean" output="true"
        hint="Runs the filter event.">
        <cfargument name="event" type="MachII.framework.Event" required="true" />
        <cfargument name="eventContext" type="MachII.framework.EventContext" required="true" />
        <cfargument name="paramArgs" type="struct" required="true" />

        <cfset var nameOfSubroutine = "" />

        <!---
        Logic that decides the name of the subroutine to execute
        --->

        <cfset arguments.eventContext.executeSubroutine(nameOfSubroutine, arguments.event) />

        <cfreturn TRUE />
    </cffunction>

Additional Notes and Considerations

• Be sure to set the output attribute of the method to true as subroutines can output data such if they contain <view-page> commands otherwise the output of views will be suppressed.

Back to FAQs