Category (Log4j 1.2 API for tinylog 2.3.0 API)

java.lang.Object
- org.apache.log4j.Category

Direct Known Subclasses:

Logger
```
public class Category
extends java.lang.Object
```
This class has been deprecated and replaced by the Logger subclass. It will be kept around to preserve backward compatibility until mid 2003.
Logger is a subclass of Category, i.e. it extends Category. In other words, a logger is a category. Thus, all operations that can be performed on a category can be performed on a logger. Internally, whenever log4j is asked to produce a Category object, it will instead produce a Logger object. Log4j 1.2 will never produce Category objects but only Logger instances. In order to preserve backward compatibility, methods that previously accepted category objects still continue to accept category objects.

For example, the following are all legal and will work as expected.
```
    // Deprecated form:
    Category cat = Category.getInstance("foo.bar")
 
    // Preferred form for retrieving loggers:
    Logger logger = Logger.getLogger("foo.bar")
 
```
The first form is deprecated and should be avoided.

There is absolutely no need for new client code to use or refer to the Category class. Whenever possible, please avoid referring to it or using it.

See the document entitled preparing for log4j 1.3 for a more detailed discussion.
Author:

Ceki Gülcü, Anders Kristensen

Field Summary

Fields
Modifier and Type Field Description

protected static org.tinylog.provider.LoggingProvider provider

protected static int STACKTRACE_DEPTH

Fields
Modifier and Type	Field	Description
`protected static org.tinylog.provider.LoggingProvider`	`provider`
`protected static int`	`STACKTRACE_DEPTH`

Constructor Summary

Constructors
Modifier Constructor Description

protected Category(java.lang.String name)

