org.apache.commons.logging.impl
public class SimpleLog extends Object implements Log, Serializable
Simple implementation of Log that sends all enabled log messages, for all defined loggers, to System.err. The following system properties are supported to configure the behavior of this logger:
org.apache.commons.logging.simplelog.defaultlog
-
Default logging detail level for all instances of SimpleLog.
Must be one of ("trace", "debug", "info", "warn", "error", or "fatal").
If not specified, defaults to "info". org.apache.commons.logging.simplelog.log.xxxxx
-
Logging detail level for a SimpleLog instance named "xxxxx".
Must be one of ("trace", "debug", "info", "warn", "error", or "fatal").
If not specified, the default logging detail level is used.org.apache.commons.logging.simplelog.showlogname
-
Set to true
if you want the Log instance name to be
included in output messages. Defaults to false
.org.apache.commons.logging.simplelog.showShortLogname
-
Set to true
if you want the last component of the name to be
included in output messages. Defaults to true
.org.apache.commons.logging.simplelog.showdatetime
-
Set to true
if you want the current date and time
to be included in output messages. Default is false
.org.apache.commons.logging.simplelog.dateTimeFormat
-
The date and time format to be used in the output messages.
The pattern describing the date and time format is the same that is
used in java.text.SimpleDateFormat
. If the format is not
specified or is invalid, the default format is used.
The default format is yyyy/MM/dd HH:mm:ss:SSS zzz
.In addition to looking for system properties with the names specified
above, this implementation also checks for a class loader resource named
"simplelog.properties"
, and includes any matching definitions
from this resource (if it exists).
Version: $Id: SimpleLog.java,v 1.21 2004/06/06 20:47:56 rdonkin Exp $
Field Summary | |
---|---|
protected int | currentLogLevel The current log level |
protected static DateFormat | dateFormatter Used to format times |
protected static String | dateTimeFormat The date and time format to use in the log message |
protected static String | DEFAULT_DATE_TIME_FORMAT The default format to use when formating dates |
protected String | logName The name of this simple log instance |
static int | LOG_LEVEL_ALL Enable all logging levels |
static int | LOG_LEVEL_DEBUG "Debug" level logging. |
static int | LOG_LEVEL_ERROR "Error" level logging. |
static int | LOG_LEVEL_FATAL "Fatal" level logging. |
static int | LOG_LEVEL_INFO "Info" level logging. |
static int | LOG_LEVEL_OFF Enable no logging levels |
static int | LOG_LEVEL_TRACE "Trace" level logging. |
static int | LOG_LEVEL_WARN "Warn" level logging. |
String | shortLogName The short name of this simple log instance |
protected static boolean | showDateTime Include the current time in the log message |
protected static boolean | showLogName Include the instance name in the log message? |
protected static boolean | showShortName Include the short name ( last component ) of the logger in the log
message. |
protected static Properties | simpleLogProps Properties loaded from simplelog.properties |
protected static String | systemPrefix All system properties used by SimpleLog start with this |
Constructor Summary | |
---|---|
SimpleLog(String name)
Construct a simple log with given name.
|
Method Summary | |
---|---|
void | debug(Object message) Log a message with debug log level. |
void | debug(Object message, Throwable t) Log an error with debug log level. |
void | error(Object message) Log a message with error log level. |
void | error(Object message, Throwable t) Log an error with error log level. |
void | fatal(Object message) Log a message with fatal log level. |
void | fatal(Object message, Throwable t) Log an error with fatal log level. |
static boolean | getBooleanProperty(String name, boolean dephault) |
static ClassLoader | getContextClassLoader()
Return the thread context class loader if available.
|
int | getLevel() Get logging level. |
static InputStream | getResourceAsStream(String name)
InvocationTargetException is thrown by 'invoke' when
the method being invoked (getContextClassLoader) throws
an exception.
getContextClassLoader() throws SecurityException when
the context class loader isn't an ancestor of the
calling class's class loader, or if security
permissions are restricted.
|
static String | getStringProperty(String name) |
static String | getStringProperty(String name, String dephault) |
void | info(Object message) Log a message with info log level. |
void | info(Object message, Throwable t) Log an error with info log level. |
boolean | isDebugEnabled() Are debug messages currently enabled? |
boolean | isErrorEnabled() Are error messages currently enabled? |
boolean | isFatalEnabled() Are fatal messages currently enabled? |
boolean | isInfoEnabled() Are info messages currently enabled? |
protected boolean | isLevelEnabled(int logLevel)
Is the given log level currently enabled?
|
boolean | isTraceEnabled() Are trace messages currently enabled? |
boolean | isWarnEnabled() Are warn messages currently enabled? |
protected void | log(int type, Object message, Throwable t) Do the actual logging. |
void | setLevel(int currentLogLevel) Set logging level. |
void | trace(Object message) Log a message with trace log level. |
void | trace(Object message, Throwable t) Log an error with trace log level. |
void | warn(Object message) Log a message with warn log level. |
void | warn(Object message, Throwable t) Log an error with warn log level. |
protected void | write(StringBuffer buffer) Write the content of the message accumulated in the specified
|
SimpleLog
start with thisParameters: name log name
Log a message with debug log level.
Log an error with debug log level.
Log a message with error log level.
Log an error with error log level.
Log a message with fatal log level.
Log an error with fatal log level.
Throws: LogConfigurationException if a suitable class loader cannot be identified.
Get logging level.
Log a message with info log level.
Log an error with info log level.
Are debug messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Are error messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Are fatal messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Are info messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Parameters: logLevel is this level enabled?
Are trace messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Are warn messages currently enabled?
This allows expensive operations such as String
concatenation to be avoided when the message will be ignored by the
logger.
Do the actual logging.
This method assembles the message
and then calls write()
to cause it to be written.
Parameters: type One of the LOG_LEVEL_XXX constants defining the log level message The message itself (typically a String) t The exception whose stack trace should be logged
Set logging level.
Parameters: currentLogLevel new logging level
Log a message with trace log level.
Log an error with trace log level.
Log a message with warn log level.
Log an error with warn log level.
Write the content of the message accumulated in the specified
StringBuffer
to the appropriate output destination. The
default implementation writes to System.err
.
Parameters: buffer A StringBuffer
containing the accumulated
text to be logged