Adobe ColdFusion 8

setCFCListeners

Description

Sets the array of listener CFCs that the gateway sends messages to.

Category

Event Gateway Development

Syntax

public void setCFCListeners(String[] listeners)

See also

Constructor, getGatewayID, setCFCPath, "Providing Gateway class service and information routines" in the ColdFusion Developer's Guide

Parameters

Parameter

Description

listeners

Array of absolute file paths to CFCs to which the gateway forwards messages when it gets events.

Usage

When ColdFusion starts a gateway instance, it calls this method with the names in the instance's listener list in the ColdFusion Administrator. ColdFusion can also call this method if the ColdFusion Administrator listener list changes while the gateway is running.

Example

The following example is the ColdFusion SocketGateway class setCFCListeners method:

public void setCFCListeners(String[] listeners)
{
    ArrayList aListeners = new ArrayList();
    for(int i = 0; i<listeners.length; i++)
    {
        aListeners.add(listeners[i]);
    }
        // Try not to pull the rug out from underneath a running message
    synchronized (cfcListeners)
    {
        cfcListeners = aListeners;
    }
}