Module ch.qos.logback.classic

Package ch.qos.logback.classic

Class Level

java.lang.Object

ch.qos.logback.classic.Level

All Implemented Interfaces:

Serializable

public final class Level
extends Object
implements Serializable

Defines the set of levels recognized by logback-classic, that is OFF, ERROR, WARN, INFO, DEBUG, TRACE and ALL.

The Level class is final and cannot be sub-classed.

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final Level	ALL	Deprecated. with no replacement
static final int	ALL_INT
static final Integer	ALL_INTEGER
static final Level	DEBUG	The DEBUG level designates informational events of lower importance.
static final int	DEBUG_INT
static final Integer	DEBUG_INTEGER
static final Level	ERROR	The ERROR level designates error events which may or not be fatal to the application.
static final int	ERROR_INT
static final Integer	ERROR_INTEGER
static final Level	INFO	The INFO level designates informational messages highlighting overall progress of the application.
static final int	INFO_INT
static final Integer	INFO_INTEGER
final int	levelInt
final String	levelStr
static final Level	OFF	The OFF is used to turn off logging.
static final int	OFF_INT
static final Integer	OFF_INTEGER
static final Level	TRACE	The TRACE level designates informational events of very low importance.
static final int	TRACE_INT
static final Integer	TRACE_INTEGER
static final Level	WARN	The WARN level designates potentially harmful situations.
static final int	WARN_INT
static final Integer	WARN_INTEGER

Method Summary

Modifier and Type	Method	Description
static Level	convertAnSLF4JLevel(org.slf4j.event.Level slf4jLevel)
static Level	fromLocationAwareLoggerInteger(int levelInt)	Convert one of the integer values defined in LocationAwareLogger interface to an instance of this class, i.e.
boolean	isGreaterOrEqual(Level r)	Returns true if this Level has a higher or equal Level than the Level passed as argument, false otherwise.
int	toInt()	Returns the integer representation of this Level.
Integer	toInteger()	Convert a Level to an Integer object.
static Level	toLevel(int val)	Convert an integer passed as argument to a Level.
static Level	toLevel(int val, Level defaultLevel)	Convert an integer passed as argument to a Level.
static Level	toLevel(String sArg)	Convert the string passed as argument to a Level.
static Level	toLevel(String sArg, Level defaultLevel)	Convert the string passed as argument to a Level.
static int	toLocationAwareLoggerInteger(Level level)	Convert this level instance to an integer value defined in the LocationAwareLogger interface.
String	toString()	Returns the string representation of this Level.
static Level	valueOf(String sArg)	This method exists in order to comply with Joran's valueOf convention.

Methods inherited from class java.lang.Object

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

Field Details

OFF_INT

public static final int OFF_INT

See Also:

• Constant Field Values

ERROR_INT

public static final int ERROR_INT

See Also:

• Constant Field Values

WARN_INT

public static final int WARN_INT

See Also:

• Constant Field Values

INFO_INT

public static final int INFO_INT

See Also:

• Constant Field Values

DEBUG_INT

public static final int DEBUG_INT

See Also:

• Constant Field Values

TRACE_INT

public static final int TRACE_INT

See Also:

• Constant Field Values

ALL_INT

public static final int ALL_INT

See Also:

• Constant Field Values

OFF_INTEGER

public static final Integer OFF_INTEGER

ERROR_INTEGER

public static final Integer ERROR_INTEGER

WARN_INTEGER

public static final Integer WARN_INTEGER

INFO_INTEGER

public static final Integer INFO_INTEGER

DEBUG_INTEGER

public static final Integer DEBUG_INTEGER

TRACE_INTEGER

public static final Integer TRACE_INTEGER

ALL_INTEGER

public static final Integer ALL_INTEGER

OFF

public static final Level OFF

The OFF is used to turn off logging. It is intended to be used for logging system configuration. Warning: it should never be passed as an argument to logger methods in a regular log statement.

ERROR

public static final Level ERROR

The ERROR level designates error events which may or not be fatal to the application.

WARN

public static final Level WARN

The WARN level designates potentially harmful situations.

INFO

public static final Level INFO

The INFO level designates informational messages highlighting overall progress of the application.

DEBUG

public static final Level DEBUG

The DEBUG level designates informational events of lower importance.

TRACE

public static final Level TRACE

The TRACE level designates informational events of very low importance.

ALL

public static final Level ALL

Deprecated.

with no replacement

The ALL is used to turn on all logging. The ALL level is vestigial from log4j 1.x.

In logback, where the Level class is final, logging can be turned on for all levels by setting a logger's level to TRACE.

Thus, the ALL level is marked as deprecated.

levelInt

public final int levelInt

levelStr

public final String levelStr

Method Details

toString

public String toString()

Returns the string representation of this Level.

Overrides:

toString in class Object

toInt

public int toInt()

Returns the integer representation of this Level.

convertAnSLF4JLevel

public static Level convertAnSLF4JLevel(org.slf4j.event.Level slf4jLevel)

toInteger

public Integer toInteger()

Convert a Level to an Integer object.

Returns:

This level's Integer mapping.

isGreaterOrEqual

public boolean isGreaterOrEqual(Level r)

Returns true if this Level has a higher or equal Level than the Level passed as argument, false otherwise.

toLevel

public static Level toLevel(String sArg)

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

valueOf

public static Level valueOf(String sArg)

This method exists in order to comply with Joran's valueOf convention.

Parameters:

sArg -

Returns:

toLevel

public static Level toLevel(int val)

Convert an integer passed as argument to a Level. If the conversion fails, then this method returns DEBUG.

toLevel

public static Level toLevel(int val,
 Level defaultLevel)

Convert an integer passed as argument to a Level. If the conversion fails, then this method returns the specified default.

toLevel

public static Level toLevel(String sArg,
 Level defaultLevel)

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

fromLocationAwareLoggerInteger

public static Level fromLocationAwareLoggerInteger(int levelInt)

Convert one of the integer values defined in LocationAwareLogger interface to an instance of this class, i.e. a Level.

Parameters:

levelInt - An integer value representing a level as defined in LocationAwareLogger

Returns:

an instance of this class, i.e. a Level.

Since:

1.0.1

toLocationAwareLoggerInteger

public static int toLocationAwareLoggerInteger(Level level)

Convert this level instance to an integer value defined in the LocationAwareLogger interface.

Parameters:

level - The level to convert to LocationAwareLogger integer

Returns:

int An integer corresponding to this level as defined in LocationAwareLogger

Since:

1.0.1