xdev.util.logging

Class LoggingConfiguration

java.lang.Object

xdev.util.logging.LoggingConfiguration

public class LoggingConfiguration
extends Object

SystemProperty: xdev.util.logging.config.file

This class is necessary due to a JDK bug / spec flaw, that requires that a absolute path for java.util.logging.config.file system property. A relative path is required in most environments. This class provides tools to read a log configuration from a relative path.

The log-Levels you can use in the properties file are:

• SEVERE (highest)
• WARNING
• INFO
• CONFIG
• FINE
• FINER
• FINEST (lowest)

The LoggingConfiguration supports following properties, which must be set in the System properties. To change the properties in Runtime in a type-safe manner you may use the StringSystemProperty reference hold by SYSTEM_PROPERTY_CONFIG_FILE.

Name	Type	Description
xdev.util.logging.config.file	String	The xdev.util.logging.config.file System property can be used to specify a properties file (in java.util.Properties format). The initial logging configuration will be read from this file. If the property is not defined then, the LogManager will read its initial configuration from a properties file "lib/logging.properties" in the JRE directory.

Since:

3.2

Author:

XDEV Software (RHHF)

See Also:

LogManager

Field Summary

Fields

Modifier and Type	Field and Description
static StringSystemProperty	SYSTEM_PROPERTY_CONFIG_FILE The xdev.util.logging.config.file System property can be used to specify a properties file (in java.util.Properties format).

Constructor Summary

Constructors

Constructor and Description
LoggingConfiguration()

Method Summary

Modifier and Type	Method and Description
static void	readConfiguration() Reinitialize the logging properties and reread the logging configuration.
static void	readConfiguration(String path) Reinitialize the logging properties and reread the logging configuration from the given path, which should be in java.util.Properties format.

Methods inherited from class java.lang.Object

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

Field Detail

SYSTEM_PROPERTY_CONFIG_FILE

public static final StringSystemProperty SYSTEM_PROPERTY_CONFIG_FILE

The xdev.util.logging.config.file System property can be used to specify a properties file (in java.util.Properties format). The initial logging configuration will be read from this file. If the property is not defined then, the LogManager will read its initial configuration from a properties file "lib/logging.properties" in the JRE directory.

Constructor Detail

LoggingConfiguration

public LoggingConfiguration()

Method Detail

readConfiguration

public static void readConfiguration(String path)
                              throws SecurityException

Reinitialize the logging properties and reread the logging configuration from the given path, which should be in java.util.Properties format. A PropertyChangeEvent will be fired after the properties are read.

Any log level definitions in the new configuration file will be applied using Logger.setLevel(), if the target Logger exists.

Parameters:

path - relative path to a properties file (in java.util.Properties format) to read properties from

Throws:

SecurityException - if a security manager exists and if the caller does not have LoggingPermission("control").

readConfiguration

public static void readConfiguration()

Reinitialize the logging properties and reread the logging configuration.

The same rules are used for locating the configuration properties as are used at startup (SYSTEM_PROPERTY_CONFIG_FILE). So normally the logging properties will be re-read from the same file that was used at startup.

Any log level definitions in the new configuration file will be applied using Logger.setLevel(), if the target Logger exists.

This method may do nothing if SYSTEM_PROPERTY_CONFIG_FILE is null or empty.

A PropertyChangeEvent will be fired after the properties are read.

See Also:

SYSTEM_PROPERTY_CONFIG_FILE