|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.catalina.logger.LoggerBase | +--org.apache.catalina.logger.FileLogger
Implementation of Logger that appends log messages to a file named {prefix}.{date}.{suffix} in a configured directory, with an optional preceding timestamp.
Field Summary | |
protected Container |
container
The Container with which this Logger has been associated. |
protected static java.lang.String |
info
The descriptive information about this implementation. |
protected LifecycleSupport |
lifecycle
The lifecycle event support for this component. |
protected java.beans.PropertyChangeSupport |
support
The property change support for this component. |
protected int |
verbosity
The verbosity level for above which log messages may be filtered. |
Fields inherited from interface org.apache.catalina.Lifecycle |
START_EVENT, STOP_EVENT |
Fields inherited from interface org.apache.catalina.Logger |
DEBUG, ERROR, FATAL, INFORMATION, WARNING |
Constructor Summary | |
FileLogger()
|
Method Summary | |
void |
addLifecycleListener(LifecycleListener listener)
Add a lifecycle event listener to this component. |
void |
addPropertyChangeListener(java.beans.PropertyChangeListener listener)
Add a property change listener to this component. |
Container |
getContainer()
Return the Container with which this Logger has been associated. |
java.lang.String |
getDirectory()
Return the directory in which we create log files. |
java.lang.String |
getInfo()
Return descriptive information about this Logger implementation and the corresponding version number, in the format <description>/<version> . |
java.lang.String |
getPrefix()
Return the log file prefix. |
java.lang.String |
getSuffix()
Return the log file suffix. |
boolean |
getTimestamp()
Return the timestamp flag. |
int |
getVerbosity()
Return the verbosity level of this logger. |
void |
log(java.lang.Exception exception,
java.lang.String msg)
Writes the specified exception, and message, to a servlet log file. |
void |
log(java.lang.String msg)
Writes the specified message to a servlet log file, usually an event log. |
void |
log(java.lang.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 |
log(java.lang.String msg,
java.lang.Throwable throwable)
Writes an explanatory message and a stack trace for a given Throwable exception to the servlet log file. |
void |
log(java.lang.String message,
java.lang.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 |
removeLifecycleListener(LifecycleListener listener)
Remove a lifecycle event listener from this component. |
void |
removePropertyChangeListener(java.beans.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 |
setDirectory(java.lang.String directory)
Set the directory in which we create log files. |
void |
setPrefix(java.lang.String prefix)
Set the log file prefix. |
void |
setSuffix(java.lang.String suffix)
Set the log file suffix. |
void |
setTimestamp(boolean timestamp)
Set the timestamp flag. |
void |
setVerbosity(int verbosity)
Set the verbosity level of this logger. |
void |
setVerbosityLevel(java.lang.String verbosity)
Set the verbosity level of this logger. |
void |
start()
Prepare for the beginning of active use of the public methods of this component. |
void |
stop()
Gracefully terminate the active use of the public methods of this component. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected static final java.lang.String info
protected LifecycleSupport lifecycle
protected Container container
protected java.beans.PropertyChangeSupport support
protected int verbosity
Constructor Detail |
public FileLogger()
Method Detail |
public java.lang.String getDirectory()
public void setDirectory(java.lang.String directory)
directory
- The new log file directorypublic java.lang.String getPrefix()
public void setPrefix(java.lang.String prefix)
prefix
- The new log file prefixpublic java.lang.String getSuffix()
public void setSuffix(java.lang.String suffix)
suffix
- The new log file suffixpublic boolean getTimestamp()
public void setTimestamp(boolean timestamp)
timestamp
- The new timestamp flagpublic void log(java.lang.String msg)
log
in class org.apache.catalina.logger.LoggerBase
msg
- A String
specifying the message to be written
to the log filepublic void addLifecycleListener(LifecycleListener listener)
addLifecycleListener
in interface Lifecycle
listener
- The listener to addpublic void removeLifecycleListener(LifecycleListener listener)
removeLifecycleListener
in interface Lifecycle
listener
- The listener to addpublic void start() throws LifecycleException
configure()
,
and before any of the public methods of the component are utilized.start
in interface Lifecycle
java.lang.IllegalStateException
- if this component has already been
startedLifecycleException
- if this component detects a fatal error
that prevents this component from being usedpublic void stop() throws LifecycleException
stop
in interface Lifecycle
java.lang.IllegalStateException
- if this component has not been startedLifecycleException
- if this component detects a fatal error
that needs to be reportedpublic Container getContainer()
getContainer
in interface Logger
public void setContainer(Container container)
setContainer
in interface Logger
container
- The associated Containerpublic java.lang.String getInfo()
<description>/<version>
.getInfo
in interface Logger
public int getVerbosity()
getVerbosity
in interface Logger
public void setVerbosity(int verbosity)
setVerbosity
in interface Logger
verbosity
- The new verbosity levelpublic void setVerbosityLevel(java.lang.String verbosity)
verbosityLevel
- The new verbosity level, as a stringpublic void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
addPropertyChangeListener
in interface Logger
listener
- The listener to addpublic void log(java.lang.Exception exception, java.lang.String msg)
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.log
in interface Logger
exception
- An Exception
to be reportedmsg
- The associated message stringpublic void log(java.lang.String msg, java.lang.Throwable throwable)
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.log
in interface Logger
msg
- A String
that describes the error or
exceptionthrowable
- The Throwable
error or exceptionpublic void log(java.lang.String message, int verbosity)
log
in interface Logger
message
- A String
specifying the message to be
written to the log fileverbosity
- Verbosity level of this messagepublic void log(java.lang.String message, java.lang.Throwable throwable, int verbosity)
log
in interface Logger
message
- A String
that describes the error or
exceptionthrowable
- The Throwable
error or exceptionverbosity
- Verbosity level of this messagepublic void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
removePropertyChangeListener
in interface Logger
listener
- The listener to remove
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |