info

Description

Writes a log entry with an information severity to the ColdFusion MX logger. The entry includes the severity, thread ID, date, time, and a text message.

Category

Event Gateway Development

Syntax

info(String message)
info(Throwable th)
info(String message, Throwable th)

See also

debug, error, fatal, warn, getLogger, Logging events and using log files in Creating Custom Event Gateways in ColdFusion MX Developer's Guide

Parameters

Parameter Description

message

The message to include in the log entry.

th

A throwable object, normally an exception. ColdFusion MX logs the exception information in the exception.log file in the ColdFusion MX logs directory. Not normally used with this method.

Usage

Use this method to send an informational message to the ColdFusion MX logging subsystem. ColdFusion MX will write a messages with a severity of "information" to the log file specified in the getLogger method that returned the Logger instance (or the default log file).

ColdFusion normally logs all information severity messages, so you should not use this severity for debugging messages or for events that happen frequently.

Example

The ColdFusion MX example DirectoryWatcherGateway class includes the following line at the top of its loadconfig method that loads the gateway's configuration file. It writes a message including the gateway ID and configuration file.

logger.info("DirectoryWatcher (" + gatewayID + ") Initializing
      DirectoryWatcher gateway with configuration file " + config);

View comments in LiveDocs