Constructors
Modifier	Constructor	Description
`protected`	`Category(java.lang.String name)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method	Description
`void`	`addAppender(Appender newAppender)`	Add `newAppender` to the list of appenders of this Category instance.
`void`	`assertLog(boolean assertion, java.lang.String msg)`	If `assertion` parameter is `false`, then logs `msg` as an `error` statement.
`void`	`callAppenders(LoggingEvent event)`	Call the appenders in the hierarchy starting at `this`.
`void`	`debug(java.lang.Object message)`	Log a message object with the `DEBUG` level.
`void`	`debug(java.lang.Object message, java.lang.Throwable t)`	Log a message object with the `DEBUG` level including the stack trace of the `Throwable` `t` passed as parameter.
`void`	`error(java.lang.Object message)`	Log a message object with the `ERROR` Level.
`void`	`error(java.lang.Object message, java.lang.Throwable t)`	Log a message object with the `ERROR` level including the stack trace of the `Throwable` `t` passed as parameter.
`static Logger`	`exists(java.lang.String name)`	Deprecated. Please use `LogManager.exists(java.lang.String)` instead.
`void`	`fatal(java.lang.Object message)`	Log a message object with the `FATAL` Level.
`void`	`fatal(java.lang.Object message, java.lang.Throwable t)`	Log a message object with the `FATAL` level including the stack trace of the `Throwable` `t` passed as parameter.
`protected void`	`forcedLog(java.lang.String fqcn, Priority level, java.lang.Object message, java.lang.Throwable t)`	This method creates a new logging event and logs the event without further checks.
`boolean`	`getAdditivity()`	Get the additivity flag for this Category instance.
`java.util.Enumeration`	`getAllAppenders()`	Get the appenders contained in this category as an `Enumeration`.
`Appender`	`getAppender(java.lang.String name)`	Look for the appender named as `name`.
`Priority`	`getChainedPriority()`	Deprecated. Please use the the `getEffectiveLevel()` method instead.
`static java.util.Enumeration`	`getCurrentCategories()`	Deprecated. Please use `LogManager.getCurrentLoggers()` instead.
`Level`	`getEffectiveLevel()`	Starting from this category, search the category hierarchy for a non-null level and return it.
`static Category`	`getInstance(java.lang.Class clazz)`	Deprecated. Please make sure to use `Logger.getLogger(Class)` instead.
`static Category`	`getInstance(java.lang.String name)`	Deprecated. Make sure to use `Logger.getLogger(String)` instead.
`Level`	`getLevel()`	Returns the assigned `Level`, if any, for this Category.
`java.lang.String`	`getName()`	Retrieves the category name.
`Category`	`getParent()`	Returns the parent of this category.
`Level`	`getPriority()`	Deprecated. Please use `getLevel()` instead.
`java.util.ResourceBundle`	`getResourceBundle()`	Return the inherited `ResourceBundle` for this category.
`static Category`	`getRoot()`	Deprecated. Please use `Logger.getRootLogger()` instead.
`void`	`info(java.lang.Object message)`	Log a message object with the `INFO` Level.
`void`	`info(java.lang.Object message, java.lang.Throwable t)`	Log a message object with the `INFO` level including the stack trace of the `Throwable` `t` passed as parameter.
`boolean`	`isAttached(Appender appender)`	Is the appender passed as parameter attached to this category?
`protected static boolean`	`isCoveredByMinimumLevel(org.tinylog.Level level)`	Checks if a given severity level is covered by the logging provider's minimum level.
`boolean`	`isDebugEnabled()`	Check whether this category is enabled for the `DEBUG` Level.
`boolean`	`isEnabledFor(Priority level)`	Check whether this category is enabled for a given `Level` passed as parameter.
`boolean`	`isInfoEnabled()`	Check whether this category is enabled for the info Level.
`void`	`l7dlog(Priority priority, java.lang.String key, java.lang.Object[] params, java.lang.Throwable t)`	Log a localized and parameterized message.
`void`	`l7dlog(Priority priority, java.lang.String key, java.lang.Throwable t)`	Log a localized message.
`void`	`log(java.lang.String callerFQCN, Priority level, java.lang.Object message, java.lang.Throwable t)`	This is the most generic printing method.
`void`	`log(Priority priority, java.lang.Object message)`	This generic form is intended to be used by wrappers.
`void`	`log(Priority priority, java.lang.Object message, java.lang.Throwable t)`	This generic form is intended to be used by wrappers.
`void`	`removeAllAppenders()`	Remove all previously added appenders from this Category instance.
`void`	`removeAppender(java.lang.String name)`	Remove the appender with the name passed as parameter form the list of appenders.
`void`	`removeAppender(Appender appender)`	Remove the appender passed as parameter form the list of appenders.
`void`	`setAdditivity(boolean additive)`	Set the additivity flag for this Category instance.
`void`	`setLevel(Level level)`	Set the level of this Category.
`void`	`setPriority(Priority priority)`	Deprecated. Please use `setLevel(org.apache.log4j.Level)` instead.
`void`	`setResourceBundle(java.util.ResourceBundle bundle)`	Set the resource bundle to be used with localized logging methods `l7dlog(Priority,String,Throwable)` and `l7dlog(Priority,String,Object[],Throwable)`.
`static void`	`shutdown()`	Deprecated. Please use `LogManager.shutdown()` instead.
`void`	`warn(java.lang.Object message)`	Log a message object with the `WARN` Level.
`void`	`warn(java.lang.Object message, java.lang.Throwable t)`	Log a message with the `WARN` level including the stack trace of the `Throwable` `t` passed as parameter.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - STACKTRACE_DEPTH
```
protected static final int STACKTRACE_DEPTH
```
    See Also:
    
    Constant Field Values
  - provider
```
protected static final org.tinylog.provider.LoggingProvider provider
```
- Constructor Detail
  - Category
```
protected Category(java.lang.String name)
```
    Parameters:
    
    name - Name for the category (typically the name of the class that will use this category)
- Method Detail
  - addAppender
```
public void addAppender(Appender newAppender)
```
    Add newAppender to the list of appenders of this Category instance.
    If newAppender is already in the list of appenders, then it won't be added again.
    
    Parameters:
    
    newAppender - Appender to register
  - assertLog
```
public void assertLog(boolean assertion,
                      java.lang.String msg)
