org.apache.commons.logging

Class LogFactory

java.lang.Object

org.apache.commons.logging.LogFactory

Direct Known Subclasses:

AndroidLoggerFactory, LogFactoryImpl

public abstract class LogFactory
extends Object

* Factory for creating Log instances, with discovery and configuration features similar to that employed by standard Java APIs such as JAXP. *

* *

* IMPLEMENTATION NOTE - This implementation is heavily based on the SAXParserFactory and DocumentBuilderFactory implementations * (corresponding to the JAXP pluggability APIs) found in Apache Xerces. *

* * @author Craig R. McClanahan * @author Costin Manolache * @author Richard A. Sitze * @version $Revision: 593798 $ $Date: 2007-11-10 18:40:43 +0100 $

Field Summary

Fields

Modifier and Type	Field and Description
static String	DIAGNOSTICS_DEST_PROPERTY
protected static Hashtable	factories
static String	FACTORY_DEFAULT
static String	FACTORY_PROPERTIES
static String	FACTORY_PROPERTY
static String	HASHTABLE_IMPLEMENTATION_PROPERTY
protected static LogFactory	nullClassLoaderFactory
static String	PRIORITY_KEY
protected static String	SERVICE_ID
static String	TCCL_KEY

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LogFactory()

Method Summary

Methods

Modifier and Type	Method and Description
protected static Object	createFactory(String factoryClass, ClassLoader classLoader)
protected static ClassLoader	directGetContextClassLoader()
abstract Object	getAttribute(String name)
abstract String[]	getAttributeNames()
protected static ClassLoader	getClassLoader(Class clazz)
protected static ClassLoader	getContextClassLoader()
static LogFactory	getFactory()
abstract Log	getInstance(Class clazz)
abstract Log	getInstance(String name)
static Log	getLog(Class clazz)
static Log	getLog(String name)
protected static boolean	isDiagnosticsEnabled()
protected static void	logRawDiagnostic(String msg)
protected static LogFactory	newFactory(String factoryClass, ClassLoader classLoader)
protected static LogFactory	newFactory(String factoryClass, ClassLoader classLoader, ClassLoader contextClassLoader)
static String	objectId(Object o)
abstract void	release()
static void	release(ClassLoader classLoader)
static void	releaseAll()
abstract void	removeAttribute(String name)
abstract void	setAttribute(String name, Object value)

Methods inherited from class java.lang.Object

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

Field Detail

PRIORITY_KEY

public static final String PRIORITY_KEY

See Also:

Constant Field Values

TCCL_KEY

public static final String TCCL_KEY

See Also:

Constant Field Values

FACTORY_PROPERTY

public static final String FACTORY_PROPERTY

See Also:

Constant Field Values

FACTORY_DEFAULT

public static final String FACTORY_DEFAULT

See Also:

Constant Field Values

FACTORY_PROPERTIES

public static final String FACTORY_PROPERTIES

See Also:

Constant Field Values

SERVICE_ID

protected static final String SERVICE_ID

See Also:

Constant Field Values

DIAGNOSTICS_DEST_PROPERTY

public static final String DIAGNOSTICS_DEST_PROPERTY

See Also:

Constant Field Values

HASHTABLE_IMPLEMENTATION_PROPERTY

public static final String HASHTABLE_IMPLEMENTATION_PROPERTY

See Also:

Constant Field Values

factories

protected static Hashtable factories

nullClassLoaderFactory

protected static LogFactory nullClassLoaderFactory

Constructor Detail

LogFactory

protected LogFactory()

Method Detail

getAttribute

public abstract Object getAttribute(String name)

getAttributeNames

public abstract String[] getAttributeNames()

getInstance

public abstract Log getInstance(Class clazz)
                         throws LogConfigurationException

Throws:

LogConfigurationException

getInstance

public abstract Log getInstance(String name)
                         throws LogConfigurationException

Throws:

LogConfigurationException

release

public abstract void release()

removeAttribute

public abstract void removeAttribute(String name)

setAttribute

public abstract void setAttribute(String name,
                Object value)

getFactory

public static LogFactory getFactory()
                             throws LogConfigurationException

Throws:

LogConfigurationException

getLog

public static Log getLog(Class clazz)
                  throws LogConfigurationException

Throws:

LogConfigurationException

getLog

public static Log getLog(String name)
                  throws LogConfigurationException

Throws:

LogConfigurationException

release

public static void release(ClassLoader classLoader)

releaseAll

public static void releaseAll()

getClassLoader

protected static ClassLoader getClassLoader(Class clazz)

getContextClassLoader

protected static ClassLoader getContextClassLoader()
                                            throws LogConfigurationException

Throws:

LogConfigurationException

directGetContextClassLoader

protected static ClassLoader directGetContextClassLoader()
                                                  throws LogConfigurationException

Throws:

LogConfigurationException

newFactory

protected static LogFactory newFactory(String factoryClass,
                    ClassLoader classLoader,
                    ClassLoader contextClassLoader)
                                throws LogConfigurationException

Throws:

LogConfigurationException

newFactory

protected static LogFactory newFactory(String factoryClass,
                    ClassLoader classLoader)

createFactory

protected static Object createFactory(String factoryClass,
                   ClassLoader classLoader)

isDiagnosticsEnabled

protected static boolean isDiagnosticsEnabled()

logRawDiagnostic

protected static final void logRawDiagnostic(String msg)

objectId

public static String objectId(Object o)