User Guide

1000 Chapter 6: ColdFusion MX Event Gateway Reference
error
Description
Writes a log entry with an error severity to the ColdFusion MX 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 Chapter 45,
“Creating Custom Event Gateways” in ColdFusion MX Developer’s Guide
Parameters
Usage
Use this method to send an error message to the ColdFusion MX logging subsystem. ColdFusion
MX will write a 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 MX 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";
}
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.