```
    If assertion parameter is false, then logs msg as an error statement.
    The assert method has been renamed to assertLog because assert is a language reserved word in JDK 1.4.
    
    Parameters:
    
    assertion - true for dropping the passed message, false for outputting
    
    msg - The message to print if assertion is false.
    
    Since:
    
    1.2
  - callAppenders
```
public void callAppenders(LoggingEvent event)
```
    Call the appenders in the hierarchy starting at this. If no appenders could be found, emit a warning.
    This method calls all the appenders inherited from the hierarchy circumventing any evaluation of whether to log or not to log the particular log request.
    
    Parameters:
    
    event - the event to log.
  - debug
```
public void debug(java.lang.Object message)
```
    Log a message object with the DEBUG level.
    This method first checks if this category is DEBUG enabled by comparing the level of this category with the DEBUG level. If this category is DEBUG enabled, then it converts the message object (passed as parameter) to a string. It then proceeds to call all the registered appenders in this category and also higher in the hierarchy depending on the value of the additivity flag.
    
    WARNING Note that passing a Throwable to this method will print the name of the Throwable but no stack trace. To print a stack trace use the debug(Object, Throwable) form instead.
    
    Parameters:
    
    message - the message object to log.
  - debug
```
public void debug(java.lang.Object message,
                  java.lang.Throwable t)
```
    Log a message object with the DEBUG level including the stack trace of the Throwable t passed as parameter.
    See debug(Object) form for more detailed information.
    
    Parameters:
    
    message - the message object to log.
    
    t - the exception to log, including its stack trace.
  - error
```
public void error(java.lang.Object message)
```
    Log a message object with the ERROR Level.
    This method first checks if this category is ERROR enabled by comparing the level of this category with ERROR Level. If this category is ERROR enabled, then it converts the message object passed as parameter to a string. It proceeds to call all the registered appenders in this category and also higher in the hierarchy depending on the value of the additivity flag.
    
    WARNING Note that passing a Throwable to this method will print the name of the Throwable but no stack trace. To print a stack trace use the error(Object, Throwable) form instead.
    
    Parameters:
    
    message - the message object to log
  - error
```
public void error(java.lang.Object message,
                  java.lang.Throwable t)
```
    Log a message object with the ERROR level including the stack trace of the Throwable t passed as parameter.
    See error(Object) form for more detailed information.
    
    Parameters:
    
    message - the message object to log.
    
    t - the exception to log, including its stack trace.
  - exists
```
@Deprecated
public static Logger exists(java.lang.String name)
```
    Deprecated. Please use LogManager.exists(java.lang.String) instead.
    
    If the named category exists (in the default hierarchy) then it returns a reference to the category, otherwise it returns null.
    
    Parameters:
    
    name - Name of the category
    
    Returns:
    
    Logger instance or null
    
    Since:
    
    0.8.5
  - fatal
```
public void fatal(java.lang.Object message)
```
    Log a message object with the FATAL Level.
    This method first checks if this category is FATAL enabled by comparing the level of this category with FATAL Level. If the category is FATAL enabled, then it converts the message object passed as parameter to a string. It proceeds to call all the registered appenders in this category and also higher in the hierarchy depending on the value of the additivity flag.
    
    WARNING Note that passing a Throwable to this method will print the name of the Throwable but no stack trace. To print a stack trace use the fatal(Object, Throwable) form instead.
    
    Parameters:
    
    message - the message object to log
  - fatal
```
public void fatal(java.lang.Object message,
                  java.lang.Throwable t)
```
    Log a message object with the FATAL level including the stack trace of the Throwable t passed as parameter.
    See fatal(Object) for more detailed information.
    
    Parameters:
    
    message - the message object to log.
    
    t - the exception to log, including its stack trace.
  - forcedLog
```
protected void forcedLog(java.lang.String fqcn,
                         Priority level,
                         java.lang.Object message,
                         java.lang.Throwable t)
