org.eclipse.jetty.util.log

Class Log

java.lang.Object

org.eclipse.jetty.util.log.Log

public class Log
extends Object

Logging. This class provides a static logging interface. If an instance of the org.slf4j.Logger class is found on the classpath, the static log methods are directed to a slf4j logger for "org.eclipse.log". Otherwise the logs are directed to stderr.

The "org.eclipse.jetty.util.log.class" system property can be used to select a specific logging implementation.

If the system property org.eclipse.jetty.util.log.IGNORED is set, then ignored exceptions are logged in detail.

See Also:

StdErrLog, Slf4jLog

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	__ignored Legacy flag indicating if Logger.ignore(Throwable) methods produce any output in the Loggers
static String	__logClass The Logger implementation class name
protected static Properties	__props Logging Configuration Properties
static String	EXCEPTION
static String	IGNORED

Constructor Summary

Constructors

Constructor and Description
Log()

Method Summary

Methods

Modifier and Type	Method and Description
static Logger	getLog()
static Logger	getLogger(Class<?> clazz) Obtain a named Logger based on the fully qualified class name.
static Logger	getLogger(String name) Obtain a named Logger or the default Logger if null is passed.
static Map<String,Logger>	getLoggers() Get a map of all configured Logger instances.
static Logger	getRootLogger() Get the root logger.
static void	initialized()
static void	setLog(Logger log)
static void	setLogToParent(String name) Set Log to parent Logger.

Methods inherited from class java.lang.Object

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

Field Detail

EXCEPTION

public static final String EXCEPTION

See Also:

Constant Field Values

IGNORED

public static final String IGNORED

See Also:

Constant Field Values

__props

protected static final Properties __props

Logging Configuration Properties

__logClass

public static String __logClass

The Logger implementation class name

__ignored

public static boolean __ignored

Legacy flag indicating if Logger.ignore(Throwable) methods produce any output in the Loggers

Constructor Detail

Log

public Log()

Method Detail

initialized

public static void initialized()

getLog

public static Logger getLog()

setLog

public static void setLog(Logger log)

getRootLogger

public static Logger getRootLogger()

Get the root logger.

Returns:

the root logger

setLogToParent

public static void setLogToParent(String name)

Set Log to parent Logger.

If there is a different Log class available from a parent classloader, call getLogger(String) on it and construct a LoggerLog instance as this Log's Logger, so that logging is delegated to the parent Log.

This should be used if a webapp is using Log, but wishes the logging to be directed to the containers log.

If there is not parent Log, then this call is equivalent to

   Log.setLog(Log.getLogger(name));
 

Parameters:

name - Logger name

getLogger

public static Logger getLogger(Class<?> clazz)

Obtain a named Logger based on the fully qualified class name.

Parameters:

clazz - the class to base the Logger name off of

Returns:

the Logger with the given name

getLogger

public static Logger getLogger(String name)

Obtain a named Logger or the default Logger if null is passed.

Parameters:

name - the Logger name

Returns:

the Logger with the given name

getLoggers

@ManagedAttribute(value="list of all instantiated loggers")
public static Map<String,Logger> getLoggers()

Get a map of all configured Logger instances.

Returns:

a map of all configured Logger instances