depends.org.apache.commons.logging.impl

类 SimpleLog

java.lang.Object

depends.org.apache.commons.logging.impl.SimpleLog

所有已实现的接口:

Log, java.io.Serializable

public class SimpleLog
extends java.lang.Object
implements Log, java.io.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:

• depends.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".
• depends.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.
• depends.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.
• depends.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.
• depends.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.
• depends.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).

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
protected int	currentLogLevel The current log level
protected static java.text.DateFormat	dateFormatter Used to format times.
protected static java.lang.String	dateTimeFormat The date and time format to use in the log message
protected static java.lang.String	DEFAULT_DATE_TIME_FORMAT The default format to use when formating dates
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.
protected java.lang.String	logName The 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 java.util.Properties	simpleLogProps Properties loaded from simplelog.properties
protected static java.lang.String	systemPrefix All system properties used by SimpleLog start with this

构造器概要

构造器

构造器和说明
SimpleLog(java.lang.String name) Construct a simple log with given name.

方法概要

方法

限定符和类型	方法和说明
void	debug(java.lang.Object message) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_DEBUG.
void	debug(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_DEBUG.
void	error(java.lang.Object message) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_ERROR.
void	error(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_ERROR.
void	fatal(java.lang.Object message) Log a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_FATAL.
void	fatal(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_FATAL.
int	getLevel() Get logging level.
void	info(java.lang.Object message) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_INFO.
void	info(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_INFO.
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, java.lang.Object message, java.lang.Throwable t) Do the actual logging.
void	setLevel(int currentLogLevel) Set logging level.
void	trace(java.lang.Object message) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_TRACE.
void	trace(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_TRACE.
void	warn(java.lang.Object message) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_WARN.
void	warn(java.lang.Object message, java.lang.Throwable t) Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_WARN.
protected void	write(java.lang.StringBuffer buffer) Write the content of the message accumulated in the specified StringBuffer to the appropriate output destination.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

systemPrefix

protected static final java.lang.String systemPrefix

All system properties used by SimpleLog start with this

另请参阅:

常量字段值

simpleLogProps

protected static final java.util.Properties simpleLogProps

Properties loaded from simplelog.properties

DEFAULT_DATE_TIME_FORMAT

protected static final java.lang.String DEFAULT_DATE_TIME_FORMAT

The default format to use when formating dates

另请参阅:

常量字段值

showLogName

protected static volatile boolean showLogName

Include the instance name in the log message?

showShortName

protected static volatile boolean showShortName

Include the short name ( last component ) of the logger in the log message. Defaults to true - otherwise we'll be lost in a flood of messages without knowing who sends them.

showDateTime

protected static volatile boolean showDateTime

Include the current time in the log message

dateTimeFormat

protected static volatile java.lang.String dateTimeFormat

The date and time format to use in the log message

dateFormatter

protected static java.text.DateFormat dateFormatter

Used to format times.

Any code that accesses this object should first obtain a lock on it, ie use synchronized(dateFormatter); this requirement was introduced in 1.1.1 to fix an existing thread safety bug (SimpleDateFormat.format is not thread-safe).

LOG_LEVEL_TRACE

public static final int LOG_LEVEL_TRACE

"Trace" level logging.

另请参阅:

常量字段值

LOG_LEVEL_DEBUG

public static final int LOG_LEVEL_DEBUG

"Debug" level logging.

另请参阅:

常量字段值

LOG_LEVEL_INFO

public static final int LOG_LEVEL_INFO

"Info" level logging.

另请参阅:

常量字段值

LOG_LEVEL_WARN

public static final int LOG_LEVEL_WARN

"Warn" level logging.

另请参阅:

常量字段值

LOG_LEVEL_ERROR

public static final int LOG_LEVEL_ERROR

"Error" level logging.

另请参阅:

常量字段值

LOG_LEVEL_FATAL

public static final int LOG_LEVEL_FATAL

"Fatal" level logging.

另请参阅:

常量字段值

LOG_LEVEL_ALL

public static final int LOG_LEVEL_ALL

Enable all logging levels

另请参阅:

常量字段值

LOG_LEVEL_OFF

public static final int LOG_LEVEL_OFF

Enable no logging levels

另请参阅:

常量字段值

logName

protected volatile java.lang.String logName

The name of this simple log instance

currentLogLevel

protected volatile int currentLogLevel

The current log level

构造器详细资料

SimpleLog

public SimpleLog(java.lang.String name)

Construct a simple log with given name.

参数:

name - log name

方法详细资料

setLevel

public void setLevel(int currentLogLevel)

Set logging level.

参数:

currentLogLevel - new logging level

getLevel

public int getLevel()

Get logging level.

log

protected void log(int type,
       java.lang.Object message,
       java.lang.Throwable t)

Do the actual logging.

This method assembles the message and then calls write() to cause it to be written.

参数:

category - 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

write

protected void write(java.lang.StringBuffer buffer)

Write the content of the message accumulated in the specified StringBuffer to the appropriate output destination. The default implementation writes to System.err.

参数:

buffer - A StringBuffer containing the accumulated text to be logged

isLevelEnabled

protected boolean isLevelEnabled(int logLevel)

Is the given log level currently enabled?

参数:

logLevel - is this level enabled?

debug

public final void debug(java.lang.Object message)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_DEBUG.

指定者:

debug 在接口中 Log

参数:

message - to log

另请参阅:

Log.debug(Object)

debug

public final void debug(java.lang.Object message,
         java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_DEBUG.

指定者:

debug 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.debug(Object, Throwable)

trace

public final void trace(java.lang.Object message)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_TRACE.

指定者:

trace 在接口中 Log

参数:

message - to log

另请参阅:

Log.trace(Object)

trace

public final void trace(java.lang.Object message,
         java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_TRACE.

指定者:

trace 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.trace(Object, Throwable)

info

public final void info(java.lang.Object message)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_INFO.

指定者:

info 在接口中 Log

参数:

message - to log

另请参阅:

Log.info(Object)

info

public final void info(java.lang.Object message,
        java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_INFO.

指定者:

info 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.info(Object, Throwable)

warn

public final void warn(java.lang.Object message)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_WARN.

指定者:

warn 在接口中 Log

参数:

message - to log

另请参阅:

Log.warn(Object)

warn

public final void warn(java.lang.Object message,
        java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_WARN.

指定者:

warn 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.warn(Object, Throwable)

error

public final void error(java.lang.Object message)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_ERROR.

指定者:

error 在接口中 Log

参数:

message - to log

另请参阅:

Log.error(Object)

error

public final void error(java.lang.Object message,
         java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_ERROR.

指定者:

error 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.error(Object, Throwable)

fatal

public final void fatal(java.lang.Object message)

Log a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_FATAL.

指定者:

fatal 在接口中 Log

参数:

message - to log

另请参阅:

Log.fatal(Object)

fatal

public final void fatal(java.lang.Object message,
         java.lang.Throwable t)

Logs a message with depends.org.apache.commons.logging.impl.SimpleLog.LOG_LEVEL_FATAL.

指定者:

fatal 在接口中 Log

参数:

message - to log

t - log this cause

另请参阅:

Log.fatal(Object, Throwable)

isDebugEnabled

public final boolean isDebugEnabled()

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.

指定者:

isDebugEnabled 在接口中 Log

返回:

true if debug is enabled in the underlying logger.

isErrorEnabled

public final boolean isErrorEnabled()

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.

指定者:

isErrorEnabled 在接口中 Log

返回:

true if error is enabled in the underlying logger.

isFatalEnabled

public final boolean isFatalEnabled()

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.

指定者:

isFatalEnabled 在接口中 Log

返回:

true if fatal is enabled in the underlying logger.

isInfoEnabled

public final boolean isInfoEnabled()

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.

指定者:

isInfoEnabled 在接口中 Log

返回:

true if info is enabled in the underlying logger.

isTraceEnabled

public final boolean isTraceEnabled()

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.

指定者:

isTraceEnabled 在接口中 Log

返回:

true if trace is enabled in the underlying logger.

isWarnEnabled

public final boolean isWarnEnabled()

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.

指定者:

isWarnEnabled 在接口中 Log

返回:

true if warn is enabled in the underlying logger.