org.apache.logging.log4j
Class Level

java.lang.Object
  org.apache.logging.log4j.Level

All Implemented Interfaces:

Serializable, Comparable<Level>

public final class Level
extends Object
implements Comparable<Level>, Serializable

Levels used for identifying the severity of an event. Levels are organized from most specific to least:

• OFF (most specific, no logging)
• FATAL (most specific, little data)
• ERROR
• WARN
• INFO
• DEBUG
• TRACE (least specific, a lot of data)
• ALL (least specific, all data)

Typically, configuring a level in a filter or on a logger will cause logging events of that level and those that are more specific to pass through the filter. A special level, ALL, is guaranteed to capture all levels when used in logging configurations.

See Also:

Serialized Form

Field Summary

static Level	ALL All events should be logged.
static Level	DEBUG A general debugging event.
static Level	ERROR An error in the application, possibly recoverable.
static Level	FATAL A severe error that will prevent the application from continuing.
static Level	INFO An event for informational purposes.
static Level	OFF No events will be logged.
static Level	TRACE A fine-grained debug message, typically capturing the flow through the application.
static Level	WARN An event that might possible lead to an error.

Method Summary

Level	clone()
int	compareTo(Level other)
boolean	equals(Object other)
static Level	forName(String name, int intValue) Retrieves an existing Level or creates on if it didn't previously exist.
Class<Level>	getDeclaringClass()
static Level	getLevel(String name) Return the Level associated with the name or null if the Level cannot be found.
StandardLevel	getStandardLevel()
int	hashCode()
int	intLevel()
boolean	isLessSpecificThan(Level level) Compares this level against the level passed as an argument and returns true if this level is the same or is less specific.T
boolean	isMoreSpecificThan(Level level) Compares this level against the level passed as an argument and returns true if this level is the same or is more specific.
String	name()
protected Object	readResolve()
static Level	toLevel(String sArg) Converts the string passed as argument to a level.
static Level	toLevel(String name, Level defaultLevel) Converts the string passed as argument to a level.
String	toString()
static <T extends Enum<T>> T	valueOf(Class<T> enumType, String name)
static Level	valueOf(String name) Return the Level associated with the name.
static Level[]	values() Return an array of all the Levels that have been registered.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

OFF

public static final Level OFF

No events will be logged.

FATAL

public static final Level FATAL

A severe error that will prevent the application from continuing.

ERROR

public static final Level ERROR

An error in the application, possibly recoverable.

WARN

public static final Level WARN

An event that might possible lead to an error.

INFO

public static final Level INFO

An event for informational purposes.

DEBUG

public static final Level DEBUG

A general debugging event.

TRACE

public static final Level TRACE

A fine-grained debug message, typically capturing the flow through the application.

ALL

public static final Level ALL

All events should be logged.

Method Detail

intLevel

public int intLevel()

getStandardLevel

public StandardLevel getStandardLevel()

isLessSpecificThan

public boolean isLessSpecificThan(Level level)

Compares this level against the level passed as an argument and returns true if this level is the same or is less specific.T

Parameters:

level - The level to test.

Returns:

True if this level Level is less specific or the same as the given Level.

isMoreSpecificThan

public boolean isMoreSpecificThan(Level level)

Compares this level against the level passed as an argument and returns true if this level is the same or is more specific.

Parameters:

level - The level to test.

Returns:

True if this level Level is more specific or the same as the given Level.

clone

public Level clone()
            throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException

compareTo

public int compareTo(Level other)

Specified by:

compareTo in interface Comparable<Level>

equals

public boolean equals(Object other)

Overrides:

equals in class Object

getDeclaringClass

public Class<Level> getDeclaringClass()

hashCode

public int hashCode()

Overrides:

hashCode in class Object

name

public String name()

toString

public String toString()

Overrides:

toString in class Object

forName

public static Level forName(String name,
                            int intValue)

Retrieves an existing Level or creates on if it didn't previously exist.

Parameters:

name - The name of the level.

intValue - The integer value for the Level. If the level was previously created this value is ignored.

Returns:

The Level.

Throws:

IllegalArgumentException - if the name is null or intValue is less than zero.

getLevel

public static Level getLevel(String name)

Return the Level associated with the name or null if the Level cannot be found.

Parameters:

name - The name of the Level.

Returns:

The Level or null.

toLevel

public static Level toLevel(String sArg)

Converts the string passed as argument to a level. If the conversion fails, then this method returns DEBUG.

Parameters:

sArg - The name of the desired Level.

Returns:

The Level associated with the String.

toLevel

public static Level toLevel(String name,
                            Level defaultLevel)

Converts the string passed as argument to a level. If the conversion fails, then this method returns the value of defaultLevel.

Parameters:

name - The name of the desired Level.

defaultLevel - The Level to use if the String is invalid.

Returns:

The Level associated with the String.

values

public static Level[] values()

Return an array of all the Levels that have been registered.

Returns:

An array of Levels.

valueOf

public static Level valueOf(String name)

Return the Level associated with the name.

Parameters:

name - The name of the Level to return.

Returns:

The Level.

Throws:

NullPointerException - if the Level name is null.

IllegalArgumentException - if the Level name is not registered.

valueOf

public static <T extends Enum<T>> T valueOf(Class<T> enumType,
                                            String name)

readResolve

protected Object readResolve()