org.apache.commons.logging.impl

Class LogFactoryImpl

public class LogFactoryImpl extends LogFactory

Concrete subclass of LogFactory that implements the following algorithm to dynamically select a logging implementation class to instantiate a wrapper for.

If the selected Log implementation class has a setLogFactory() method that accepts a LogFactory parameter, this method will be called on each newly created instance to identify the associated factory. This makes factory configuration attributes available to the Log instance, if it so desires.

This factory will remember previously created Log instances for the same name, and will return them on repeated requests to the getInstance() method. This implementation ignores any configured attributes.

Version: $Revision: 1.33 $ $Date: 2004/03/06 21:52:59 $

Author: Rod Waldhoff Craig R. McClanahan Richard A. Sitze

Field Summary
protected Hashtableattributes
Configuration attributes.
protected Hashtableinstances
The Log instances that have already been created, keyed by logger name.
StringlogClassName
Name of the class implementing the Log interface.
protected ConstructorlogConstructor
The one-argument constructor of the Log implementation class that will be used to create new instances.
protected Class[]logConstructorSignature
The signature of the Constructor to be used.
protected MethodlogMethod
The one-argument setLogFactory method of the selected Log method, if it exists.
protected Class[]logMethodSignature
The signature of the setLogFactory method to be used.
static StringLOG_INTERFACE

The name of the Log interface class.

static StringLOG_PROPERTY
The name of the system property identifying our Log implementation class.
protected static StringLOG_PROPERTY_OLD
The deprecated system property used for backwards compatibility with the old LogSource class.
Constructor Summary
LogFactoryImpl()
Public no-arguments constructor required by the lookup mechanism.
Method Summary
ObjectgetAttribute(String name)
Return the configuration attribute with the specified name (if any), or null if there is no such attribute.
String[]getAttributeNames()
Return an array containing the names of all currently defined configuration attributes.
LoggetInstance(Class clazz)
Convenience method to derive a name from the specified class and call getInstance(String) with it.
LoggetInstance(String name)

Construct (if necessary) and return a Log instance, using the factory's current set of configuration attributes.

NOTE - Depending upon the implementation of the LogFactory you are using, the Log instance you are returned may or may not be local to the current application, and may or may not be returned again on a subsequent call with the same name argument.

protected StringgetLogClassName()
Return the fully qualified Java classname of the Log implementation we will be using.
protected ConstructorgetLogConstructor()

Return the Constructor that can be called to instantiate new Log instances.

IMPLEMENTATION NOTE - Race conditions caused by calling this method from more than one thread are ignored, because the same Constructor instance will ultimately be derived in all circumstances.

protected booleanisJdk13LumberjackAvailable()
Is JDK 1.3 with Lumberjack logging available?
protected booleanisJdk14Available()

Return true if JDK 1.4 or later logging is available.

protected booleanisLog4JAvailable()
Is a Log4J implementation available?
static ClassloadClass(String name)
MUST KEEP THIS METHOD PRIVATE.
protected LognewInstance(String name)
Create and return a new Log instance for the specified name.
voidrelease()
Release any internal references to previously created Log instances returned by this factory.
voidremoveAttribute(String name)
Remove any configuration attribute associated with the specified name.
voidsetAttribute(String name, Object value)
Set the configuration attribute with the specified name.

Field Detail

attributes

protected Hashtable attributes
Configuration attributes.

instances

protected Hashtable instances
The Log instances that have already been created, keyed by logger name.

logClassName

private String logClassName
Name of the class implementing the Log interface.

logConstructor

protected Constructor logConstructor
The one-argument constructor of the Log implementation class that will be used to create new instances. This value is initialized by getLogConstructor(), and then returned repeatedly.

logConstructorSignature

protected Class[] logConstructorSignature
The signature of the Constructor to be used.

logMethod

protected Method logMethod
The one-argument setLogFactory method of the selected Log method, if it exists.

logMethodSignature

protected Class[] logMethodSignature
The signature of the setLogFactory method to be used.

LOG_INTERFACE

private static final String LOG_INTERFACE

The name of the Log interface class.

LOG_PROPERTY

public static final String LOG_PROPERTY
The name of the system property identifying our Log implementation class.

LOG_PROPERTY_OLD

protected static final String LOG_PROPERTY_OLD
The deprecated system property used for backwards compatibility with the old LogSource class.

Constructor Detail

LogFactoryImpl

public LogFactoryImpl()
Public no-arguments constructor required by the lookup mechanism.

Method Detail

getAttribute

public Object getAttribute(String name)
Return the configuration attribute with the specified name (if any), or null if there is no such attribute.

Parameters: name Name of the attribute to return

getAttributeNames

public String[] getAttributeNames()
Return an array containing the names of all currently defined configuration attributes. If there are no such attributes, a zero length array is returned.

getInstance

public Log getInstance(Class clazz)
Convenience method to derive a name from the specified class and call getInstance(String) with it.

Parameters: clazz Class for which a suitable Log name will be derived

Throws: LogConfigurationException if a suitable Log instance cannot be returned

getInstance

public Log getInstance(String name)

Construct (if necessary) and return a Log instance, using the factory's current set of configuration attributes.

NOTE - Depending upon the implementation of the LogFactory you are using, the Log instance you are returned may or may not be local to the current application, and may or may not be returned again on a subsequent call with the same name argument.

Parameters: name Logical name of the Log instance to be returned (the meaning of this name is only known to the underlying logging implementation that is being wrapped)

Throws: LogConfigurationException if a suitable Log instance cannot be returned

getLogClassName

protected String getLogClassName()
Return the fully qualified Java classname of the Log implementation we will be using.

getLogConstructor

protected Constructor getLogConstructor()

Return the Constructor that can be called to instantiate new Log instances.

IMPLEMENTATION NOTE - Race conditions caused by calling this method from more than one thread are ignored, because the same Constructor instance will ultimately be derived in all circumstances.

Throws: LogConfigurationException if a suitable constructor cannot be returned

isJdk13LumberjackAvailable

protected boolean isJdk13LumberjackAvailable()
Is JDK 1.3 with Lumberjack logging available?

isJdk14Available

protected boolean isJdk14Available()

Return true if JDK 1.4 or later logging is available. Also checks that the Throwable class supports getStackTrace(), which is required by Jdk14Logger.

isLog4JAvailable

protected boolean isLog4JAvailable()
Is a Log4J implementation available?

loadClass

private static Class loadClass(String name)
MUST KEEP THIS METHOD PRIVATE.

Exposing this method outside of org.apache.commons.logging.LogFactoryImpl will create a security violation: This method uses AccessController.doPrivileged().

Load a class, try first the thread class loader, and if it fails use the loader that loaded this class.

newInstance

protected Log newInstance(String name)
Create and return a new Log instance for the specified name.

Parameters: name Name of the new logger

Throws: LogConfigurationException if a new instance cannot be created

release

public void release()
Release any internal references to previously created Log instances returned by this factory. This is useful in environments like servlet containers, which implement application reloading by throwing away a ClassLoader. Dangling references to objects in that class loader would prevent garbage collection.

removeAttribute

public void removeAttribute(String name)
Remove any configuration attribute associated with the specified name. If there is no such attribute, no action is taken.

Parameters: name Name of the attribute to remove

setAttribute

public void setAttribute(String name, Object value)
Set the configuration attribute with the specified name. Calling this with a null value is equivalent to calling removeAttribute(name).

Parameters: name Name of the attribute to set value Value of the attribute to set, or null to remove any setting for this attribute

Copyright 2002-2004 The Apache Software Foundation.