```
    This method creates a new logging event and logs the event without further checks.
    
    Parameters:
    
    fqcn - Fully-qualified class name of the category or logger instance
    
    level - Priority to log
    
    message - Message to log
    
    t - Exception to log
  - getAdditivity
```
public boolean getAdditivity()
```
    Get the additivity flag for this Category instance.
    
    Returns:
    
    Always true
  - getAllAppenders
```
public java.util.Enumeration getAllAppenders()
```
    Get the appenders contained in this category as an Enumeration. If no appenders can be found, then a empty enumeration is returned.
    
    Returns:
    
    Enumeration An enumeration of the appenders in this category.
  - getAppender
```
public Appender getAppender(java.lang.String name)
```
    Look for the appender named as name.
    
    Parameters:
    
    name - Name of the appender
    
    Returns:
    
    Return the appender with that name if in the list. Return null otherwise.
  - getEffectiveLevel
```
public Level getEffectiveLevel()
```
    Starting from this category, search the category hierarchy for a non-null level and return it. Otherwise, return the level of the root category.
    The Category class is designed so that this method executes as quickly as possible.
    
    Returns:
    
    Minimum enabled severity level
  - getChainedPriority
```
@Deprecated
public Priority getChainedPriority()
```
    Deprecated. Please use the the getEffectiveLevel() method instead.
    
    Returns:
    
    Minimum enabled severity level
  - getCurrentCategories
```
@Deprecated
public static java.util.Enumeration getCurrentCategories()
```
    Deprecated. Please use LogManager.getCurrentLoggers() instead.
    
    Returns all the currently defined categories in the default hierarchy as an Enumeration.
    The root category is not included in the returned Enumeration.
    
    Returns:
    
    Enumeration with all existing loggers
  - getInstance
```
@Deprecated
public static Category getInstance(java.lang.String name)
```
    Deprecated. Make sure to use Logger.getLogger(String) instead.
    
    Parameters:
    
    name - Name of the category
    
    Returns:
    
    Logger instance
  - getInstance
```
@Deprecated
public static Category getInstance(java.lang.Class clazz)
```
    Deprecated. Please make sure to use Logger.getLogger(Class) instead.
    
    Parameters:
    
    clazz - Class to log
    
    Returns:
    
    Logger instance
  - getName
```
public final java.lang.String getName()
```
    Retrieves the category name.
    
    Returns:
    
    Name of this category
  - getParent
```
public final Category getParent()
```
    Returns the parent of this category. Note that the parent of a given category may change during the lifetime of the category.
    The root category will return null.
    
    Returns:
    
    Parent logger instance
    
    Since:
    
    1.2
  - getLevel
```
public final Level getLevel()
```
    Returns the assigned Level, if any, for this Category.
    
    Returns:
    
    Minimum enabled severity level
  - getPriority
```
@Deprecated
public final Level getPriority()
```
    Deprecated. Please use getLevel() instead.
    
    Returns:
    
    Minimum enabled severity level
  - getRoot
```
@Deprecated
public static final Category getRoot()
```
    Deprecated. Please use Logger.getRootLogger() instead.
    
    Returns:
    
    Root logger instance
  - getResourceBundle
```
public java.util.ResourceBundle getResourceBundle()
```
    Return the inherited ResourceBundle for this category.
    This method walks the hierarchy to find the appropriate resource bundle. It will return the resource bundle attached to the closest ancestor of this category, much like the way priorities are searched. In case there is no bundle in the hierarchy then null is returned.
    
    Returns:
    
    Current resource bundle
    
    Since:
    
    0.9.0
  - info
```
public void info(java.lang.Object message)
```
    Log a message object with the INFO Level.
    This method first checks if this category is INFO enabled by comparing the level of this category with INFO Level. If the category is INFO enabled, then it converts the message object passed as parameter to a string. It proceeds to call all the registered appenders in this category and also higher in the hierarchy depending on the value of the additivity flag.
    
    WARNING Note that passing a Throwable to this method will print the name of the Throwable but no stack trace. To print a stack trace use the info(Object, Throwable) form instead.
    
    Parameters:
    
    message - the message object to log
  - info
```
public void info(java.lang.Object message,
                 java.lang.Throwable t)
