org.jenkinsci.bytecode.helper

Class LoggingHelper

java.lang.Object

org.jenkinsci.bytecode.helper.LoggingHelper

public final class LoggingHelper
extends Object

Helper utility to allow asynchronous logging to prevent the introduction of deadlocks. We need this intermediate as logging can cause classloading and also involves locks, and the transformer is only ever invoked during class loading - so we should not really use logging as we could end up in a deadlock (however there are times where we really want to use it)

Constructor Summary

Constructors

Constructor and Description
LoggingHelper()

Method Summary

Modifier and Type	Method and Description
static void	asyncLog(Logger log, Level level, String message, Object... parameters) Logs to JUL if the log level is loggable for the given logger, based on the given message and parameters
static void	asyncLog(Logger log, Level level, Throwable throwable, String message, Object... parameters) Logs to JUL if the log level is loggable for the given logger, based on the given message and parameters
static void	asyncLog(Logger log, LogRecord record) Logs to JUL if the records log level is loggable for the given logger.

Methods inherited from class java.lang.Object

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

Constructor Detail

LoggingHelper

public LoggingHelper()

Method Detail

asyncLog

public static void asyncLog(Logger log,
                            LogRecord record)

Logs to JUL if the records log level is loggable for the given logger.

Parameters:

log - the Logger to use.

record - the record to log

asyncLog

public static void asyncLog(Logger log,
                            Level level,
                            String message,
                            Object... parameters)

Logs to JUL if the log level is loggable for the given logger, based on the given message and parameters

Parameters:

log - the Logger to use.

level - the level of the log entry

message - the message (with format placeholders) for the log entry

parameters - optional parameters to go with the message

asyncLog

public static void asyncLog(Logger log,
                            Level level,
                            Throwable throwable,
                            String message,
                            Object... parameters)

Logs to JUL if the log level is loggable for the given logger, based on the given message and parameters

Parameters:

log - the Logger to use.

level - the level of the log entry

throwable - the throwable to associate with the log entry

message - the message (with format placeholders) for the log entry

parameters - optional parameters to go with the message