Class Category

  • All Implemented Interfaces:
    AppenderAttachable
    Direct Known Subclasses:
    Logger

    public class Category
    extends Object
    implements AppenderAttachable
    Implementation of the Category class for compatibility, despite it having been deprecated a long, long time ago.
    • Field Detail

      • name

        protected String name
        The name of this category.
      • additive

        protected boolean additive
        Additivity is set to true by default, that is children inherit the appenders of their ancestors by default. If this variable is set to false then the appenders found in the ancestors of this category are not used. However, the children of this category will inherit its appenders, unless the children have their additivity flag set to false too. See the user manual for more details.
      • level

        protected volatile Level level
        The assigned level of this category. The level variable need not be assigned a value in which case it is inherited form the hierarchy.
      • parent

        protected volatile Category parent
        The parent of this category. All categories have at least one ancestor which is the root category.
      • bundle

        protected ResourceBundle bundle
        Resource bundle for localized messages.
      • repository

        protected LoggerRepository repository
        Categories need to know what Hierarchy they are in.
    • Constructor Detail

      • Category

        protected Category​(LoggerContext context,
                           String name)
        Constructor used by Logger to specify a LoggerContext.
        Parameters:
        context - The LoggerContext.
        name - The name of the Logger.
      • Category

        protected Category​(String name)
        Constructor exposed by Log4j 1.2.
        Parameters:
        name - The name of the Logger.
    • Method Detail

      • exists

        @Deprecated
        public static Logger exists​(String name)
        Deprecated.
        Please use LogManager.exists(String) instead.
        Tests if the named category exists (in the default hierarchy).
        Parameters:
        name - The name to test.
        Returns:
        Whether the name exists.
        Since:
        0.8.5
      • getInstance

        public static Category getInstance​(Class clazz)
      • getRoot

        public static Category getRoot()
      • shutdown

        public static void shutdown()
        Shuts down the current configuration.
      • addAppender

        public void addAppender​(Appender appender)
        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.

        Specified by:
        addAppender in interface AppenderAttachable
        Parameters:
        appender - The Appender to add.
      • assertLog

        public void assertLog​(boolean assertion,
                              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 - The assertion.
        msg - The message to print if assertion is false.
        Since:
        1.2
      • callAppenders

        public void callAppenders​(LoggingEvent event)
        Call the appenders in the hierrachy 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​(Object message)
      • error

        public void error​(Object message)
      • fatal

        public void fatal​(Object message)
      • getAdditivity

        public boolean getAdditivity()
      • getAppender

        public Appender getAppender​(String name)
        Look for the appender named as name.

        Return the appender with that name if in the list. Return null otherwise.

        Specified by:
        getAppender in interface AppenderAttachable
        Parameters:
        name - The name of the Appender.
        Returns:
        The Appender.
      • getChainedPriority

        public Priority getChainedPriority()
      • getEffectiveLevel

        public Level getEffectiveLevel()
      • getLevel

        public final Level getLevel()
      • getName

        public final String getName()
      • getParent

        public final Category getParent()
      • getPriority

        public final Level getPriority()
      • info

        public void info​(Object message)
      • isAttached

        public boolean isAttached​(Appender appender)
        Is the appender passed as parameter attached to this category?
        Specified by:
        isAttached in interface AppenderAttachable
        Parameters:
        appender - The Appender to add.
        Returns:
        true if the appender is attached.
      • isDebugEnabled

        public boolean isDebugEnabled()
      • isEnabledFor

        public boolean isEnabledFor​(Priority level)
      • isErrorEnabled

        public boolean isErrorEnabled()
      • isFatalEnabled

        public boolean isFatalEnabled()
      • isInfoEnabled

        public boolean isInfoEnabled()
      • isWarnEnabled

        public boolean isWarnEnabled()
      • removeAllAppenders

        public void removeAllAppenders()
        Removes all previously added appenders from this Category instance.

        This is useful when re-reading configuration information.

        Specified by:
        removeAllAppenders in interface AppenderAttachable
      • removeAppender

        public void removeAppender​(Appender appender)
        Removes the appender passed as parameter form the list of appenders.
        Specified by:
        removeAppender in interface AppenderAttachable
        Parameters:
        appender - The Appender to remove.
        Since:
        0.8.2
      • removeAppender

        public void removeAppender​(String name)
        Removes the appender with the name passed as parameter form the list of appenders.
        Specified by:
        removeAppender in interface AppenderAttachable
        Parameters:
        name - The Appender to remove.
        Since:
        0.8.2
      • setAdditivity

        public void setAdditivity​(boolean additivity)
      • setLevel

        public void setLevel​(Level level)
      • setPriority

        public void setPriority​(Priority priority)
      • setResourceBundle

        public void setResourceBundle​(ResourceBundle bundle)
      • warn

        public void warn​(Object message)