Class XRLog

java.lang.Object

com.openhtmltopdf.util.XRLog

public class XRLog
extends Object

Utility class for using the java.util.logging package. Relies on the standard configuration for logging, but gives easier access to the various logs (plumbing.load, .init, .render)

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CASCADE
static final String	CONFIG
static final String	CSS_PARSE
static final String	EXCEPTION
static final String	GENERAL
static final String	INIT
private static boolean	initPending
static final String	JUNIT
static final String	LAYOUT
static final String	LOAD
private static final List<String>	LOGGER_NAMES
private static XRLogger	loggerImpl
private static Boolean	loggingEnabled
static final String	MATCH
static final String	RENDER
static final String	XML_ENTITIES

Constructor Summary

Constructors

Constructor	Description
XRLog()

Method Summary

Modifier and Type	Method	Description
static XRLogger	getLoggerImpl()
private static void	init()
static boolean	isLoggingEnabled()	Whether logging is on or off.
static List<String>	listRegisteredLoggers()	Returns a list of all loggers that will be accessed by XRLog.
static void	log(Level level, LogMessageId.LogMessageId0Param logMessageId)
static void	log(Level level, LogMessageId.LogMessageId0Param logMessageId, Throwable t)
static void	log(Level level, LogMessageId.LogMessageId1Param logMessageId, Object arg)
static void	log(Level level, LogMessageId.LogMessageId1Param logMessageId, Object arg, Throwable throwable)
static void	log(Level level, LogMessageId.LogMessageId2Param logMessageId, Object arg1, Object arg2)
static void	log(Level level, LogMessageId.LogMessageId2Param logMessageId, Object arg1, Object arg2, Throwable throwable)
static void	log(Level level, LogMessageId.LogMessageId3Param logMessageId, Object arg1, Object arg2, Object arg3)
static void	log(Level level, LogMessageId.LogMessageId3Param logMessageId, Object arg1, Object arg2, Object arg3, Throwable throwable)
static void	log(Level level, LogMessageId.LogMessageId4Param logMessageId, Object arg1, Object arg2, Object arg3, Object arg4)
static void	log(Level level, LogMessageId.LogMessageId5Param logMessageId, Object arg1, Object arg2, Object arg3, Object arg4, Object arg5)
private static void	log(Level level, LogMessageId logMessageId, boolean hasError, Object... args)
private static String	registerLoggerByName(String loggerName)
static void	setLevel(String log, Level level)
static void	setLoggerImpl(XRLogger loggerImpl)
static void	setLoggingEnabled(boolean loggingEnabled)	Turns logging on or off, without affecting logging configuration.

Methods inherited from class Object

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

Field Details

LOGGER_NAMES

private static final List<String> LOGGER_NAMES

CONFIG

public static final String CONFIG

EXCEPTION

public static final String EXCEPTION

GENERAL

public static final String GENERAL

INIT

public static final String INIT

JUNIT

public static final String JUNIT

LOAD

public static final String LOAD

MATCH

public static final String MATCH

CASCADE

public static final String CASCADE

XML_ENTITIES

public static final String XML_ENTITIES

CSS_PARSE

public static final String CSS_PARSE

LAYOUT

public static final String LAYOUT

RENDER

public static final String RENDER

initPending

private static volatile boolean initPending

loggerImpl

private static volatile XRLogger loggerImpl

loggingEnabled

private static volatile Boolean loggingEnabled

Constructor Details

XRLog

public XRLog()

Method Details

registerLoggerByName

private static String registerLoggerByName(String loggerName)

listRegisteredLoggers

public static List<String> listRegisteredLoggers()

Returns a list of all loggers that will be accessed by XRLog. Each entry is a String with a logger name, which can be used to retrieve the logger using the corresponding Logging API; example name might be "com.openhtmltopdf.render"

Returns:

List of loggers, never null.

log

public static void log(Level level,
 LogMessageId.LogMessageId0Param logMessageId)

log

public static void log(Level level,
 LogMessageId.LogMessageId0Param logMessageId,
 Throwable t)

log

public static void log(Level level,
 LogMessageId.LogMessageId1Param logMessageId,
 Object arg)

log

public static void log(Level level,
 LogMessageId.LogMessageId1Param logMessageId,
 Object arg,
 Throwable throwable)

log

public static void log(Level level,
 LogMessageId.LogMessageId2Param logMessageId,
 Object arg1,
 Object arg2)

log

public static void log(Level level,
 LogMessageId.LogMessageId2Param logMessageId,
 Object arg1,
 Object arg2,
 Throwable throwable)

log

public static void log(Level level,
 LogMessageId.LogMessageId3Param logMessageId,
 Object arg1,
 Object arg2,
 Object arg3)

log

public static void log(Level level,
 LogMessageId.LogMessageId3Param logMessageId,
 Object arg1,
 Object arg2,
 Object arg3,
 Throwable throwable)

log

public static void log(Level level,
 LogMessageId.LogMessageId4Param logMessageId,
 Object arg1,
 Object arg2,
 Object arg3,
 Object arg4)

log

public static void log(Level level,
 LogMessageId.LogMessageId5Param logMessageId,
 Object arg1,
 Object arg2,
 Object arg3,
 Object arg4,
 Object arg5)

log

private static void log(Level level,
 LogMessageId logMessageId,
 boolean hasError,
 Object... args)

init

private static void init()

setLevel

public static void setLevel(String log,
 Level level)

isLoggingEnabled

public static boolean isLoggingEnabled()

Whether logging is on or off.

Returns:

Returns true if logging is enabled, false if not. Corresponds to configuration file property xr.util-logging.loggingEnabled, or to value passed to setLoggingEnabled(bool).

setLoggingEnabled

public static void setLoggingEnabled(boolean loggingEnabled)

Turns logging on or off, without affecting logging configuration.

Parameters:

loggingEnabled - Flag whether logging is enabled or not; if false, all logging calls fail silently. Corresponds to configuration file property xr.util-logging.loggingEnabled

getLoggerImpl

public static XRLogger getLoggerImpl()

setLoggerImpl

public static void setLoggerImpl(XRLogger loggerImpl)