```
    Log a message object with the INFO level including the stack trace of the Throwable t passed as parameter.
    See info(Object) for more detailed information.
    
    Parameters:
    
    message - the message object to log.
    
    t - the exception to log, including its stack trace.
  - isAttached
```
public boolean isAttached(Appender appender)
```
    Is the appender passed as parameter attached to this category?
    
    Parameters:
    
    appender - Appender to check
    
    Returns:
    
    Always false
  - isDebugEnabled
```
public boolean isDebugEnabled()
```
    Check whether this category is enabled for the DEBUG Level.
    This function is intended to lessen the computational cost of disabled log debug statements.
    
    For some cat Category object, when you write,
```
 cat.debug("This is entry number: " + i);
 
```
    You incur the cost constructing the message, concatenatiion in this case, regardless of whether the message is logged or not.
    
    If you are worried about speed, then you should write
```
 if (cat.isDebugEnabled()) {
        cat.debug("This is entry number: " + i);
 }
 
```
    This way you will not incur the cost of parameter construction if debugging is disabled for cat. On the other hand, if the cat is debug enabled, you will incur the cost of evaluating whether the category is debug enabled twice. Once in isDebugEnabled and once in the debug. This is an insignificant overhead since evaluating a category takes about 1%% of the time it takes to actually log.
    Returns:
    
    boolean - true if this category is debug enabled, false otherwise.
  - isEnabledFor
```
public boolean isEnabledFor(Priority level)
```
    Check whether this category is enabled for a given Level passed as parameter.
    See also isDebugEnabled().
    
    Parameters:
    
    level - Priority to check whether enabled
    
    Returns:
    
    boolean True if this category is enabled for level.
  - isInfoEnabled
```
public boolean isInfoEnabled()
```
    Check whether this category is enabled for the info Level. See also isDebugEnabled().
    
    Returns:
    
    boolean - true if this category is enabled for level info, false otherwise.
  - l7dlog
```
public void l7dlog(Priority priority,
                   java.lang.String key,
                   java.lang.Throwable t)
```
    Log a localized message. The user supplied parameter key is replaced by its localized version from the resource bundle.
    
    Parameters:
    
    priority - Priority for log entry
    
    key - Resource key for translation
    
    t - Exception to log
    
    Since:
    
    0.8.4
    
    See Also:
    
    setResourceBundle(java.util.ResourceBundle)
  - l7dlog
```
public void l7dlog(Priority priority,
                   java.lang.String key,
                   java.lang.Object[] params,
                   java.lang.Throwable t)
```
    Log a localized and parameterized message. First, the user supplied key is searched in the resource bundle. Next, the resulting pattern is formatted using MessageFormat.format(String,Object[]) method with the user supplied object array params.
    
    Parameters:
    
    priority - Priority for log entry
    
    key - Resource key for translation
    
    params - Arguments for message
    
    t - Exception to log
    
    Since:
    
    0.8.4
  - log
```
public void log(Priority priority,
                java.lang.Object message,
                java.lang.Throwable t)
```
    This generic form is intended to be used by wrappers.
    
    Parameters:
    
    priority - Priority for log entry
    
    message - Message to log
    
    t - Exception to log
  - log
```
public void log(Priority priority,
                java.lang.Object message)
```
    This generic form is intended to be used by wrappers.
    
    Parameters:
    
    priority - Priority for log entry
    
    message - Message to log
  - log
```
public void log(java.lang.String callerFQCN,
                Priority level,
                java.lang.Object message,
                java.lang.Throwable t)
