org.spf4j.log

Class SLF4JBridgeHandler

java.lang.Object

java.util.logging.Handler

org.spf4j.log.SLF4JBridgeHandler

public final class SLF4JBridgeHandler
extends Handler

Bridge/route all JUL log records to the SLF4J API.

Implementation based on jul-to-slf4j bridge but at least 20% faster. Speed improvements come from using spf4j improved MessageFormatter + code cleanup. Also unlike jul-to-slf4j the sorce class and source method information is not being dropped.

Implementation is interchangeable with the jul-to-slf4j implementation

Constructor Summary

Constructors

Constructor and Description
SLF4JBridgeHandler()

Method Summary

Modifier and Type	Method and Description
void	close()
void	flush()
static Method	getSourceMethodInfo(LogRecord record)
static void	install() Adds a SLF4JBridgeHandler instance to jul's root logger.
static boolean	isInstalled() Returns true if SLF4JBridgeHandler has been previously installed, returns false otherwise.
void	publish(LogRecord record)
static void	removeHandlersForRootLogger() Invoking this method removes/unregisters/detaches all handlers currently attached to the root logger
static void	uninstall() Removes previously installed SLF4JBridgeHandler instances.

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SLF4JBridgeHandler

public SLF4JBridgeHandler()

Method Detail

install

public static void install()

Adds a SLF4JBridgeHandler instance to jul's root logger.

This handler will redirect j.u.l. logging to SLF4J. However, only logs enabled in j.u.l. will be redirected. For example, if a log statement invoking a j.u.l. logger is disabled, then the corresponding non-event will not reach SLF4JBridgeHandler and cannot be redirected.

uninstall

public static void uninstall()

Removes previously installed SLF4JBridgeHandler instances. See also install().

Throws:

SecurityException - A SecurityException is thrown, if a security manager exists and if the caller does not have LoggingPermission("control").

isInstalled

public static boolean isInstalled()

Returns true if SLF4JBridgeHandler has been previously installed, returns false otherwise.

Returns:

true if SLF4JBridgeHandler is already installed, false other wise

Throws:

SecurityException

removeHandlersForRootLogger

public static void removeHandlersForRootLogger()

Invoking this method removes/unregisters/detaches all handlers currently attached to the root logger

close

public void close()

Specified by:

close in class Handler

flush

public void flush()

Specified by:

flush in class Handler

getSourceMethodInfo

@Nullable
public static Method getSourceMethodInfo(LogRecord record)

publish

public void publish(LogRecord record)

Specified by:

publish in class Handler