org.apache.logging.log4j.spi

Interface LoggerContext

  • All Known Implementing Classes:
    SimpleLoggerContext

    public interface LoggerContext
    Anchor point for logging implementations.

    • Method Detail

      • getExternalContext

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

      • getObject

        default Object getObject(String key)
        Retrieve an object by its name.
        Parameters:
        key - The object's key.
        Since:
        2.13.0

      • putObject

        default Object putObject(String key,
                         Object value)
        Store 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)
        Store 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)
        Remove 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)
        Remove 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

      • getLogger

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

      • getLogger

        default ExtendedLogger getLogger(Class<?> cls)
        Returns 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

        ExtendedLogger getLogger(String name,
                         MessageFactory messageFactory)
        Returns 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.

      • getLogger

        default ExtendedLogger getLogger(Class<?> cls,
                                 MessageFactory messageFactory)
        Returns 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

      • hasLogger

        boolean hasLogger(String name)
        Detects 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,
                  MessageFactory messageFactory)
        Detects 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

      • hasLogger

        boolean hasLogger(String name,
                  Class<? extends MessageFactory> messageFactoryClass)
        Detects 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

Copyright © 1999-1969 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.