org.eclipse.jetty.util.log

类 StdErrLog

java.lang.Object

org.eclipse.jetty.util.log.AbstractLogger

org.eclipse.jetty.util.log.StdErrLog

所有已实现的接口:

org.eclipse.jetty.util.log.Logger

@ManagedObject(value="Jetty StdErr Logging Implementation")
public class StdErrLog
extends org.eclipse.jetty.util.log.AbstractLogger

StdErr Logging implementation.

A Jetty Logger that sends all logs to STDERR (System.err) with basic formatting.

Supports named loggers, and properties based configuration.

Configuration Properties:

${name|hierarchy}.LEVEL=(ALL|DEBUG|INFO|WARN|OFF)

Sets the level that the Logger should log at.
Names can be a package name, or a fully qualified class name.
Default: INFO

Examples:

org.eclipse.jetty.LEVEL=WARN

indicates that all of the jetty specific classes, in any package that starts with org.eclipse.jetty should log at level WARN.

org.eclipse.jetty.io.ChannelEndPoint.LEVEL=ALL

indicates that the specific class, ChannelEndPoint, should log all logging events that it can generate, including DEBUG, INFO, WARN (and even special internally ignored exception cases).

${name}.SOURCE=(true|false)

Logger specific, attempt to print the java source file name and line number where the logging event originated from.
Name must be a fully qualified class name (package name hierarchy is not supported by this configurable)
Warning: this is a slow operation and will have an impact on performance!
Default: false

${name}.STACKS=(true|false)

Logger specific, control the display of stacktraces.
Name must be a fully qualified class name (package name hierarchy is not supported by this configurable)
Default: true

org.eclipse.jetty.util.log.stderr.SOURCE=(true|false)

Special Global Configuration, attempt to print the java source file name and line number where the logging event originated from.
Default: false

org.eclipse.jetty.util.log.stderr.LONG=(true|false)

Special Global Configuration, when true, output logging events to STDERR using long form, fully qualified class names. when false, use abbreviated package names
Default: false

org.eclipse.jetty.util.log.stderr.ESCAPE=(true|false)

Global Configuration, when true output logging events to STDERR are always escaped so that control characters are replaced with '?"; '\r' with '<' and '\n' replaced '|'
Default: true

字段概要

字段

限定符和类型	字段和说明
protected String	_abbrevname

从类继承的字段 org.eclipse.jetty.util.log.AbstractLogger

LEVEL_ALL, LEVEL_DEBUG, LEVEL_DEFAULT, LEVEL_INFO, LEVEL_OFF, LEVEL_WARN

构造器概要

构造器

构造器和说明
StdErrLog() Construct an anonymous StdErrLog (no name).
StdErrLog(String name) Construct a named StdErrLog using the Log defined properties
StdErrLog(String name, Properties props) Construct a named Logger using the provided properties to configure logger.

方法概要

限定符和类型	方法和说明
void	debug(String msg, long arg)
void	debug(String msg, Object... args)
void	debug(String msg, Throwable thrown)
void	debug(Throwable thrown)
protected void	format(StringBuilder buffer, Throwable thrown)
protected void	format(StringBuilder buffer, Throwable thrown, String indent)
int	getLevel()
static StdErrLog	getLogger(Class<?> clazz) Obtain a StdErrLog reference for the specified class, a convenience method used most often during testing to allow for control over a specific logger.
static int	getLoggingLevel(Properties props, String name)
String	getName()
void	ignore(Throwable ignored)
void	info(String msg, Object... args)
void	info(String msg, Throwable thrown)
void	info(Throwable thrown)
boolean	isDebugEnabled()
boolean	isHideStacks()
boolean	isPrintLongNames()
boolean	isSource() Is the source of a log, logged
protected org.eclipse.jetty.util.log.Logger	newLogger(String fullname) Create a Child Logger of this Logger.
void	setDebugEnabled(boolean enabled) Legacy interface where a programmatic configuration of the logger level is done as a wholesale approach.
void	setHideStacks(boolean hideStacks)
void	setLevel(int level) Set the level for this logger.
void	setPrintLongNames(boolean printLongNames)
void	setSource(boolean source) Set if a log source is logged.
void	setStdErrStream(PrintStream stream)
static void	setTagPad(int pad)
String	toString()
void	warn(String msg, Object... args)
void	warn(String msg, Throwable thrown)
void	warn(Throwable thrown)

