private AppManager getAppManager( )

Parameters:

Code:

	<cffunction name="getAppManager" access="private" returntype="MachII.framework.AppManager" output="false">
		<cfreturn variables.appManager />
	</cffunction> 

private string getEventName( struct eventArgs )

Parameters:

struct eventArgs

Code:

	<cffunction name="getEventName" access="private" returntype="string" output="false">
		<cfargument name="eventArgs" type="struct" required="true" />
		<cfset var eventParam = getAppManager().getPropertyManager().getProperty('eventParameter') />
		<cfset var eventName = "" />
		
		<cfif StructKeyExists(arguments.eventArgs, eventParam) AND arguments.eventArgs[eventParam] NEQ ''>
			<cfset eventName = arguments.eventArgs[eventParam] />
		<cfelse>
			<cfset eventName = getAppManager().getPropertyManager().getProperty('defaultEvent') />
		</cfif>
		
		<cfreturn eventName />
	</cffunction> 

private struct getRequestEventArgs( )

Parameters:

Code:

	<cffunction name="getRequestEventArgs" access="private" returntype="struct" output="false">
		<cfset var eventArgs = StructNew() />
		<cfset var paramPrecedence = getAppManager().getPropertyManager().getProperty('parameterPrecedence') />
		<cfset var overwriteFormParams = (paramPrecedence EQ 'url') />
		
		<cfset StructAppend(eventArgs, form) />
		<cfset StructAppend(eventArgs, url, overwriteFormParams) />
		
		<cfreturn eventArgs />
	</cffunction> 

public void handleEventRequest( string eventName, struct eventArgs )

Handles an event request made to the framework.

Parameters:

string eventName

struct eventArgs

Code:

	<cffunction name="handleEventRequest" access="public" returntype="void" output="true"
		hint="Handles an event request made to the framework.">
		<cfargument name="eventName" type="string" required="true"
			hint="The name of the requested event." />
		<cfargument name="eventArgs" type="struct" required="true" default="#StructNew()#"
			hint="The event arguments provided in the request." />
		<cfset var exception = "" />
		<cfset var eventContext = getAppManager().createEventContext(arguments.eventName) />
		<cfset request.eventContext = eventContext />
		
		<cftry>
			<cfif NOT getAppManager().getEventManager().isEventDefined(arguments.eventName)>
				<cfthrow type="MachII.framework.EventHandlerNotDefined" 
					message="Event-handler for event '#arguments.eventName#' is not defined." />
			</cfif>
			
			<cfif getAppManager().getEventManager().isEventPublic(arguments.eventName)>
				<cfset eventContext.announceEvent(arguments.eventName, arguments.eventArgs) />
			<cfelse>
				<cfthrow type="MachII.framework.EventHandlerNotAccessible" 
					message="Event-handler for event '#arguments.eventName#' is not accessible." />
			</cfif>
			
			
			<cfcatch type="any">
				<cfset exception = CreateObject('component', 'MachII.util.Exception') />
				<cfset exception.wrapException(cfcatch) />
				<cfset eventContext.handleException(exception, true) />
			</cfcatch>
		</cftry>
		
		
		<cfset eventContext.processEvents() />
	</cffunction> 

public void handleRequest( )

Handles a request made to the framework.

Parameters:

Code:

	<cffunction name="handleRequest" access="public" returntype="void" output="true"
		hint="Handles a request made to the framework.">
		
		<cfset var eventArgs = getRequestEventArgs() />
		
		<cfset var eventName = getEventName(eventArgs) />
		
		<cfset handleEventRequest(eventName, eventArgs) />
	</cffunction> 

public void init( AppManager appManager )

Initializes the RequestHandler.

Parameters:

AppManager appManager

Code:

	<cffunction name="init" access="public" returntype="void" output="false"
		hint="Initializes the RequestHandler.">
		<cfargument name="appManager" type="MachII.framework.AppManager" required="true" />
		
		<cfset setAppManager(arguments.appManager) />
	</cffunction> 

private void setAppManager( AppManager appManager )

Parameters:

AppManager appManager

Code:

	<cffunction name="setAppManager" access="private" returntype="void" output="false">
		<cfargument name="appManager" type="MachII.framework.AppManager" required="true" />
		<cfset variables.appManager = arguments.appManager />
	</cffunction>