Package org.apache.log4j

Class Category

java.lang.Object

org.apache.log4j.Category

Direct Known Subclasses:

Logger

public class Category
extends java.lang.Object

This class is a minimal implementation of the original org.apache.log4j.Category class (as found in log4j 1.2) by delegation of all calls to a Logger instance.

Log4j's trace, debug(), info(), warn(), error() printing methods are directly mapped to their SLF4J equivalents. Log4j's fatal() printing method is mapped to SLF4J's error() method with a FATAL marker.

Field Summary

Fields

Modifier and Type	Field	Description
private static java.lang.String	CATEGORY_FQCN
private static Marker	FATAL_MARKER
private LocationAwareLogger	locationAwareLogger
private java.lang.String	name
protected Logger	slf4jLogger

Constructor Summary

Constructors

Constructor	Description
Category(java.lang.String name)

Method Summary

Modifier and Type	Method	Description
void	addAppender(Appender newAppender)
void	assertLog(boolean assertion, java.lang.String msg)
protected java.lang.String	convertToString(java.lang.Object message)
void	debug(java.lang.Object message)	Delegates to Logger.debug(String) method of SLF4J.
void	debug(java.lang.Object message, java.lang.Throwable t)	Delegates to Logger.debug(String,Throwable) method in SLF4J.
(package private) void	differentiatedLog(Marker marker, java.lang.String fqcn, int level, java.lang.Object message, java.lang.Throwable t)
void	error(java.lang.Object message)	Delegates to Logger.error(String) method in SLF4J.
void	error(java.lang.Object message, java.lang.Throwable t)	Delegates to Logger.error(String,Throwable) method in SLF4J.
void	fatal(java.lang.Object message)	Delegates to Logger.error(String) method in SLF4J.
void	fatal(java.lang.Object message, java.lang.Throwable t)	Delegates to Logger.error(String,Throwable) method in SLF4J.
protected void	forcedLog(java.lang.String FQCN, Priority p, java.lang.Object msg, java.lang.Throwable t)
boolean	getAdditivity()
java.util.Enumeration	getAllAppenders()
Appender	getAppender(java.lang.String name)
Level	getEffectiveLevel()	Return the level in effect for this category/logger.
static Category	getInstance(java.lang.Class clazz)
static Category	getInstance(java.lang.String name)
Level	getLevel()	Returns the assigned Level, if any, for this Category.
java.lang.String	getName()	Returns the obvious.
Category	getParent()
Level	getPriority()	Deprecated. Please use getLevel() instead.
void	info(java.lang.Object message)	Delegates to Logger.info(String) method in SLF4J.
void	info(java.lang.Object message, java.lang.Throwable t)	Delegates to Logger.info(String,Throwable) method in SLF4J.
boolean	isDebugEnabled()	Delegates to Logger.isDebugEnabled() method in SLF4J
boolean	isEnabledFor(Priority p)	Determines whether the priority passed as parameter is enabled in the underlying SLF4J logger.
boolean	isErrorEnabled()	Delegates to Logger.isErrorEnabled() method in SLF4J
boolean	isInfoEnabled()	Delegates to Logger.isInfoEnabled() method in SLF4J
boolean	isWarnEnabled()	Delegates to Logger.isWarnEnabled() method in SLF4J
void	log(java.lang.String FQCN, Priority p, java.lang.Object msg, java.lang.Throwable t)
void	log(Priority p, java.lang.Object message)
void	log(Priority p, java.lang.Object message, java.lang.Throwable t)
private int	priorityToLevelInt(Priority p)
void	setAdditivity(boolean additive)
void	setLevel(Level level)
void	warn(java.lang.Object message)	Delegates to Logger.warn(String) method in SLF4J.
void	warn(java.lang.Object message, java.lang.Throwable t)	Delegates to Logger.warn(String,Throwable) method in SLF4J.

Methods inherited from class java.lang.Object

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

Field Detail

CATEGORY_FQCN

private static final java.lang.String CATEGORY_FQCN

name

private java.lang.String name

slf4jLogger

protected Logger slf4jLogger

locationAwareLogger

