MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Справочник

Страница: 980 / 1108

980 Chapter 6: ColdFusion MX Event Gateway Reference
getLogger
Description
Returns a ColdFusion Logger object that the event gateway can use to log information in a file.
Category
Event Gateway Development
Syntax
coldfusion.eventgateway.Logger getLogger([String logfile ])
See also
Logger class
, “Logging events and using log files” in Chapter 45, “Creating Custom Event
Gateways” in ColdFusion MX Developer’s Guide
Parameters
Returns
A ColdFusion MX logger object to use in
Usage
The Logger class has five methods:
debug
,
info
,
warn
,
error
, and
fatal
, that correspond to the
severity level that is set in the log message. Each method takes a message string, a Throwable class
object, or both.
If you pass a Throwable object to these methods, ColdFusion MX writes the exception
information in the exceptions.log file.
Example
The ColdFusion MX example DirectoryWatcherGateway includes the following line in the
constructor to get a logger object:
// We create our own log file, which will be named "watcher.log"
logger = gatewayService.getLogger("watcher");
The following code, from the start of the routine that loads information from the configuration
file, uses this object to log the initialization.
// Load the properties file to get our settings
protected void loadconfig() throws ServiceRuntimeException
{
// load config
logger.info("DirectoryWatcher (" + gat ") Initializing
DirectoryWatcher gateway with configuration file " + config);
.
.
.
Parameter Description
logfile The name, without an extension, of a log file in the ColdFusion MX logs directory.
ColdFusion MX automatically appends a .log extension to the name. If the file does
not exist, ColdFusion MX creates it when it logs the first message. By default,
ColdFusion logs to the eventgateway.log file.