```
    This is the most generic printing method. It is intended to be invoked by wrapper classes.
    
    Parameters:
    
    callerFQCN - The wrapper class' fully qualified class name.
    
    level - The level of the logging request.
    
    message - The message of the logging request.
    
    t - The throwable of the logging request, may be null.
  - removeAllAppenders
```
public void removeAllAppenders()
```
    Remove all previously added appenders from this Category instance.
    This is useful when re-reading configuration information.
  - removeAppender
```
public void removeAppender(Appender appender)
```
    Remove the appender passed as parameter form the list of appenders.
    
    Parameters:
    
    appender - Appender to remove
    
    Since:
    
    0.8.2
  - removeAppender
```
public void removeAppender(java.lang.String name)
```
    Remove the appender with the name passed as parameter form the list of appenders.
    
    Parameters:
    
    name - Name of appender to remove
    
    Since:
    
    0.8.2
  - setAdditivity
```
public void setAdditivity(boolean additive)
```
    Set the additivity flag for this Category instance.
    
    Parameters:
    
    additive - Additivity flag (will be ignored)
    
    Since:
    
    0.8.1
  - setLevel
```
public void setLevel(Level level)
```
    Set the level of this Category. If you are passing any of Level.DEBUG, Level.INFO, Level.WARN, Level.ERROR, Level.FATAL as a parameter, you need to case them as Level.
    As in
```
 logger.setLevel((Level) Level.DEBUG);
 
```
    Null values are admitted.
    Parameters:
    
    level - New level (will be ignored)
  - setPriority
```
@Deprecated
public void setPriority(Priority priority)
```
    Deprecated. Please use setLevel(org.apache.log4j.Level) instead.
    
    Set the level of this Category.
    Null values are admitted.
    
    Parameters:
    
    priority - New priority (will be ignored)
  - setResourceBundle
```
public void setResourceBundle(java.util.ResourceBundle bundle)
```
    Set the resource bundle to be used with localized logging methods l7dlog(Priority,String,Throwable) and l7dlog(Priority,String,Object[],Throwable).
    
    Parameters:
    
    bundle - New resource bundle for translations
    
    Since:
    
    0.8.4
  - shutdown
```
@Deprecated
public static void shutdown()
```
    Deprecated. Please use LogManager.shutdown() instead.
    
    Calling this method will safely close and remove all appenders in all the categories including root contained in the default hierarchy.
    The shutdown method is careful to close nested appenders before closing regular appenders. This is allows configurations where a regular appender is attached to a category and again to a nested appender.
    
    Since:
    
    1.0
  - warn
```
public void warn(java.lang.Object message)
```
    Log a message object with the WARN Level.
    This method first checks if this category is WARN enabled by comparing the level of this category with WARN Level. If the category is WARN enabled, then it converts the message object passed as parameter to a string. It proceeds to call all the registered appenders in this category and also higher in the hierarchy depending on the value of the additivity flag.
    
    WARNING Note that passing a Throwable to this method will print the name of the Throwable but no stack trace. To print a stack trace use the warn(Object, Throwable) form instead.
    
    Parameters:
    
    message - the message object to log.
  - warn
```
public void warn(java.lang.Object message,
                 java.lang.Throwable t)
```
    Log a message with the WARN level including the stack trace of the Throwable t passed as parameter.
    See warn(Object) for more detailed information.
    
    Parameters:
    
    message - the message object to log.
    
    t - the exception to log, including its stack trace.
  - isCoveredByMinimumLevel
```
protected static boolean isCoveredByMinimumLevel(org.tinylog.Level level)
```
    Checks if a given severity level is covered by the logging provider's minimum level.
    
    Parameters:
    
    level - Severity level to check
    
    Returns:
    
    true if given severity level is covered, otherwise false

Class Category

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

STACKTRACE_DEPTH

provider

Constructor Detail

Category

Method Detail

addAppender

assertLog

callAppenders

debug

debug

error

error

exists

fatal

fatal

forcedLog

getAdditivity

getAllAppenders

getAppender

getEffectiveLevel

getChainedPriority

getCurrentCategories

getInstance

getInstance

getName

getParent

getLevel

getPriority

getRoot

getResourceBundle

info

info

isAttached

isDebugEnabled

isEnabledFor

isInfoEnabled

l7dlog

l7dlog

log

log

log

removeAllAppenders

removeAppender

removeAppender

setAdditivity

setLevel

setPriority

setResourceBundle

shutdown

warn

warn

isCoveredByMinimumLevel