org.mmbase.util.logging.commons.impl

Class MMBaseLoggingFactory

java.lang.Object

org.apache.commons.logging.LogFactory

org.mmbase.util.logging.commons.impl.MMBaseLoggingFactory

public class MMBaseLoggingFactory
extends org.apache.commons.logging.LogFactory

LogFactory for jakarta commons-logging who when used creates MMBase logging backed Log implementations.

Goal: To provide a single log configuration for applications that use both commons-logging and mmbase logging.
Achievement: By providing a commons-logging factory that uses mmbase-logging.

MMBaseLoggingFactory is a LogFactory for the jakarta commons-logging logging api. MMBaseLoggingFactory uses the MMBase logging mechanism found in org.mmbase.util.logging.Logging to provide the actual logging.

Version:

$Id$

Author:

Kees Jongenburger

Field Summary

Fields inherited from class org.apache.commons.logging.LogFactory

DIAGNOSTICS_DEST_PROPERTY, factories, FACTORY_DEFAULT, FACTORY_PROPERTIES, FACTORY_PROPERTY, HASHTABLE_IMPLEMENTATION_PROPERTY, nullClassLoaderFactory, PRIORITY_KEY, SERVICE_ID, TCCL_KEY

Constructor Summary

Constructors

Constructor and Description
MMBaseLoggingFactory()

Method Summary

Modifier and Type	Method and Description
Object	getAttribute(String name)
String[]	getAttributeNames()
org.apache.commons.logging.Log	getInstance(Class clazz) This method first first looks in it's internal cache if there is a existing Log for the given class.
org.apache.commons.logging.Log	getInstance(String category) This method first first looks in it's internal cache if there is a existing Log with the given name.
void	release() Release any internal references to previously created Log instances returned by this factory.
void	removeAttribute(String name) Remove any configuration attribute associated with the specified name.
void	setAttribute(String name, Object value) Set the configuration attribute with the specified name.

Methods inherited from class org.apache.commons.logging.LogFactory

createFactory, directGetContextClassLoader, getClassLoader, getContextClassLoader, getFactory, getLog, getLog, isDiagnosticsEnabled, logRawDiagnostic, newFactory, newFactory, objectId, release, releaseAll

Methods inherited from class java.lang.Object

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

Constructor Detail

MMBaseLoggingFactory

public MMBaseLoggingFactory()

Method Detail

getAttribute

public Object getAttribute(String name)

Specified by:

getAttribute in class org.apache.commons.logging.LogFactory

Parameters:

name - Name of the attribute to return

Returns:

the configuration attribute with the specified name (if any), or null if there is no such attribute.

getAttributeNames

public String[] getAttributeNames()

Specified by:

getAttributeNames in class org.apache.commons.logging.LogFactory

Returns:

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 org.apache.commons.logging.Log getInstance(Class clazz)
                                           throws org.apache.commons.logging.LogConfigurationException

This method first first looks in it's internal cache if there is a existing Log for the given class. If that is not the case the method uses org.mmbase.Version to determine the version of mmbase used and depending on the version create a MMBaseLogger;

Specified by:

getInstance in class org.apache.commons.logging.LogFactory

Parameters:

clazz - the class for witch to create a logger

Returns:

a mmbase backed Log implementationfor the given class

Throws:

org.apache.commons.logging.LogConfigurationException

getInstance

public org.apache.commons.logging.Log getInstance(String category)
                                           throws org.apache.commons.logging.LogConfigurationException

This method first first looks in it's internal cache if there is a existing Log with the given name. If that is not the case the method uses org.mmbase.Version to determine the version of mmbase used and depending on the version create a MMBaseLogger;

Specified by:

getInstance in class org.apache.commons.logging.LogFactory

Returns:

a mmbase backed Log implementation for the given log

Throws:

org.apache.commons.logging.LogConfigurationException

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.

Specified by:

release in class org.apache.commons.logging.LogFactory

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.

Specified by:

removeAttribute in class org.apache.commons.logging.LogFactory

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).

Specified by:

setAttribute in class org.apache.commons.logging.LogFactory

Parameters:

name - Name of the attribute to set

value - Value of the attribute to set, or null to remove any setting for this attribute