Package org.apache.log4j

Class 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.

    Author:
    Sébastien Pennec, Ceki Gülcü

    • Field Summary

      Fields 
      Modifier and Type Field Description
      protected org.slf4j.Logger slf4jLogger  

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods 
      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.
      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)  
      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

    • Method Detail

      • getName

        public java.lang.String getName()
        Returns the obvious.
        Returns:

      • 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.

      • isDebugEnabled

        public boolean isDebugEnabled()
        Delegates to Logger.isDebugEnabled() method in SLF4J
        Returns:
        true if this logger is enabled for the level DEBUG

      • isInfoEnabled

        public boolean isInfoEnabled()
        Delegates to Logger.isInfoEnabled() method in SLF4J
        Returns:
        true if this logger is enabled for the level INFO

      • isWarnEnabled

        public boolean isWarnEnabled()
        Delegates to Logger.isWarnEnabled() method in SLF4J
        Returns:
        true if this logger is enabled for the level WARN

      • isErrorEnabled

        public boolean isErrorEnabled()
        Delegates to Logger.isErrorEnabled() method in SLF4J
        Returns:
        true if this logger is enabled for the level ERROR

      • 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.

      • debug

        public void debug​(java.lang.Object message)
        Delegates to Logger.debug(String) method of SLF4J.
        Parameters:
        message - a message to log

      • debug

        public void debug​(java.lang.Object message,
                  java.lang.Throwable t)
        Delegates to Logger.debug(String,Throwable) method in SLF4J.
        Parameters:
        message - a message to log
        t - a throwable to log

      • info

        public void info​(java.lang.Object message)
        Delegates to Logger.info(String) method in SLF4J.
        Parameters:
        message - a message to log

      • info

        public void info​(java.lang.Object message,
                 java.lang.Throwable t)
        Delegates to Logger.info(String,Throwable) method in SLF4J.
        Parameters:
        message - a message to log
        t - a throwable to log

      • warn

        public void warn​(java.lang.Object message)
        Delegates to Logger.warn(String) method in SLF4J.
        Parameters:
        message - a message to log

      • warn

        public void warn​(java.lang.Object message,
                 java.lang.Throwable t)
        Delegates to Logger.warn(String,Throwable) method in SLF4J.
        Parameters:
        message - a message to log
        t - a throwable to log

      • error

        public void error​(java.lang.Object message)
        Delegates to Logger.error(String) method in SLF4J.
        Parameters:
        message - a message to log

      • error

        public void error​(java.lang.Object message,
                  java.lang.Throwable t)
        Delegates to Logger.error(String,Throwable) method in SLF4J.
        Parameters:
        message - a message to log
        t - a throwable to log

      • fatal

        public void fatal​(java.lang.Object message)
        Delegates to Logger.error(String) method in SLF4J.
        Parameters:
        message - a message to log

      • 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".
        Parameters:
        message - a message to log
        t - a throwable to log

      • 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)

      • convertToString

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

      • setAdditivity

        public void setAdditivity​(boolean additive)

      • assertLog

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