java.lang.Object | ||
↳ | org.apache.commons.logging.LogFactory | |
↳ | org.apache.commons.logging.impl.LogFactoryImpl |
Concrete subclass of LogFactory
that implements the
following algorithm to dynamically select a logging implementation
class to instantiate a wrapper for.
org.apache.commons.logging.Log
to identify the
requested implementation class.org.apache.commons.logging.Log
system property
to identify the requested implementation class.org.apache.commons.logging.impl.Log4JLogger
.org.apache.commons.logging.impl.Jdk14Logger
.org.apache.commons.logging.impl.SimpleLog
.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.
Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
String | ALLOW_FLAWED_CONTEXT_PROPERTY | The name (org.apache.commons.logging.Log.allowFlawedContext )
of the system property which can be set true/false to
determine system behaviour when a bad context-classloader is encountered. |
|||||||||
String | ALLOW_FLAWED_DISCOVERY_PROPERTY | The name (org.apache.commons.logging.Log.allowFlawedDiscovery )
of the system property which can be set true/false to
determine system behaviour when a bad logging adapter class is
encountered during logging discovery. |
|||||||||
String | ALLOW_FLAWED_HIERARCHY_PROPERTY | The name (org.apache.commons.logging.Log.allowFlawedHierarchy )
of the system property which can be set true/false to
determine system behaviour when a logging adapter class is
encountered which has bound to the wrong Log class implementation. |
|||||||||
String | LOG_PROPERTY | The name (org.apache.commons.logging.Log ) of the system
property identifying our Log implementation class. |
|||||||||
String | LOG_PROPERTY_OLD | The deprecated system property used for backwards compatibility with old versions of JCL. |
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.logging.LogFactory
|
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
attributes | Configuration attributes. | ||||||||||
instances | The Log instances that have
already been created, keyed by logger name. |
||||||||||
logConstructor | The one-argument constructor of the
Log
implementation class that will be used to create new instances. |
||||||||||
logConstructorSignature | The signature of the Constructor to be used. | ||||||||||
logMethod | The one-argument setLogFactory method of the selected
Log method, if it exists. |
||||||||||
logMethodSignature | The signature of the setLogFactory method to be used. |
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.logging.LogFactory
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public no-arguments constructor required by the lookup mechanism.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Return the configuration attribute with the specified name (if any),
or
null if there is no such attribute. | |||||||||||
Return an array containing the names of all currently defined
configuration attributes.
| |||||||||||
Construct (if necessary) and return a | |||||||||||
Convenience method to derive a name from the specified class and
call
getInstance(String) with it. | |||||||||||
Release any internal references to previously created
Log
instances returned by this factory. | |||||||||||
Remove any configuration attribute associated with the specified name.
| |||||||||||
Set the configuration attribute with the specified name.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Workaround for bug in Java1.2; in theory this method is not needed.
| |||||||||||
Gets the context classloader.
| |||||||||||
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
| |||||||||||
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
| |||||||||||
Workaround for bug in Java1.2; in theory this method is not needed.
| |||||||||||
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
| |||||||||||
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
| |||||||||||
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
| |||||||||||
Output a diagnostic message to a user-specified destination (if the
user has enabled diagnostic logging).
| |||||||||||
Create and return a new
Log
instance for the specified name. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.apache.commons.logging.LogFactory
| |||||||||||
From class
java.lang.Object
|
The name (org.apache.commons.logging.Log.allowFlawedContext
)
of the system property which can be set true/false to
determine system behaviour when a bad context-classloader is encountered.
When set to false, a LogConfigurationException is thrown if
LogFactoryImpl is loaded via a child classloader of the TCCL (this
should never happen in sane systems).
Default behaviour: true (tolerates bad context classloaders)
See also method setAttribute.
The name (org.apache.commons.logging.Log.allowFlawedDiscovery
)
of the system property which can be set true/false to
determine system behaviour when a bad logging adapter class is
encountered during logging discovery. When set to false, an
exception will be thrown and the app will fail to start. When set
to true, discovery will continue (though the user might end up
with a different logging implementation than they expected).
Default behaviour: true (tolerates bad logging adapters)
See also method setAttribute.
The name (org.apache.commons.logging.Log.allowFlawedHierarchy
)
of the system property which can be set true/false to
determine system behaviour when a logging adapter class is
encountered which has bound to the wrong Log class implementation.
When set to false, an exception will be thrown and the app will fail
to start. When set to true, discovery will continue (though the user
might end up with a different logging implementation than they expected).
Default behaviour: true (tolerates bad Log class hierarchy)
See also method setAttribute.
The name (org.apache.commons.logging.Log
) of the system
property identifying our Log
implementation class.
The deprecated system property used for backwards compatibility with old versions of JCL.
The Log
instances that have
already been created, keyed by logger name.
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.
The one-argument setLogFactory
method of the selected
Log
method, if it exists.
Public no-arguments constructor required by the lookup mechanism.
Return the configuration attribute with the specified name (if any),
or null
if there is no such attribute.
name | Name of the attribute to return |
---|
Return an array containing the names of all currently defined configuration attributes. If there are no such attributes, a zero length array is returned.
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.
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) |
---|
LogConfigurationException | if a suitable Log
instance cannot be returned
|
---|
Convenience method to derive a name from the specified class and
call getInstance(String)
with it.
clazz | Class for which a suitable Log name will be derived |
---|
LogConfigurationException | if a suitable Log
instance cannot be returned
|
---|
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.
Remove any configuration attribute associated with the specified name. If there is no such attribute, no action is taken.
name | Name of the attribute to remove |
---|
Set the configuration attribute with the specified name. Calling
this with a null
value is equivalent to calling
removeAttribute(name)
.
This method can be used to set logging configuration programmatically rather than via system properties. It can also be used in code running within a container (such as a webapp) to configure behaviour on a per-component level instead of globally as system properties would do. To use this method instead of a system property, call
LogFactory.getFactory().setAttribute(...)This must be done before the first Log object is created; configuration changes after that point will be ignored.
This method is also called automatically if LogFactory detects a commons-logging.properties file; every entry in that file is set automatically as an attribute here.
name | Name of the attribute to set |
---|---|
value | Value of the attribute to set, or null
to remove any setting for this attribute
|
Workaround for bug in Java1.2; in theory this method is not needed. See LogFactory.getClassLoader.
Gets the context classloader. This method is a workaround for a java 1.2 compiler bug.
LogConfigurationException |
---|
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
Return the fully qualified Java classname of the Log
implementation we will be using.
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
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.
LogConfigurationException | if a suitable constructor cannot be returned |
---|
Workaround for bug in Java1.2; in theory this method is not needed. See LogFactory.isDiagnosticsEnabled.
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
Is JDK 1.3 with Lumberjack logging available?
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
Return true
if JDK 1.4 or later logging
is available. Also checks that the Throwable
class
supports getStackTrace()
, which is required by
Jdk14Logger.
This method is deprecated.
Never invoked by this class; subclasses should not assume
it will be.
Is a Log4J implementation available?
Output a diagnostic message to a user-specified destination (if the user has enabled diagnostic logging).
msg | diagnostic message |
---|
Create and return a new Log
instance for the specified name.
name | Name of the new logger |
---|
LogConfigurationException | if a new instance cannot be created |
---|