de.lmu.ifi.dbs.elki.logging

Class LoggingConfiguration

java.lang.Object

de.lmu.ifi.dbs.elki.logging.LoggingConfiguration

public final class LoggingConfiguration
extends Object

Facility for configuration of logging.

Author:

Erich Schubert

Field Summary

Fields

Modifier and Type	Field and Description
private static String	confbase Configuration base
protected static LoggingConfiguration	config Static instance of the configuration
static boolean	DEBUG General debug flag.
private static Logger	LOGGER_ELKI_TOP Logger for ELKI top level package.
private static Logger	LOGGER_GLOBAL_TOP Top level logger.
private static Logger	LOGGER_TIME_TOP Logger for ELKI timing.
private static String	LOGGING_PROPERTIES_FILE Configuration file name
private static String	TOPLEVEL_PACKAGE Top level ELKI package (for setting 'verbose')

Constructor Summary

Constructors

Modifier	Constructor and Description
private	LoggingConfiguration(String pkg, String name) Configure Java Logging API: LogManager

Method Summary

Methods

Modifier and Type	Method and Description
static void	addHandler(Handler handler) Add a handler to the root logger.
static void	assertConfigured() Assert that logging was configured.
private void	privateReconfigureLogging(String pkg, String name) Reconfigure logging.
static void	reconfigureLogging(String pkg, String name) Reconfigure logging.
static void	replaceDefaultHandler(Handler handler) Replace the default log handler with the given log handler.
static void	setDefaultLevel(Level level) Set the default level.
static void	setLevelFor(String pkg, String level) Set the logging level for a particular package/class.
static void	setStatistics() Enable runtime performance logging.
static void	setVerbose(Level verbose) Reconfigure logging to enable 'verbose' logging at the top level.

Methods inherited from class java.lang.Object

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

Field Detail

DEBUG

public static boolean DEBUG

General debug flag.

LOGGING_PROPERTIES_FILE

private static final String LOGGING_PROPERTIES_FILE

Configuration file name

See Also:

Constant Field Values

TOPLEVEL_PACKAGE

private static final String TOPLEVEL_PACKAGE

Top level ELKI package (for setting 'verbose')

See Also:

Constant Field Values

LOGGER_GLOBAL_TOP

private static final Logger LOGGER_GLOBAL_TOP

Top level logger.

LOGGER_ELKI_TOP

private static final Logger LOGGER_ELKI_TOP

Logger for ELKI top level package.

LOGGER_TIME_TOP

private static final Logger LOGGER_TIME_TOP

Logger for ELKI timing.

confbase

private static final String confbase

Configuration base

config

protected static LoggingConfiguration config

Static instance of the configuration

Constructor Detail

LoggingConfiguration

private LoggingConfiguration(String pkg,
                    String name)

Configure Java Logging API: LogManager

Method Detail

reconfigureLogging

public static void reconfigureLogging(String pkg,
                      String name)

Reconfigure logging.

Parameters:

pkg - Package name the configuration file comes from

name - File name.

privateReconfigureLogging

private void privateReconfigureLogging(String pkg,
                             String name)

Reconfigure logging.

Parameters:

pkg - Package name the configuration file comes from

name - File name.

assertConfigured

public static void assertConfigured()

Assert that logging was configured.

setVerbose

public static void setVerbose(Level verbose)

Reconfigure logging to enable 'verbose' logging at the top level.

Parameters:

verbose - verbosity level.

setStatistics

public static void setStatistics()

Enable runtime performance logging.

addHandler

public static void addHandler(Handler handler)

Add a handler to the root logger.

Parameters:

handler - Handler

replaceDefaultHandler

public static void replaceDefaultHandler(Handler handler)

Replace the default log handler with the given log handler. This will remove all CLISmartHandler found on the root logger. It will leave any other handlers in place.

Parameters:

handler - Logging handler.

setLevelFor

public static void setLevelFor(String pkg,
               String level)
                        throws IllegalArgumentException

Set the logging level for a particular package/class.

Parameters:

pkg - Package

level - Level name

Throws:

IllegalArgumentException - thrown when logger or level was not found

setDefaultLevel

public static void setDefaultLevel(Level level)

Set the default level.

Parameters:

level - level