org.springframework.core.log

Class LogDelegateFactory

  • java.lang.Object
    • org.springframework.core.log.LogDelegateFactory


  • public final class LogDelegateFactory
    extends java.lang.Object
    Factory for common Log delegates with Spring's logging conventions.

    Mainly for internal use within the framework with Apache Commons Logging, typically in the form of the spring-jcl bridge but also compatible with other Commons Logging bridges.

    Since:
    5.1
    Author:
    Rossen Stoyanchev, Juergen Hoeller
    See Also:
    LogFactory
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method and Description
      static Log getCompositeLog(Log primaryLogger, Log secondaryLogger, Log... tertiaryLoggers)
      Create a composite logger that delegates to a primary or falls back on a secondary logger if logging for the primary logger is not enabled.
      static Log getHiddenLog(java.lang.Class<?> clazz)
      Create a "hidden" logger whose name is intentionally prefixed with "_" because its output is either too verbose or otherwise deemed as optional or unnecessary to see at any log level by default under the normal package based log hierarchy.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Method Detail

      • getCompositeLog

        public static Log getCompositeLog(Log primaryLogger,
                                          Log secondaryLogger,
                                          Log... tertiaryLoggers)
        Create a composite logger that delegates to a primary or falls back on a secondary logger if logging for the primary logger is not enabled.

        This may be used for fallback logging from lower level packages that logically should log together with some higher level package but the two don't happen to share a suitable parent package (e.g. logging for the web and lower level http and codec packages). For such cases the primary, class-based logger can be wrapped with a shared fallback logger.

        Parameters:
        primaryLogger - primary logger to try first
        secondaryLogger - secondary logger
        tertiaryLoggers - optionally, more fallback loggers
        Returns:
        the resulting logger to use
      • getHiddenLog

        public static Log getHiddenLog(java.lang.Class<?> clazz)
        Create a "hidden" logger whose name is intentionally prefixed with "_" because its output is either too verbose or otherwise deemed as optional or unnecessary to see at any log level by default under the normal package based log hierarchy.
        Parameters:
        clazz - the class for which to create a logger
        Returns:
        the created logger