private LocationAwareLogger locationAwareLogger

FATAL_MARKER

private static Marker FATAL_MARKER

Constructor Detail

Category

Category(java.lang.String name)

Method Detail

getInstance

public static Category getInstance(java.lang.Class clazz)

getInstance

public static Category getInstance(java.lang.String name)

getParent

public final Category getParent()

getName

public java.lang.String getName()

Returns the obvious.

Returns:

getAppender

public Appender getAppender(java.lang.String name)

getAllAppenders

public java.util.Enumeration getAllAppenders()

getEffectiveLevel

public Level getEffectiveLevel()

Return the level in effect for this category/logger.

The result is computed by simulation.

Returns:

getLevel

public final Level getLevel()

Returns the assigned Level, if any, for this Category. This implementation always returns null.

Returns:

Level - the assigned Level, can be null.

getPriority

public final Level getPriority()

Deprecated.

Please use getLevel() instead.

isDebugEnabled

public boolean isDebugEnabled()

Delegates to Logger.isDebugEnabled() method in SLF4J

isInfoEnabled

public boolean isInfoEnabled()

Delegates to Logger.isInfoEnabled() method in SLF4J

isWarnEnabled

public boolean isWarnEnabled()

Delegates to Logger.isWarnEnabled() method in SLF4J

isErrorEnabled

public boolean isErrorEnabled()

Delegates to Logger.isErrorEnabled() method in SLF4J

isEnabledFor

public boolean isEnabledFor(Priority p)

Determines whether the priority passed as parameter is enabled in the underlying SLF4J logger. Each log4j priority is mapped directly to its SLF4J equivalent, except for FATAL which is mapped as ERROR.

Parameters:

p - the priority to check against

Returns:

true if this logger is enabled for the given level, false otherwise.

differentiatedLog

void differentiatedLog(Marker marker,
                       java.lang.String fqcn,
                       int level,
                       java.lang.Object message,
                       java.lang.Throwable t)

debug

public void debug(java.lang.Object message)

Delegates to Logger.debug(String) method of SLF4J.

debug

public void debug(java.lang.Object message,
                  java.lang.Throwable t)

Delegates to Logger.debug(String,Throwable) method in SLF4J.

info

public void info(java.lang.Object message)

Delegates to Logger.info(String) method in SLF4J.

info

public void info(java.lang.Object message,
                 java.lang.Throwable t)

Delegates to Logger.info(String,Throwable) method in SLF4J.

warn

public void warn(java.lang.Object message)

Delegates to Logger.warn(String) method in SLF4J.

warn

public void warn(java.lang.Object message,
                 java.lang.Throwable t)

Delegates to Logger.warn(String,Throwable) method in SLF4J.

error

public void error(java.lang.Object message)

Delegates to Logger.error(String) method in SLF4J.

error

public void error(java.lang.Object message,
                  java.lang.Throwable t)

Delegates to Logger.error(String,Throwable) method in SLF4J.

fatal

public void fatal(java.lang.Object message)

Delegates to Logger.error(String) method in SLF4J.

fatal

public void fatal(java.lang.Object message,
                  java.lang.Throwable t)

Delegates to Logger.error(String,Throwable) method in SLF4J. In addition, the call is marked with a marker named "FATAL".

forcedLog

protected void forcedLog(java.lang.String FQCN,
                         Priority p,
                         java.lang.Object msg,
                         java.lang.Throwable t)

log

public void log(java.lang.String FQCN,
                Priority p,
                java.lang.Object msg,
                java.lang.Throwable t)

log

public void log(Priority p,
                java.lang.Object message,
                java.lang.Throwable t)

log

public void log(Priority p,
                java.lang.Object message)

priorityToLevelInt

private int priorityToLevelInt(Priority p)

convertToString

protected final java.lang.String convertToString(java.lang.Object message)

setAdditivity

public void setAdditivity(boolean additive)

addAppender

public void addAppender(Appender newAppender)

setLevel

public void setLevel(Level level)

getAdditivity

public boolean getAdditivity()

assertLog

public void assertLog(boolean assertion,
                      java.lang.String msg)