Adobe ColdFusion 8

error

Description

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

Category

Event Gateway Development

Syntax

error(String message)
error(Throwable th)
error(String message, Throwable th)

See also

debug, fatal, info, warn, getLogger, "Logging events and using log files" in the ColdFusion Developer's Guide

Parameters

Parameter

Description

message

The message to include in the log entry.

th

A throwable object, normally an exception. ColdFusion logs the exception information in the exception.log file in the ColdFusion logs directory.

Usage

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

Example

The ColdFusion example SocketGateway class includes the following code in the outgoingMessage method. It writes an error message if the message's originator ID does not correspond to an open socket.

SocketServerThread st =
        ((SocketServerThread)socketRegistry.get(cfmsg.getOriginatorID()));
    if(st != null)
        st.writeOutput(message);
    else {
        log.error("Cannot send outgoing message. OriginatorID '" +
            cfmsg.getOriginatorID() + "' is not a valid socket id.");
        retcode="failed";
    }