org.springframework.core.log

Class LogDelegateFactory

java.lang.Object

org.springframework.core.log.LogDelegateFactory

public final class LogDelegateFactory
extends 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

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(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 - optional vararg of further fallback loggers

Returns:

the resulting composite logger for the related categories

getHiddenLog

public static Log getHiddenLog(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:

a logger for the hidden category ("_" + fully-qualified class name)