Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1265

DEVELOPING COLDFUSION 9 APPLICATIONS
Using External Resources
Directory Purpose
cfc Event gateway application CFCs. ColdFusion is installed with an Administrator Mapping between /gateway and
this cfc directory.
cfc/examples Code for the ColdFusion sample applications.
config Configuration files for all ColdFusion event gateways, including standard ColdFusion event gateways, such as
SMS, and example event gateways, such as the directory watcher event gateway.
doc/api JavaDoc for the Gateway, and GatewayHelper interfaces, and the CFEvent, GatewayServices, and GenericGateway
classes that gateway developer use when writing gateways. This documentation is a subset of the information in
Gateway development interfaces and classes in the CFML Reference.
lib Executable code for example and user-developed event gateway classes. The ColdFusion class loader includes
this directory on its classpath and includes any JAR files that are in that directory on the class path. The
examples.jar file in this directory contains the class files for the DirectoryWatcherGateway, EmptyGateway, and
SocketGateway classes.
src/examples Source code for the example event gateway classes that Adobe provides. Includes the EmptyGateway.java file
and the following subdirectories:
•
socket: Socket gateway source files
•
watcher: directory watcher gateway source files
•
JMS: JMS gateway source files
The eventgateway.log file
Event gateways provided with ColdFusion log event gateway errors and events to the cf_root\WEB-
INF\cfusion\logs\eventgateway.log file on J2EE configurations, or the cf_root\logs\eventgateway.log file on server
configurations. ColdFusion includes methods that let any event gateway use this file. This log file can be useful in
debugging event gateways and event gateway applications.
ColdFusion Administrator event gateway pages
The ColdFusion Administrator includes a Gateways section with three pages for managing event gateways:
• Settings
• Gateway types
• Gateway Instances
The Settings page lets you enable and disable support for event gateways, specify the number of threads that
ColdFusion can devote to processing events, specify the maximum number events that ColdFusion can hold in its
event queue (which holds events that are waiting to be processed) and start the SMS test server.
The Gateway Types page lets you add, remove, and configure event gateway types by specifying a name, a Java class,
and startup time-out behavior.
Note: The gateway type name in the ColdFusion Administrator does not have to be the same as the gateway type that is
used in the gateway Java code and the
The Gateway Instances page lets you add, remove, configure, start, and stop individual event gateway instances. You
configure an event gateway instance by specifying a unique ID, the gateway type, one or more listener CFC paths, a
configuration file (not required for all gateway types), and a startup mode (manual, automatic, or disabled).
data structure; however, use the same name in both places for consistency.
CFEvent
Last updated 1/20/2012
1260