从类继承的方法 org.eclipse.jetty.util.log.AbstractLogger

condensePackageString, getLevelId, getLogger, getLoggingProperty, lookupLoggingLevel

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

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

字段详细资料

_abbrevname

protected final String _abbrevname

构造器详细资料

StdErrLog

public StdErrLog()

Construct an anonymous StdErrLog (no name).

NOTE: Discouraged usage!

StdErrLog

public StdErrLog(String name)

Construct a named StdErrLog using the Log defined properties

参数:

name - the name of the logger

StdErrLog

public StdErrLog(String name,
                 Properties props)

Construct a named Logger using the provided properties to configure logger.

参数:

name - the name of the logger

props - the configuration properties

方法详细资料

setTagPad

public static void setTagPad(int pad)

getLoggingLevel

public static int getLoggingLevel(Properties props,
                                  String name)

getLogger

public static StdErrLog getLogger(Class<?> clazz)

Obtain a StdErrLog reference for the specified class, a convenience method used most often during testing to allow for control over a specific logger.

Must be actively using StdErrLog as the Logger implementation.

参数:

clazz - the Class reference for the logger to use.

返回:

the StdErrLog logger

抛出:

RuntimeException - if StdErrLog is not the active Logger implementation.

getName

public String getName()

setPrintLongNames

public void setPrintLongNames(boolean printLongNames)

isPrintLongNames

public boolean isPrintLongNames()

isHideStacks

public boolean isHideStacks()

setHideStacks

public void setHideStacks(boolean hideStacks)

isSource

public boolean isSource()

Is the source of a log, logged

返回:

true if the class, method, file and line number of a log is logged.

setSource

public void setSource(boolean source)

Set if a log source is logged.

参数:

source - true if the class, method, file and line number of a log is logged.

warn

public void warn(String msg,
                 Object... args)

warn

public void warn(Throwable thrown)

warn

public void warn(String msg,
                 Throwable thrown)

info

public void info(String msg,
                 Object... args)

info

public void info(Throwable thrown)

info

public void info(String msg,
                 Throwable thrown)

isDebugEnabled

@ManagedAttribute(value="is debug enabled for root logger Log.LOG")
public boolean isDebugEnabled()

setDebugEnabled

public void setDebugEnabled(boolean enabled)

Legacy interface where a programmatic configuration of the logger level is done as a wholesale approach.

getLevel

public int getLevel()

setLevel

public void setLevel(int level)

Set the level for this logger.

Available values (AbstractLogger.LEVEL_ALL, AbstractLogger.LEVEL_DEBUG, AbstractLogger.LEVEL_INFO, AbstractLogger.LEVEL_WARN)

参数:

level - the level to set the logger to

setStdErrStream

public void setStdErrStream(PrintStream stream)

debug

public void debug(String msg,
                  Object... args)

debug

public void debug(String msg,
                  long arg)

指定者:

debug 在接口中 org.eclipse.jetty.util.log.Logger

覆盖:

debug 在类中 org.eclipse.jetty.util.log.AbstractLogger

debug

public void debug(Throwable thrown)

debug

public void debug(String msg,
                  Throwable thrown)

format

protected void format(StringBuilder buffer,
                      Throwable thrown)

format

protected void format(StringBuilder buffer,
                      Throwable thrown,
                      String indent)

newLogger

protected org.eclipse.jetty.util.log.Logger newLogger(String fullname)

Create a Child Logger of this Logger.

指定者:

newLogger 在类中 org.eclipse.jetty.util.log.AbstractLogger

toString

public String toString()

覆盖:

toString 在类中 Object

ignore

public void ignore(Throwable ignored)