Package org.apache.log4j

Class Level

java.lang.Object

org.apache.log4j.Priority

org.apache.log4j.Level

All Implemented Interfaces:

Serializable

public class Level
extends Priority
implements Serializable

Defines the minimum set of levels recognized by the system, that is OFF, FATAL, ERROR, WARN, INFO, DEBUG and ALL.

The Level class may be subclassed to define a larger level set.

Author:

Ceki Gülcü

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final Level	ALL	The ALL has the lowest possible rank and is intended to turn on all logging.
static final Level	DEBUG	The DEBUG Level designates fine-grained informational events that are most useful to debug an application.
static final Level	ERROR	The ERROR level designates error events that might still allow the application to continue running.
static final Level	FATAL	The FATAL level designates very severe error events that will presumably lead the application to abort.
static final Level	INFO	The INFO level designates informational messages that highlight the progress of the application at coarse-grained level.
static final Level	OFF	The OFF has the highest possible rank and is intended to turn off logging.
static final Level	TRACE	The TRACE Level designates finer-grained informational events than the DEBUG level.
static final int	TRACE_INT	TRACE level integer value.
static final Level	WARN	The WARN level designates potentially harmful situations.
static final int	X_TRACE_INT

Fields inherited from class org.apache.log4j.Priority

ALL_INT, DEBUG_INT, ERROR_INT, FATAL_INT, INFO_INT, OFF_INT, WARN_INT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Level(int level, String levelStr, int syslogEquivalent)	Instantiate a Level object.

Method Summary

Modifier and Type	Method	Description
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.

Methods inherited from class org.apache.log4j.Priority

equals, getAllPossiblePriorities, getSyslogEquivalent, isGreaterOrEqual, toInt, toPriority, toPriority, toPriority, toPriority, toString

Methods inherited from class java.lang.Object

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

Field Details

TRACE_INT

public static final int TRACE_INT

TRACE level integer value.

Since:

1.2.12

See Also:

• Constant Field Values

X_TRACE_INT

public static final int X_TRACE_INT

See Also:

• Constant Field Values

OFF

public static final Level OFF

The OFF has the highest possible rank and is intended to turn off logging.

FATAL

public static final Level FATAL

The FATAL level designates very severe error events that will presumably lead the application to abort.

ERROR

public static final Level ERROR

The ERROR level designates error events that might still allow the application to continue running.

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 that highlight the progress of the application at coarse-grained level.

DEBUG

public static final Level DEBUG

The DEBUG Level designates fine-grained informational events that are most useful to debug an application.

TRACE

public static final Level TRACE

The TRACE Level designates finer-grained informational events than the DEBUG level.

Since:

1.2.12

ALL

public static final Level ALL

The ALL has the lowest possible rank and is intended to turn on all logging.

Constructor Details

Level

protected Level(int level,
 String levelStr,
 int syslogEquivalent)

Instantiate a Level object.

Parameters:

level - a level

levelStr - a level string

syslogEquivalent - the Syslog equivalent

Method Details

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.

Parameters:

sArg - a string

Returns:

corresponding Level

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.

Parameters:

val - an int

Returns:

a level

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.

Parameters:

val - a value

defaultLevel - a defaultLevel

Returns:

corresponding Level

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.

Parameters:

sArg - a string

defaultLevel - a default level

Returns:

corresponding level