Package pl.morgwai.base.logging

Class JulConfig

java.lang.Object

pl.morgwai.base.logging.JulConfig

public class JulConfig
extends Object

Utility to override java.util.logging properties with values from system properties.

Note: overriding can be applied to an existing java app at run time: just add java-utils jar to the class-path and define desired system properties.

See Also:

overrideLogLevels(String...)

Field Summary

Fields

Modifier and Type	Field	Description
static String	JUL_CONFIG_CLASS_PROPERTY_NAME	"java.util.logging.config.class"
static String	LEVEL_SUFFIX	".level"
static String	OVERRIDE_LEVEL_PROPERTY_NAME	Name of the system property that can contain comma separated, fully qualified names of Loggers and Handlers whose Levels will be overridden by overrideLogLevels(String...).

Constructor Summary

Constructors

Constructor	Description
JulConfig()	Reads logging config normally and then calls overrideLogLevels(String...).

Method Summary

Modifier and Type	Method	Description
static void	overrideLogLevels(String... names)	Overrides Levels of java.util.logging Loggers and Handlers with values obtained from system properties.

Methods inherited from class java.lang.Object

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

Field Detail

OVERRIDE_LEVEL_PROPERTY_NAME

public static final String OVERRIDE_LEVEL_PROPERTY_NAME

Name of the system property that can contain comma separated, fully qualified names of Loggers and Handlers whose Levels will be overridden by overrideLogLevels(String...).

See Also:

Constant Field Values

LEVEL_SUFFIX

public static final String LEVEL_SUFFIX

".level"

See Also:

Constant Field Values

JUL_CONFIG_CLASS_PROPERTY_NAME

public static final String JUL_CONFIG_CLASS_PROPERTY_NAME

"java.util.logging.config.class"

See Also:

Constant Field Values

Constructor Detail

JulConfig

public JulConfig()
          throws Exception

Reads logging config normally and then calls overrideLogLevels(String...). For use with "java.util.logging.config.class" system property.

Throws:

Exception

See Also:

LogManager

Method Detail

overrideLogLevels

public static void overrideLogLevels(String... names)

Overrides Levels of java.util.logging Loggers and Handlers with values obtained from system properties.

Fully qualified names of Loggers and Handlers whose Levels should be overridden by this method are provided as arguments to this method and/or comma separated on "java.util.logging.overrideLevel" system property.
Name of the system property containing the new Level for a given Logger/Handler is constructed by appending ".level" to its fully-qualified-name. If a system property with a new Level is missing, it is ignored. If it is present, its validity is verified using Level.parse(String) method.

Example:
Output all entries from com.example name-space with level FINE or higher to the console. Entries from other name-spaces will be logged only if they have at least level WARNING, unless configured otherwise in the default logging.properties file:

java -Djava.util.logging.config.class=pl.morgwai.base.logging.JulConfig \
     -Djava.util.logging.overrideLevel=,com.example,java.util.logging.ConsoleHandler \
     -D.level=WARNING \
     -Dcom.example.level=FINE \
     -Djava.util.logging.ConsoleHandler.level=FINE \
     com.example.someproject.MainClass