org.apache.catalina
Interface Logger
- FileLogger, LoggerBase, SystemErrLogger, SystemOutLogger
A Logger is a generic interface for the message and exception
logging methods of the ServletContext interface. Loggers can be
attached at any Container level, but will typically only be attached
to a Context, or higher level, Container.
Version:
- Craig R. McClanahan
static int | DEBUG
|
static int | ERROR
|
static int | FATAL - Verbosity level constants for log messages that may be filtered
by the underlying logger.
|
static int | INFORMATION
|
static int | WARNING
|
void | addPropertyChangeListener(PropertyChangeListener listener) - Add a property change listener to this component.
|
Container | getContainer() - Return the Container with which this Logger has been associated.
|
String | getInfo() - Return descriptive information about this Logger implementation and
the corresponding version number, in the format
<description>/<version> .
|
int | getVerbosity() - Return the verbosity level of this logger.
|
void | log(Exception exception, String msg) - Writes the specified exception, and message, to a servlet log file.
|
void | log(String message) - Writes the specified message to a servlet log file, usually an event
log.
|
void | log(String message, Throwable throwable) - Writes an explanatory message and a stack trace for a given
Throwable exception to the servlet log file.
|
void | log(String message, Throwable throwable, int verbosity) - Writes the specified message and exception to the servlet log file,
usually an event log, if the logger is set to a verbosity level equal
to or higher than the specified value for this message.
|
void | log(String message, int verbosity) - Writes the specified message to the servlet log file, usually an event
log, if the logger is set to a verbosity level equal to or higher than
the specified value for this message.
|
void | removePropertyChangeListener(PropertyChangeListener listener) - Remove a property change listener from this component.
|
void | setContainer(Container container) - Set the Container with which this Logger has been associated.
|
void | setVerbosity(int verbosity) - Set the verbosity level of this logger.
|
DEBUG
public static final int DEBUG
- 4
ERROR
public static final int ERROR
- 1
FATAL
public static final int FATAL
Verbosity level constants for log messages that may be filtered
by the underlying logger.
INFORMATION
public static final int INFORMATION
- 3
WARNING
public static final int WARNING
- 2
addPropertyChangeListener
public void addPropertyChangeListener(PropertyChangeListener listener)
Add a property change listener to this component.
listener
- The listener to add
getContainer
public Container getContainer()
Return the Container with which this Logger has been associated.
getInfo
public String getInfo()
Return descriptive information about this Logger implementation and
the corresponding version number, in the format
<description>/<version>
.
getVerbosity
public int getVerbosity()
Return the verbosity level of this logger. Messages logged with a
higher verbosity than this level will be silently ignored.
log
public void log(Exception exception,
String msg)
Writes the specified exception, and message, to a servlet log file.
The implementation of this method should call
log(msg, exception)
instead. This method is deprecated
in the ServletContext interface, but not deprecated here to avoid
many useless compiler warnings. This message will be logged
unconditionally.
exception
- An Exception
to be reportedmsg
- The associated message string
log
public void log(String message)
Writes the specified message to a servlet log file, usually an event
log. The name and type of the servlet log is specific to the
servlet container. This message will be logged unconditionally.
message
- A String
specifying the message to be
written to the log file
log
public void log(String message,
Throwable throwable)
Writes an explanatory message and a stack trace for a given
Throwable
exception to the servlet log file. The name
and type of the servlet log file is specific to the servlet container,
usually an event log. This message will be logged unconditionally.
message
- A String
that describes the error or
exceptionthrowable
- The Throwable
error or exception
log
public void log(String message,
Throwable throwable,
int verbosity)
Writes the specified message and exception to the servlet log file,
usually an event log, if the logger is set to a verbosity level equal
to or higher than the specified value for this message.
message
- A String
that describes the error or
exceptionthrowable
- The Throwable
error or exceptionverbosity
- Verbosity level of this message
log
public void log(String message,
int verbosity)
Writes the specified message to the servlet log file, usually an event
log, if the logger is set to a verbosity level equal to or higher than
the specified value for this message.
message
- A String
specifying the message to be
written to the log fileverbosity
- Verbosity level of this message
removePropertyChangeListener
public void removePropertyChangeListener(PropertyChangeListener listener)
Remove a property change listener from this component.
listener
- The listener to remove
setContainer
public void setContainer(Container container)
Set the Container with which this Logger has been associated.
container
- The associated Container
setVerbosity
public void setVerbosity(int verbosity)
Set the verbosity level of this logger. Messages logged with a
higher verbosity than this level will be silently ignored.
verbosity
- The new verbosity level
Copyright B) 2000-2003 Apache Software Foundation. All Rights Reserved.