com.snowtide.util.logging

Class LoggingRegistry

java.lang.Object

com.snowtide.util.logging.LoggingRegistry

public class LoggingRegistry
extends java.lang.Object

This class is provided to allow applications that use PDFTextStream to supply custom logging implementations.

Classes may be registered with this class that implement the LogFactory interface. Note that this class will create an instance of the implemenation class(es) provided to it using the Java Reflection API; this requires that the LogFactory implementation class have a no-arg constructor.

If no custom LogFactory class is registered, then PDFTextStream will use a default logging implementation that will use the following logging toolkits, in the following order of preference:

• The java.util.logging API
• Log4J
• A fallback implementation that outputs all logging messages to System.out

Log4J can be given preference over java.util.logging by setting the system property pdfts.loggingtype to log4j.

CRITICAL: If a custom logging implementation is to be used, it must be registered with this class before referencing any other PDFTextStream classes. This is because PDFTextStream retrieves all of the Log implementations it needs when its classes are first initialized, which is done when it is first used by outside application code.

Ensuring that this occurs is easy. Either:

• Set the pdfts.logfactory system property to the full classname of your LogFactory implementation
• Programmatically register your LogFactory implementation with this class in a static initializer block in your application: static { LoggingRegistry.register(MyLogFactoryImpl.class); }

Version:

©2004-2012 Snowtide Informatics Systems, Inc.

Method Summary

Methods

Modifier and Type	Method and Description
static Log	getLog(java.lang.Class c) Convenience method for retrieving a Log instance for the given Class from the current LogFactory.
static Log	getLog(java.lang.String logname) Convenience method for retrieving a Log instance with the given name from the current LogFactory.
static void	registerFactory(LogFactory impl) Registers the given LogFactory instance as the designated LogFactory implementation for creating Log objects.

Methods inherited from class java.lang.Object

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

Method Detail

registerFactory

public static void registerFactory(LogFactory impl)

Registers the given LogFactory instance as the designated LogFactory implementation for creating Log objects.

Parameters:

impl - - a LogFactory implementation

getLog

public static Log getLog(java.lang.Class c)

Convenience method for retrieving a Log instance for the given Class from the current LogFactory.

getLog

public static Log getLog(java.lang.String logname)

Convenience method for retrieving a Log instance with the given name from the current LogFactory.