public void addListener( string listenerName, Listener listener )

Registers a Listener with the specified name.

Parameters:

string listenerName

Listener listener

Code:

	<cffunction name="addListener" access="public" returntype="void" output="false"
		hint="Registers a Listener with the specified name.">
		<cfargument name="listenerName" type="string" required="true" />
		<cfargument name="listener" type="MachII.framework.Listener" required="true" />
		
		<cfif isListenerDefined(arguments.listenerName)>
			<cfthrow type="MachII.framework.ListenerAlreadyDefined"
				message="A Listener with name '#arguments.listenerName#' is already registered." />
		<cfelse>
			<cfset variables.listeners[arguments.listenerName] = arguments.listener />
		</cfif>
	</cffunction> 

public void configure( )

Configures each of the registered Listeners.

Parameters:

Code:

	<cffunction name="configure" access="public" returntype="void"
		hint="Configures each of the registered Listeners.">
		<cfset var key = "" />
		<cfloop collection="#variables.listeners#" item="key">
			<cfset getListener(key).configure() />
		</cfloop>
	</cffunction> 

public AppManager getAppManager( )

Sets the AppManager instance this ListenerManager belongs to.

Parameters:

Code:

	<cffunction name="getAppManager" access="public" returntype="MachII.framework.AppManager" output="false"
		hint="Sets the AppManager instance this ListenerManager belongs to.">
		<cfreturn variables.appManager />
	</cffunction> 

public Listener getListener( string listenerName )

Gets a Listener with the specified name.

Parameters:

string listenerName

Code:

	<cffunction name="getListener" access="public" returntype="MachII.framework.Listener" output="false"
		hint="Gets a Listener with the specified name.">
		<cfargument name="listenerName" type="string" required="true" />
		
		<cfif isListenerDefined(arguments.listenerName)>
			<cfreturn variables.listeners[arguments.listenerName] />
		<cfelse>
			<cfthrow type="MachII.framework.ListenerNotDefined" 
				message="Listener with name '#arguments.listenerName#' is not defined." />
		</cfif>
	</cffunction> 

public array getListenerNames( )

Returns an array of listener names.

Parameters:

Code:

	<cffunction name="getListenerNames" access="public" returntype="array" output="false"
		hint="Returns an array of listener names.">
		<cfreturn StructKeyArray(variables.listeners) />
	</cffunction> 

public ListenerManager init( string configXML, AppManager appManager )

Initialization function called by the framework.

Parameters:

string configXML

AppManager appManager

Code:

	<cffunction name="init" access="public" returntype="ListenerManager" output="false"
		hint="Initialization function called by the framework.">
		<cfargument name="configXML" type="string" required="true" />
		<cfargument name="appManager" type="MachII.framework.AppManager" required="true" />
		
		<cfset var listenerNodes = "" />
		<cfset var listenerParams = "" />
		<cfset var name = "" />
		<cfset var type = "" />
		<cfset var paramNodes = "" />
		<cfset var paramName = "" />
		<cfset var paramValue = "" />
		<cfset var invokerNodes = "" />
		<cfset var invokerType = "" />
		<cfset var invoker = "" />
		<cfset var listener = "" />
		<cfset var i = 0 />
		<cfset var j = 0 />
		
		<cfset setAppManager(arguments.appManager) />

		
		<cfset listenerNodes = XMLSearch(configXML,"//listeners/listener") />
		<cfloop from="1" to="#ArrayLen(listenerNodes)#" index="i">
			<cfset name = listenerNodes[i].xmlAttributes['name'] />
			<cfset type = listenerNodes[i].xmlAttributes['type'] />
		
			
			<cfset listenerParams = StructNew() />
			<cfset paramNodes = XMLSearch(listenerNodes[i], "./parameters/parameter") />
			<cfloop from="1" to="#ArrayLen(paramNodes)#" index="j">
				<cfset paramName = paramNodes[j].xmlAttributes['name'] />
				<cfset paramValue = paramNodes[j].xmlAttributes['value'] />
				<cfset listenerParams[paramName] = paramValue />
			</cfloop>
		
			
			<cfset listener = CreateObject('component', type) />
			<cfset listener.init(arguments.appManager, listenerParams) />

			
			<cfset invokerNodes = XMLSearch(listenerNodes[i], "./invoker") />	
			
			<cfif arrayLen(invokerNodes)>
				<cfset invokerType = invokerNodes[1].xmlAttributes['type'] />

				<cfset invoker = CreateObject('component', invokerType) />
				<cfset invoker.init() />
			
			<cfelse>
				<cfset invoker = listener.getDefaultInvoker() >
			</cfif>

			
			<cfset listener.setInvoker(invoker) />
			
			<cfset addListener(name, listener) />
		</cfloop>
		
		<cfreturn this />
	</cffunction> 

public boolean isListenerDefined( string listenerName )

Returns true if a Listener is registered with the specified name.

Parameters:

string listenerName

Code:

	<cffunction name="isListenerDefined" access="public" returntype="boolean" output="false"
		hint="Returns true if a Listener is registered with the specified name.">
		<cfargument name="listenerName" type="string" required="true" />
		<cfreturn StructKeyExists(variables.listeners, arguments.listenerName) />
	</cffunction> 

public void setAppManager( AppManager appManager )

Returns the AppManager instance this ListenerManager belongs to.

Parameters:

AppManager appManager

Code:

	<cffunction name="setAppManager" access="public" returntype="void" output="false"
		hint="Returns the AppManager instance this ListenerManager belongs to.">
		<cfargument name="appManager" type="MachII.framework.AppManager" required="true" />
		<cfset variables.appManager = arguments.appManager />
	</cffunction>