org.apache.logging.log4j.spi

Interface LoggerContext

  • All Known Implementing Classes:
    SimpleLoggerContext


    public interface LoggerContext
    Anchor point for logging implementations.
    • Field Detail

      • EMPTY_ARRAY

        static final LoggerContext[] EMPTY_ARRAY
        Empty array.
    • Method Detail

      • getExternalContext

        Object getExternalContext()
        Gets the anchor for some other context, such as a ClassLoader or ServletContext.
        Returns:
        The external context.
      • getLogger

        default ExtendedLogger getLogger(Class<?> cls)
        Gets an ExtendedLogger using the fully qualified name of the Class as the Logger name.
        Parameters:
        cls - The Class whose name should be used as the Logger name.
        Returns:
        The logger.
        Since:
        2.14.0
      • getLogger

        default ExtendedLogger getLogger(Class<?> cls,
                                         MessageFactory messageFactory)
        Gets an ExtendedLogger using the fully qualified name of the Class as the Logger name.
        Parameters:
        cls - The Class whose name should be used as the Logger name.
        messageFactory - The message factory is used only when creating a logger, subsequent use does not change the logger but will log a warning if mismatched.
        Returns:
        The logger.
        Since:
        2.14.0
      • getLogger

        ExtendedLogger getLogger(String name)
        Gets an ExtendedLogger.
        Parameters:
        name - The name of the Logger to return.
        Returns:
        The logger with the specified name.
      • getLogger

        ExtendedLogger getLogger(String name,
                                 MessageFactory messageFactory)
        Gets an ExtendedLogger.
        Parameters:
        name - The name of the Logger to return.
        messageFactory - The message factory is used only when creating a logger, subsequent use does not change the logger but will log a warning if mismatched.
        Returns:
        The logger with the specified name.
      • getLoggerRegistry

        default LoggerRegistry<? extends Logger> getLoggerRegistry()
        Gets the LoggerRegistry.
        Returns:
        the LoggerRegistry.
        Since:
        2.17.2
      • getObject

        default Object getObject(String key)
        Gets an object by its name.
        Parameters:
        key - The object's key.
        Returns:
        The Object that is associated with the key, if any.
        Since:
        2.13.0
      • hasLogger

        boolean hasLogger(String name)
        Tests if a Logger with the specified name exists.
        Parameters:
        name - The Logger name to search for.
        Returns:
        true if the Logger exists, false otherwise.
      • hasLogger

        boolean hasLogger(String name,
                          Class<? extends MessageFactory> messageFactoryClass)
        Tests if a Logger with the specified name and MessageFactory type exists.
        Parameters:
        name - The Logger name to search for.
        messageFactoryClass - The message factory class to search for.
        Returns:
        true if the Logger exists, false otherwise.
        Since:
        2.5
      • hasLogger

        boolean hasLogger(String name,
                          MessageFactory messageFactory)
        Tests if a Logger with the specified name and MessageFactory exists.
        Parameters:
        name - The Logger name to search for.
        messageFactory - The message factory to search for.
        Returns:
        true if the Logger exists, false otherwise.
        Since:
        2.5
      • putObject

        default Object putObject(String key,
                                 Object value)
        Associates an object into the LoggerContext by name for later use.
        Parameters:
        key - The object's key.
        value - The object.
        Returns:
        The previous object or null.
        Since:
        2.13.0
      • putObjectIfAbsent

        default Object putObjectIfAbsent(String key,
                                         Object value)
        Associates an object into the LoggerContext by name for later use if an object is not already stored with that key.
        Parameters:
        key - The object's key.
        value - The object.
        Returns:
        The previous object or null.
        Since:
        2.13.0
      • removeObject

        default Object removeObject(String key)
        Removes an object if it is present.
        Parameters:
        key - The object's key.
        Returns:
        The object if it was present, null if it was not.
        Since:
        2.13.0
      • removeObject

        default boolean removeObject(String key,
                                     Object value)
        Removes an object if it is present and the provided object is stored.
        Parameters:
        key - The object's key.
        value - The object.
        Returns:
        The object if it was present, null if it was not.
        Since:
        2.13.0

Copyright © 1999-2023 The Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.