You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by tn...@apache.org on 2013/03/05 19:53:10 UTC
svn commit: r853148 [28/36] - in
/websites/production/commons/content/proper/commons-logging/javadocs:
api-1.0.4/ api-1.0.4/api/ api-1.0.4/apidocs/ api-1.0.4/apidocs/org/
api-1.0.4/apidocs/org/apache/ api-1.0.4/apidocs/org/apache/commons/
api-1.0.4/api...
Added: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html
==============================================================================
--- websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html (added)
+++ websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html Tue Mar 5 18:53:06 2013
@@ -0,0 +1,1228 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.4.2_04) on Tue May 09 23:05:19 BST 2006 -->
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<TITLE>
+LogFactory (Logging 1.1 API)
+</TITLE>
+
+<META NAME="keywords" CONTENT="org.apache.commons.logging.LogFactory class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LogFactory (Logging 1.1 API)";
+}
+</SCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LogFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../org/apache/commons/logging/LogSource.html" title="class in org.apache.commons.logging"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LogFactory.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+org.apache.commons.logging</FONT>
+<BR>
+Class LogFactory</H2>
+<PRE>
+java.lang.Object
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by"><B>org.apache.commons.logging.LogFactory</B>
+</PRE>
+<DL>
+<DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../../org/apache/commons/logging/impl/LogFactoryImpl.html" title="class in org.apache.commons.logging.impl">LogFactoryImpl</A></DD>
+</DL>
+<HR>
+<DL>
+<DT>public abstract class <B>LogFactory</B><DT>extends java.lang.Object</DL>
+
+<P>
+<p>Factory for creating <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> instances, with discovery and
+ configuration features similar to that employed by standard Java APIs
+ such as JAXP.</p>
+
+ <p><strong>IMPLEMENTATION NOTE</strong> - This implementation is heavily
+ based on the SAXParserFactory and DocumentBuilderFactory implementations
+ (corresponding to the JAXP pluggability APIs) found in Apache Xerces.</p>
+<P>
+
+<P>
+<DL>
+<DT><B>Version:</B></DT>
+ <DD>$Revision$ $Date: 2006-05-03 21:58:34 +0100 (Wed, 03 May 2006) $</DD>
+<DT><B>Author:</B></DT>
+ <DD>Craig R. McClanahan, Costin Manolache, Richard A. Sitze</DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#DIAGNOSTICS_DEST_PROPERTY">DIAGNOSTICS_DEST_PROPERTY</A></B></CODE>
+
+<BR>
+ The name (<code>org.apache.commons.logging.diagnostics.dest</code>)
+ of the property used to enable internal commons-logging
+ diagnostic output, in order to get information on what logging
+ implementations are being discovered, what classloaders they
+ are loaded through, etc.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.util.Hashtable</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#factories">factories</A></B></CODE>
+
+<BR>
+ The previously constructed <code>LogFactory</code> instances, keyed by
+ the <code>ClassLoader</code> with which it was created.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#FACTORY_DEFAULT">FACTORY_DEFAULT</A></B></CODE>
+
+<BR>
+ The fully qualified class name of the fallback <code>LogFactory</code>
+ implementation class to use, if no other can be found.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#FACTORY_PROPERTIES">FACTORY_PROPERTIES</A></B></CODE>
+
+<BR>
+ The name (<code>commons-logging.properties</code>) of the properties file to search for.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#FACTORY_PROPERTY">FACTORY_PROPERTY</A></B></CODE>
+
+<BR>
+ The name (<code>org.apache.commons.logging.LogFactory</code>) of the property
+ used to identify the LogFactory implementation
+ class name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#HASHTABLE_IMPLEMENTATION_PROPERTY">HASHTABLE_IMPLEMENTATION_PROPERTY</A></B></CODE>
+
+<BR>
+ Setting this system property
+ (<code>org.apache.commons.logging.LogFactory.HashtableImpl</code>)
+ value allows the <code>Hashtable</code> used to store
+ classloaders to be substituted by an alternative implementation.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#nullClassLoaderFactory">nullClassLoaderFactory</A></B></CODE>
+
+<BR>
+ Prevously constructed <code>LogFactory</code> instance as in the
+ <code>factories</code> map, but for the case where
+ <code>getClassLoader</code> returns <code>null</code>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#PRIORITY_KEY">PRIORITY_KEY</A></B></CODE>
+
+<BR>
+ The name (<code>priority</code>) of the key in the config file used to
+ specify the priority of that particular config file.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#SERVICE_ID">SERVICE_ID</A></B></CODE>
+
+<BR>
+ JDK1.3+ <a href="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html#Service%20Provider">
+ 'Service Provider' specification</a>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#TCCL_KEY">TCCL_KEY</A></B></CODE>
+
+<BR>
+ The name (<code>use_tccl</code>) of the key in the config file used
+ to specify whether logging classes should be loaded via the thread
+ context class loader (TCCL), or not.</TD>
+</TR>
+</TABLE>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+<A NAME="constructor_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Constructor Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected </CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#LogFactory()">LogFactory</A></B>()</CODE>
+
+<BR>
+ Protected constructor that is not available for public use.</TD>
+</TR>
+</TABLE>
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#createFactory(java.lang.String, java.lang.ClassLoader)">createFactory</A></B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader)</CODE>
+
+<BR>
+ Implements the operations described in the javadoc for newFactory.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.ClassLoader</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#directGetContextClassLoader()">directGetContextClassLoader</A></B>()</CODE>
+
+<BR>
+ Return the thread context class loader if available; otherwise return
+ null.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract java.lang.Object</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getAttribute(java.lang.String)">getAttribute</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ Return the configuration attribute with the specified name (if any),
+ or <code>null</code> if there is no such attribute.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract java.lang.String[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getAttributeNames()">getAttributeNames</A></B>()</CODE>
+
+<BR>
+ Return an array containing the names of all currently defined
+ configuration attributes.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.ClassLoader</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getClassLoader(java.lang.Class)">getClassLoader</A></B>(java.lang.Class clazz)</CODE>
+
+<BR>
+ Safely get access to the classloader for the specified class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.ClassLoader</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getContextClassLoader()">getContextClassLoader</A></B>()</CODE>
+
+<BR>
+ Calls LogFactory.directGetContextClassLoader under the control of an
+ AccessController class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getFactory()">getFactory</A></B>()</CODE>
+
+<BR>
+ Construct (if necessary) and return a <code>LogFactory</code>
+ instance, using the following ordered lookup procedure to determine
+ the name of the implementation class to be loaded.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getInstance(java.lang.Class)">getInstance</A></B>(java.lang.Class clazz)</CODE>
+
+<BR>
+ Convenience method to derive a name from the specified class and
+ call <code>getInstance(String)</code> with it.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getInstance(java.lang.String)">getInstance</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ Construct (if necessary) and return a <code>Log</code> instance,
+ using the factory's current set of configuration attributes.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getLog(java.lang.Class)">getLog</A></B>(java.lang.Class clazz)</CODE>
+
+<BR>
+ Convenience method to return a named logger, without the application
+ having to care about factories.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#getLog(java.lang.String)">getLog</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ Convenience method to return a named logger, without the application
+ having to care about factories.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#isDiagnosticsEnabled()">isDiagnosticsEnabled</A></B>()</CODE>
+
+<BR>
+ Indicates true if the user has enabled internal logging.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#logRawDiagnostic(java.lang.String)">logRawDiagnostic</A></B>(java.lang.String msg)</CODE>
+
+<BR>
+ Write the specified message to the internal logging destination.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#newFactory(java.lang.String, java.lang.ClassLoader)">newFactory</A></B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader)</CODE>
+
+<BR>
+ Method provided for backwards compatibility; see newFactory version that
+ takes 3 parameters.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#newFactory(java.lang.String, java.lang.ClassLoader, java.lang.ClassLoader)">newFactory</A></B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader,
+ java.lang.ClassLoader contextClassLoader)</CODE>
+
+<BR>
+ Return a new instance of the specified <code>LogFactory</code>
+ implementation class, loaded by the specified class loader.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#objectId(java.lang.Object)">objectId</A></B>(java.lang.Object o)</CODE>
+
+<BR>
+ Returns a string that uniquely identifies the specified object, including
+ its class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#release()">release</A></B>()</CODE>
+
+<BR>
+ Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A>
+ instances returned by this factory.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#release(java.lang.ClassLoader)">release</A></B>(java.lang.ClassLoader classLoader)</CODE>
+
+<BR>
+ Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><CODE>LogFactory</CODE></A>
+ instances that have been associated with the specified class loader
+ (if any), after calling the instance method <code>release()</code> on
+ each of them.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#releaseAll()">releaseAll</A></B>()</CODE>
+
+<BR>
+ Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><CODE>LogFactory</CODE></A>
+ instances, after calling the instance method <code>release()</code> on
+ each of them.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#removeAttribute(java.lang.String)">removeAttribute</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ Remove any configuration attribute associated with the specified name.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>abstract void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogFactory.html#setAttribute(java.lang.String, java.lang.Object)">setAttribute</A></B>(java.lang.String name,
+ java.lang.Object value)</CODE>
+
+<BR>
+ Set the configuration attribute with the specified name.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.lang.Object</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="PRIORITY_KEY"><!-- --></A><H3>
+PRIORITY_KEY</H3>
+<PRE>
+public static final java.lang.String <B>PRIORITY_KEY</B></PRE>
+<DL>
+<DD>The name (<code>priority</code>) of the key in the config file used to
+ specify the priority of that particular config file. The associated value
+ is a floating-point number; higher values take priority over lower values.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.PRIORITY_KEY">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="TCCL_KEY"><!-- --></A><H3>
+TCCL_KEY</H3>
+<PRE>
+public static final java.lang.String <B>TCCL_KEY</B></PRE>
+<DL>
+<DD>The name (<code>use_tccl</code>) of the key in the config file used
+ to specify whether logging classes should be loaded via the thread
+ context class loader (TCCL), or not. By default, the TCCL is used.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.TCCL_KEY">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="FACTORY_PROPERTY"><!-- --></A><H3>
+FACTORY_PROPERTY</H3>
+<PRE>
+public static final java.lang.String <B>FACTORY_PROPERTY</B></PRE>
+<DL>
+<DD>The name (<code>org.apache.commons.logging.LogFactory</code>) of the property
+ used to identify the LogFactory implementation
+ class name. This can be used as a system property, or as an entry in a
+ configuration properties file.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.FACTORY_PROPERTY">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="FACTORY_DEFAULT"><!-- --></A><H3>
+FACTORY_DEFAULT</H3>
+<PRE>
+public static final java.lang.String <B>FACTORY_DEFAULT</B></PRE>
+<DL>
+<DD>The fully qualified class name of the fallback <code>LogFactory</code>
+ implementation class to use, if no other can be found.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.FACTORY_DEFAULT">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="FACTORY_PROPERTIES"><!-- --></A><H3>
+FACTORY_PROPERTIES</H3>
+<PRE>
+public static final java.lang.String <B>FACTORY_PROPERTIES</B></PRE>
+<DL>
+<DD>The name (<code>commons-logging.properties</code>) of the properties file to search for.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.FACTORY_PROPERTIES">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="SERVICE_ID"><!-- --></A><H3>
+SERVICE_ID</H3>
+<PRE>
+protected static final java.lang.String <B>SERVICE_ID</B></PRE>
+<DL>
+<DD>JDK1.3+ <a href="http://java.sun.com/j2se/1.3/docs/guide/jar/jar.html#Service%20Provider">
+ 'Service Provider' specification</a>.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.SERVICE_ID">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="DIAGNOSTICS_DEST_PROPERTY"><!-- --></A><H3>
+DIAGNOSTICS_DEST_PROPERTY</H3>
+<PRE>
+public static final java.lang.String <B>DIAGNOSTICS_DEST_PROPERTY</B></PRE>
+<DL>
+<DD>The name (<code>org.apache.commons.logging.diagnostics.dest</code>)
+ of the property used to enable internal commons-logging
+ diagnostic output, in order to get information on what logging
+ implementations are being discovered, what classloaders they
+ are loaded through, etc.
+ <p>
+ If a system property of this name is set then the value is
+ assumed to be the name of a file. The special strings
+ STDOUT or STDERR (case-sensitive) indicate output to
+ System.out and System.err respectively.
+ <p>
+ Diagnostic logging should be used only to debug problematic
+ configurations and should not be set in normal production use.
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.DIAGNOSTICS_DEST_PROPERTY">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="HASHTABLE_IMPLEMENTATION_PROPERTY"><!-- --></A><H3>
+HASHTABLE_IMPLEMENTATION_PROPERTY</H3>
+<PRE>
+public static final java.lang.String <B>HASHTABLE_IMPLEMENTATION_PROPERTY</B></PRE>
+<DL>
+<DD><p>Setting this system property
+ (<code>org.apache.commons.logging.LogFactory.HashtableImpl</code>)
+ value allows the <code>Hashtable</code> used to store
+ classloaders to be substituted by an alternative implementation.
+ </p>
+ <p>
+ <strong>Note:</strong> <code>LogFactory</code> will print:
+ <code><pre>
+ [ERROR] LogFactory: Load of custom hashtable failed</em>
+ </pre></code>
+ to system error and then continue using a standard Hashtable.
+ </p>
+ <p>
+ <strong>Usage:</strong> Set this property when Java is invoked
+ and <code>LogFactory</code> will attempt to load a new instance
+ of the given implementation class.
+ For example, running the following ant scriplet:
+ <code><pre>
+ <java classname="${test.runner}" fork="yes" failonerror="${test.failonerror}">
+ ...
+ <sysproperty
+ key="org.apache.commons.logging.LogFactory.HashtableImpl"
+ value="org.apache.commons.logging.AltHashtable"/>
+ </java>
+ </pre></code>
+ will mean that <code>LogFactory</code> will load an instance of
+ <code>org.apache.commons.logging.AltHashtable</code>.
+ </p>
+ <p>
+ A typical use case is to allow a custom
+ Hashtable implementation using weak references to be substituted.
+ This will allow classloaders to be garbage collected without
+ the need to release them (on 1.3+ JVMs only, of course ;)
+ </p>
+<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../constant-values.html#org.apache.commons.logging.LogFactory.HASHTABLE_IMPLEMENTATION_PROPERTY">Constant Field Values</A></DL>
+</DL>
+<HR>
+
+<A NAME="factories"><!-- --></A><H3>
+factories</H3>
+<PRE>
+protected static java.util.Hashtable <B>factories</B></PRE>
+<DL>
+<DD>The previously constructed <code>LogFactory</code> instances, keyed by
+ the <code>ClassLoader</code> with which it was created.
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="nullClassLoaderFactory"><!-- --></A><H3>
+nullClassLoaderFactory</H3>
+<PRE>
+protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A> <B>nullClassLoaderFactory</B></PRE>
+<DL>
+<DD>Prevously constructed <code>LogFactory</code> instance as in the
+ <code>factories</code> map, but for the case where
+ <code>getClassLoader</code> returns <code>null</code>.
+ This can happen when:
+ <ul>
+ <li>using JDK1.1 and the calling code is loaded via the system
+ classloader (very common)</li>
+ <li>using JDK1.2+ and the calling code is loaded via the boot
+ classloader (only likely for embedded systems work).</li>
+ </ul>
+ Note that <code>factories</code> is a <i>Hashtable</i> (not a HashMap),
+ and hashtables don't allow null as a key.
+<P>
+<DL>
+</DL>
+</DL>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+<A NAME="constructor_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Constructor Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="LogFactory()"><!-- --></A><H3>
+LogFactory</H3>
+<PRE>
+protected <B>LogFactory</B>()</PRE>
+<DL>
+<DD>Protected constructor that is not available for public use.
+<P>
+</DL>
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="getAttribute(java.lang.String)"><!-- --></A><H3>
+getAttribute</H3>
+<PRE>
+public abstract java.lang.Object <B>getAttribute</B>(java.lang.String name)</PRE>
+<DL>
+<DD>Return the configuration attribute with the specified name (if any),
+ or <code>null</code> if there is no such attribute.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - Name of the attribute to return</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getAttributeNames()"><!-- --></A><H3>
+getAttributeNames</H3>
+<PRE>
+public abstract java.lang.String[] <B>getAttributeNames</B>()</PRE>
+<DL>
+<DD>Return an array containing the names of all currently defined
+ configuration attributes. If there are no such attributes, a zero
+ length array is returned.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInstance(java.lang.Class)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public abstract <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getInstance</B>(java.lang.Class clazz)
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Convenience method to derive a name from the specified class and
+ call <code>getInstance(String)</code> with it.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>clazz</CODE> - Class for which a suitable Log name will be derived
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable <code>Log</code>
+ instance cannot be returned</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInstance(java.lang.String)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public abstract <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getInstance</B>(java.lang.String name)
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD><p>Construct (if necessary) and return a <code>Log</code> instance,
+ using the factory's current set of configuration attributes.</p>
+
+ <p><strong>NOTE</strong> - Depending upon the implementation of
+ the <code>LogFactory</code> you are using, the <code>Log</code>
+ 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.</p>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - Logical name of the <code>Log</code> instance to be
+ returned (the meaning of this name is only known to the underlying
+ logging implementation that is being wrapped)
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable <code>Log</code>
+ instance cannot be returned</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="release()"><!-- --></A><H3>
+release</H3>
+<PRE>
+public abstract void <B>release</B>()</PRE>
+<DL>
+<DD>Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A>
+ 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.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="removeAttribute(java.lang.String)"><!-- --></A><H3>
+removeAttribute</H3>
+<PRE>
+public abstract void <B>removeAttribute</B>(java.lang.String name)</PRE>
+<DL>
+<DD>Remove any configuration attribute associated with the specified name.
+ If there is no such attribute, no action is taken.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - Name of the attribute to remove</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setAttribute(java.lang.String, java.lang.Object)"><!-- --></A><H3>
+setAttribute</H3>
+<PRE>
+public abstract void <B>setAttribute</B>(java.lang.String name,
+ java.lang.Object value)</PRE>
+<DL>
+<DD>Set the configuration attribute with the specified name. Calling
+ this with a <code>null</code> value is equivalent to calling
+ <code>removeAttribute(name)</code>.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - Name of the attribute to set<DD><CODE>value</CODE> - Value of the attribute to set, or <code>null</code>
+ to remove any setting for this attribute</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getFactory()"><!-- --></A><H3>
+getFactory</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A> <B>getFactory</B>()
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD><p>Construct (if necessary) and return a <code>LogFactory</code>
+ instance, using the following ordered lookup procedure to determine
+ the name of the implementation class to be loaded.</p>
+ <ul>
+ <li>The <code>org.apache.commons.logging.LogFactory</code> system
+ property.</li>
+ <li>The JDK 1.3 Service Discovery mechanism</li>
+ <li>Use the properties file <code>commons-logging.properties</code>
+ file, if found in the class path of this class. The configuration
+ file is in standard <code>java.util.Properties</code> format and
+ contains the fully qualified name of the implementation class
+ with the key being the system property defined above.</li>
+ <li>Fall back to a default implementation class
+ (<code>org.apache.commons.logging.impl.LogFactoryImpl</code>).</li>
+ </ul>
+
+ <p><em>NOTE</em> - If the properties file method of identifying the
+ <code>LogFactory</code> implementation class is utilized, all of the
+ properties defined in this file will be set as configuration attributes
+ on the corresponding <code>LogFactory</code> instance.</p>
+
+ <p><em>NOTE</em> - In a multithreaded environment it is possible
+ that two different instances will be returned for the same
+ classloader environment.
+ </p>
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if the implementation class is not
+ available or cannot be instantiated.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLog(java.lang.Class)"><!-- --></A><H3>
+getLog</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getLog</B>(java.lang.Class clazz)
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Convenience method to return a named logger, without the application
+ having to care about factories.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>clazz</CODE> - Class from which a log name will be derived
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable <code>Log</code>
+ instance cannot be returned</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLog(java.lang.String)"><!-- --></A><H3>
+getLog</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getLog</B>(java.lang.String name)
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Convenience method to return a named logger, without the application
+ having to care about factories.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - Logical name of the <code>Log</code> instance to be
+ returned (the meaning of this name is only known to the underlying
+ logging implementation that is being wrapped)
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable <code>Log</code>
+ instance cannot be returned</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="release(java.lang.ClassLoader)"><!-- --></A><H3>
+release</H3>
+<PRE>
+public static void <B>release</B>(java.lang.ClassLoader classLoader)</PRE>
+<DL>
+<DD>Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><CODE>LogFactory</CODE></A>
+ instances that have been associated with the specified class loader
+ (if any), after calling the instance method <code>release()</code> on
+ each of them.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>classLoader</CODE> - ClassLoader for which to release the LogFactory</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="releaseAll()"><!-- --></A><H3>
+releaseAll</H3>
+<PRE>
+public static void <B>releaseAll</B>()</PRE>
+<DL>
+<DD>Release any internal references to previously created <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><CODE>LogFactory</CODE></A>
+ instances, after calling the instance method <code>release()</code> on
+ each of them. 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.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getClassLoader(java.lang.Class)"><!-- --></A><H3>
+getClassLoader</H3>
+<PRE>
+protected static java.lang.ClassLoader <B>getClassLoader</B>(java.lang.Class clazz)</PRE>
+<DL>
+<DD>Safely get access to the classloader for the specified class.
+ <p>
+ Theoretically, calling getClassLoader can throw a security exception,
+ and so should be done under an AccessController in order to provide
+ maximum flexibility. However in practice people don't appear to use
+ security policies that forbid getClassLoader calls. So for the moment
+ all code is written to call this method rather than Class.getClassLoader,
+ so that we could put AccessController stuff in this method without any
+ disruption later if we need to.
+ <p>
+ Even when using an AccessController, however, this method can still
+ throw SecurityException. Commons-logging basically relies on the
+ ability to access classloaders, ie a policy that forbids all
+ classloader access will also prevent commons-logging from working:
+ currently this method will throw an exception preventing the entire app
+ from starting up. Maybe it would be good to detect this situation and
+ just disable all commons-logging? Not high priority though - as stated
+ above, security policies that prevent classloader access aren't common.
+<P>
+<DD><DL>
+<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getContextClassLoader()"><!-- --></A><H3>
+getContextClassLoader</H3>
+<PRE>
+protected static java.lang.ClassLoader <B>getContextClassLoader</B>()
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Calls LogFactory.directGetContextClassLoader under the control of an
+ AccessController class. This means that java code running under a
+ security manager that forbids access to ClassLoaders will still work
+ if this class is given appropriate privileges, even when the caller
+ doesn't have such privileges. Without using an AccessController, the
+ the entire call stack must have the privilege before the call is
+ allowed.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>the context classloader associated with the current thread,
+ or null if security doesn't allow it.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if there was some weird error while
+ attempting to get the context classloader.
+<DD><CODE>java.lang.SecurityException</CODE> - if the current java security policy doesn't
+ allow this class to access the context classloader.</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="directGetContextClassLoader()"><!-- --></A><H3>
+directGetContextClassLoader</H3>
+<PRE>
+protected static java.lang.ClassLoader <B>directGetContextClassLoader</B>()
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Return the thread context class loader if available; otherwise return
+ null.
+ <p>
+ Most/all code should call getContextClassLoader rather than calling
+ this method directly.
+ <p>
+ The thread context class loader is available for JDK 1.2
+ or later, if certain security conditions are met.
+ <p>
+ Note that no internal logging is done within this method because
+ this method is called every time LogFactory.getLogger() is called,
+ and we don't want too much output generated here.
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable class loader
+ cannot be identified.
+<DD><CODE>java.lang.SecurityException</CODE> - if the java security policy forbids
+ access to the context classloader from one of the classes in the
+ current call stack.<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="newFactory(java.lang.String, java.lang.ClassLoader, java.lang.ClassLoader)"><!-- --></A><H3>
+newFactory</H3>
+<PRE>
+protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A> <B>newFactory</B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader,
+ java.lang.ClassLoader contextClassLoader)
+ throws <A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></PRE>
+<DL>
+<DD>Return a new instance of the specified <code>LogFactory</code>
+ implementation class, loaded by the specified class loader.
+ If that fails, try the class loader used to load this
+ (abstract) LogFactory.
+ <p>
+ <h2>ClassLoader conflicts</h2>
+ Note that there can be problems if the specified ClassLoader is not the
+ same as the classloader that loaded this class, ie when loading a
+ concrete LogFactory subclass via a context classloader.
+ <p>
+ The problem is the same one that can occur when loading a concrete Log
+ subclass via a context classloader.
+ <p>
+ The problem occurs when code running in the context classloader calls
+ class X which was loaded via a parent classloader, and class X then calls
+ LogFactory.getFactory (either directly or via LogFactory.getLog). Because
+ class X was loaded via the parent, it binds to LogFactory loaded via
+ the parent. When the code in this method finds some LogFactoryYYYY
+ class in the child (context) classloader, and there also happens to be a
+ LogFactory class defined in the child classloader, then LogFactoryYYYY
+ will be bound to LogFactory@childloader. It cannot be cast to
+ LogFactory@parentloader, ie this method cannot return the object as
+ the desired type. Note that it doesn't matter if the LogFactory class
+ in the child classloader is identical to the LogFactory class in the
+ parent classloader, they are not compatible.
+ <p>
+ The solution taken here is to simply print out an error message when
+ this occurs then throw an exception. The deployer of the application
+ must ensure they remove all occurrences of the LogFactory class from
+ the child classloader in order to resolve the issue. Note that they
+ do not have to move the custom LogFactory subclass; that is ok as
+ long as the only LogFactory class it can find to bind to is in the
+ parent classloader.
+ <p>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>factoryClass</CODE> - Fully qualified name of the <code>LogFactory</code>
+ implementation class<DD><CODE>classLoader</CODE> - ClassLoader from which to load this class<DD><CODE>contextClassLoader</CODE> - is the context that this new factory will
+ manage logging for.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="../../../../org/apache/commons/logging/LogConfigurationException.html" title="class in org.apache.commons.logging">LogConfigurationException</A></CODE> - if a suitable instance
+ cannot be created<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="newFactory(java.lang.String, java.lang.ClassLoader)"><!-- --></A><H3>
+newFactory</H3>
+<PRE>
+protected static <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging">LogFactory</A> <B>newFactory</B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader)</PRE>
+<DL>
+<DD>Method provided for backwards compatibility; see newFactory version that
+ takes 3 parameters.
+ <p>
+ This method would only ever be called in some rather odd situation.
+ Note that this method is static, so overriding in a subclass doesn't
+ have any effect unless this method is called from a method in that
+ subclass. However this method only makes sense to use from the
+ getFactory method, and as that is almost always invoked via
+ LogFactory.getFactory, any custom definition in a subclass would be
+ pointless. Only a class with a custom getFactory method, then invoked
+ directly via CustomFactoryImpl.getFactory or similar would ever call
+ this. Anyway, it's here just in case, though the "managed class loader"
+ value output to the diagnostics will not report the correct value.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="createFactory(java.lang.String, java.lang.ClassLoader)"><!-- --></A><H3>
+createFactory</H3>
+<PRE>
+protected static java.lang.Object <B>createFactory</B>(java.lang.String factoryClass,
+ java.lang.ClassLoader classLoader)</PRE>
+<DL>
+<DD>Implements the operations described in the javadoc for newFactory.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>factoryClass</CODE> - <DD><CODE>classLoader</CODE> - used to load the specified factory class. This is
+ expected to be either the TCCL or the classloader which loaded this
+ class. Note that the classloader which loaded this class might be
+ "null" (ie the bootloader) for embedded systems.
+<DT><B>Returns:</B><DD>either a LogFactory object or a LogConfigurationException object.<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isDiagnosticsEnabled()"><!-- --></A><H3>
+isDiagnosticsEnabled</H3>
+<PRE>
+protected static boolean <B>isDiagnosticsEnabled</B>()</PRE>
+<DL>
+<DD>Indicates true if the user has enabled internal logging.
+ <p>
+ By the way, sorry for the incorrect grammar, but calling this method
+ areDiagnosticsEnabled just isn't java beans style.
+<P>
+<DD><DL>
+
+<DT><B>Returns:</B><DD>true if calls to logDiagnostic will have any effect.<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="logRawDiagnostic(java.lang.String)"><!-- --></A><H3>
+logRawDiagnostic</H3>
+<PRE>
+protected static final void <B>logRawDiagnostic</B>(java.lang.String msg)</PRE>
+<DL>
+<DD>Write the specified message to the internal logging destination.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>msg</CODE> - is the diagnostic message to be output.<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="objectId(java.lang.Object)"><!-- --></A><H3>
+objectId</H3>
+<PRE>
+public static java.lang.String <B>objectId</B>(java.lang.Object o)</PRE>
+<DL>
+<DD>Returns a string that uniquely identifies the specified object, including
+ its class.
+ <p>
+ The returned string is of form "classname@hashcode", ie is the same as
+ the return value of the Object.toString() method, but works even when
+ the specified object's class has overidden the toString method.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>o</CODE> - may be null.
+<DT><B>Returns:</B><DD>a string of form classname@hashcode, or "null" if param o is null.<DT><B>Since:</B></DT>
+ <DD>1.1</DD>
+</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LogFactory.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ PREV CLASS
+ <A HREF="../../../../org/apache/commons/logging/LogSource.html" title="class in org.apache.commons.logging"><B>NEXT CLASS</B></A></FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LogFactory.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright © 2001-2006 The Apache Software Foundation. All Rights Reserved.
+</BODY>
+</HTML>
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html
------------------------------------------------------------------------------
svn:keywords = Id Revision HeadURL
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogFactory.html
------------------------------------------------------------------------------
svn:mime-type = text/html
Added: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html
==============================================================================
--- websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html (added)
+++ websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html Tue Mar 5 18:53:06 2013
@@ -0,0 +1,510 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!--NewPage-->
+<HTML>
+<HEAD>
+<!-- Generated by javadoc (build 1.4.2_04) on Tue May 09 23:05:20 BST 2006 -->
+<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<TITLE>
+LogSource (Logging 1.1 API)
+</TITLE>
+
+<META NAME="keywords" CONTENT="org.apache.commons.logging.LogSource class">
+
+<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style">
+
+<SCRIPT type="text/javascript">
+function windowTitle()
+{
+ parent.document.title="LogSource (Logging 1.1 API)";
+}
+</SCRIPT>
+
+</HEAD>
+
+<BODY BGCOLOR="white" onload="windowTitle();">
+
+
+<!-- ========= START OF TOP NAVBAR ======= -->
+<A NAME="navbar_top"><!-- --></A>
+<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_top_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LogSource.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LogSource.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_top"></A>
+<!-- ========= END OF TOP NAVBAR ========= -->
+
+<HR>
+<!-- ======== START OF CLASS DATA ======== -->
+<H2>
+<FONT SIZE="-1">
+org.apache.commons.logging</FONT>
+<BR>
+Class LogSource</H2>
+<PRE>
+java.lang.Object
+ <IMG SRC="../../../../resources/inherit.gif" ALT="extended by"><B>org.apache.commons.logging.LogSource</B>
+</PRE>
+<HR>
+<B>Deprecated.</B> <I>Use <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><CODE>LogFactory</CODE></A> instead - The default factory
+ implementation performs exactly the same algorithm as this class did</I>
+<P>
+<DL>
+<DT>public class <B>LogSource</B><DT>extends java.lang.Object</DL>
+
+<P>
+<p>Factory for creating <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> instances. Applications should call
+ the <code>makeNewLogInstance()</code> method to instantiate new instances
+ of the configured <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> implementation class.</p>
+
+ <p>By default, calling <code>getInstance()</code> will use the following
+ algorithm:</p>
+ <ul>
+ <li>If Log4J is available, return an instance of
+ <code>org.apache.commons.logging.impl.Log4JLogger</code>.</li>
+ <li>If JDK 1.4 or later is available, return an instance of
+ <code>org.apache.commons.logging.impl.Jdk14Logger</code>.</li>
+ <li>Otherwise, return an instance of
+ <code>org.apache.commons.logging.impl.NoOpLog</code>.</li>
+ </ul>
+
+ <p>You can change the default behavior in one of two ways:</p>
+ <ul>
+ <li>On the startup command line, set the system property
+ <code>org.apache.commons.logging.log</code> to the name of the
+ <code>org.apache.commons.logging.Log</code> implementation class
+ you want to use.</li>
+ <li>At runtime, call <code>LogSource.setLogImplementation()</code>.</li>
+ </ul>
+<P>
+
+<P>
+<DL>
+<DT><B>Version:</B></DT>
+ <DD>$Id$</DD>
+<DT><B>Author:</B></DT>
+ <DD>Rod Waldhoff</DD>
+</DL>
+<HR>
+
+<P>
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+
+
+<!-- =========== FIELD SUMMARY =========== -->
+
+<A NAME="field_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Field Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#jdk14IsAvailable">jdk14IsAvailable</A></B></CODE>
+
+<BR>
+ <B>Deprecated.</B> Is JDK 1.4 logging available</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#log4jIsAvailable">log4jIsAvailable</A></B></CODE>
+
+<BR>
+ <B>Deprecated.</B> Is log4j available (in the current classpath)</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.lang.reflect.Constructor</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#logImplctor">logImplctor</A></B></CODE>
+
+<BR>
+ <B>Deprecated.</B> Constructor for current log class</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>protected static java.util.Hashtable</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#logs">logs</A></B></CODE>
+
+<BR>
+ <B>Deprecated.</B> </TD>
+</TR>
+</TABLE>
+
+<!-- ======== CONSTRUCTOR SUMMARY ======== -->
+
+
+<!-- ========== METHOD SUMMARY =========== -->
+
+<A NAME="method_summary"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=2><FONT SIZE="+2">
+<B>Method Summary</B></FONT></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#getInstance(java.lang.Class)">getInstance</A></B>(java.lang.Class clazz)</CODE>
+
+<BR>
+ <B>Deprecated.</B> Get a <code>Log</code> instance by class</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#getInstance(java.lang.String)">getInstance</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ <B>Deprecated.</B> Get a <code>Log</code> instance by class name</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static java.lang.String[]</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#getLogNames()">getLogNames</A></B>()</CODE>
+
+<BR>
+ <B>Deprecated.</B> Returns a <CODE>String</CODE> array containing the names of
+ all logs known to me.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#makeNewLogInstance(java.lang.String)">makeNewLogInstance</A></B>(java.lang.String name)</CODE>
+
+<BR>
+ <B>Deprecated.</B> Create a new <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> implementation, based
+ on the given <i>name</i>.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#setLogImplementation(java.lang.Class)">setLogImplementation</A></B>(java.lang.Class logclass)</CODE>
+
+<BR>
+ <B>Deprecated.</B> Set the log implementation/log implementation factory
+ by class.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static void</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/logging/LogSource.html#setLogImplementation(java.lang.String)">setLogImplementation</A></B>(java.lang.String classname)</CODE>
+
+<BR>
+ <B>Deprecated.</B> Set the log implementation/log implementation factory
+ by the name of the class.</TD>
+</TR>
+</TABLE>
+ <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
+<TD><B>Methods inherited from class java.lang.Object</B></TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD>
+</TR>
+</TABLE>
+
+<P>
+
+<!-- ============ FIELD DETAIL =========== -->
+
+<A NAME="field_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Field Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="logs"><!-- --></A><H3>
+logs</H3>
+<PRE>
+protected static java.util.Hashtable <B>logs</B></PRE>
+<DL>
+<DD><B>Deprecated.</B> <DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="log4jIsAvailable"><!-- --></A><H3>
+log4jIsAvailable</H3>
+<PRE>
+protected static boolean <B>log4jIsAvailable</B></PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Is log4j available (in the current classpath)
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="jdk14IsAvailable"><!-- --></A><H3>
+jdk14IsAvailable</H3>
+<PRE>
+protected static boolean <B>jdk14IsAvailable</B></PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Is JDK 1.4 logging available
+<P>
+<DL>
+</DL>
+</DL>
+<HR>
+
+<A NAME="logImplctor"><!-- --></A><H3>
+logImplctor</H3>
+<PRE>
+protected static java.lang.reflect.Constructor <B>logImplctor</B></PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Constructor for current log class
+<P>
+<DL>
+</DL>
+</DL>
+
+<!-- ========= CONSTRUCTOR DETAIL ======== -->
+
+
+<!-- ============ METHOD DETAIL ========== -->
+
+<A NAME="method_detail"><!-- --></A>
+<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
+<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
+<TD COLSPAN=1><FONT SIZE="+2">
+<B>Method Detail</B></FONT></TD>
+</TR>
+</TABLE>
+
+<A NAME="setLogImplementation(java.lang.String)"><!-- --></A><H3>
+setLogImplementation</H3>
+<PRE>
+public static void <B>setLogImplementation</B>(java.lang.String classname)
+ throws java.lang.LinkageError,
+ java.lang.ExceptionInInitializerError,
+ java.lang.NoSuchMethodException,
+ java.lang.SecurityException,
+ java.lang.ClassNotFoundException</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Set the log implementation/log implementation factory
+ by the name of the class. The given class
+ must implement <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A>, and provide a constructor that
+ takes a single <CODE>String</CODE> argument (containing the name
+ of the log).
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.LinkageError</CODE>
+<DD><CODE>java.lang.ExceptionInInitializerError</CODE>
+<DD><CODE>java.lang.NoSuchMethodException</CODE>
+<DD><CODE>java.lang.SecurityException</CODE>
+<DD><CODE>java.lang.ClassNotFoundException</CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="setLogImplementation(java.lang.Class)"><!-- --></A><H3>
+setLogImplementation</H3>
+<PRE>
+public static void <B>setLogImplementation</B>(java.lang.Class logclass)
+ throws java.lang.LinkageError,
+ java.lang.ExceptionInInitializerError,
+ java.lang.NoSuchMethodException,
+ java.lang.SecurityException</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Set the log implementation/log implementation factory
+ by class. The given class must implement <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A>,
+ and provide a constructor that takes a single <CODE>String</CODE>
+ argument (containing the name of the log).
+<P>
+<DD><DL>
+
+<DT><B>Throws:</B>
+<DD><CODE>java.lang.LinkageError</CODE>
+<DD><CODE>java.lang.ExceptionInInitializerError</CODE>
+<DD><CODE>java.lang.NoSuchMethodException</CODE>
+<DD><CODE>java.lang.SecurityException</CODE></DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInstance(java.lang.String)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getInstance</B>(java.lang.String name)</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Get a <code>Log</code> instance by class name
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getInstance(java.lang.Class)"><!-- --></A><H3>
+getInstance</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>getInstance</B>(java.lang.Class clazz)</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Get a <code>Log</code> instance by class
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="makeNewLogInstance(java.lang.String)"><!-- --></A><H3>
+makeNewLogInstance</H3>
+<PRE>
+public static <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging">Log</A> <B>makeNewLogInstance</B>(java.lang.String name)</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Create a new <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> implementation, based
+ on the given <i>name</i>.
+ <p>
+ The specific <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> implementation returned
+ is determined by the value of the
+ <tt>org.apache.commons.logging.log</tt> property.
+ The value of <tt>org.apache.commons.logging.log</tt> may be set to
+ the fully specified name of a class that implements
+ the <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> interface. This class must also
+ have a public constructor that takes a single
+ <CODE>String</CODE> argument (containing the <i>name</i>
+ of the <A HREF="../../../../org/apache/commons/logging/Log.html" title="interface in org.apache.commons.logging"><CODE>Log</CODE></A> to be constructed.
+ <p>
+ When <tt>org.apache.commons.logging.log</tt> is not set,
+ or when no corresponding class can be found,
+ this method will return a Log4JLogger
+ if the log4j Logger class is
+ available in the <A HREF="../../../../org/apache/commons/logging/LogSource.html" title="class in org.apache.commons.logging"><CODE>LogSource</CODE></A>'s classpath, or a
+ Jdk14Logger if we are on a JDK 1.4 or later system, or
+ NoOpLog if neither of the above conditions is true.
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>name</CODE> - the log name (or category)</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="getLogNames()"><!-- --></A><H3>
+getLogNames</H3>
+<PRE>
+public static java.lang.String[] <B>getLogNames</B>()</PRE>
+<DL>
+<DD><B>Deprecated.</B> <DD>Returns a <CODE>String</CODE> array containing the names of
+ all logs known to me.
+<P>
+<DD><DL>
+</DL>
+</DD>
+</DL>
+<!-- ========= END OF CLASS DATA ========= -->
+<HR>
+
+
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<A NAME="navbar_bottom"><!-- --></A>
+<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
+<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
+<TR>
+<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
+<A NAME="navbar_bottom_firstrow"><!-- --></A>
+<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
+ <TR ALIGN="center" VALIGN="top">
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
+ <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/LogSource.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
+ <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
+ </TR>
+</TABLE>
+</TD>
+<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
+</EM>
+</TD>
+</TR>
+
+<TR>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../org/apache/commons/logging/LogFactory.html" title="class in org.apache.commons.logging"><B>PREV CLASS</B></A>
+ NEXT CLASS</FONT></TD>
+<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
+ <A HREF="../../../../index.html" target="_top"><B>FRAMES</B></A>
+ <A HREF="LogSource.html" target="_top"><B>NO FRAMES</B></A>
+ <SCRIPT type="text/javascript">
+ <!--
+ if(window==top) {
+ document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>');
+ }
+ //-->
+</SCRIPT>
+<NOSCRIPT>
+ <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>
+</NOSCRIPT>
+
+</FONT></TD>
+</TR>
+<TR>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+ SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
+<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
+DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
+</TR>
+</TABLE>
+<A NAME="skip-navbar_bottom"></A>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+
+<HR>
+Copyright © 2001-2006 The Apache Software Foundation. All Rights Reserved.
+</BODY>
+</HTML>
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html
------------------------------------------------------------------------------
svn:keywords = Id Revision HeadURL
Propchange: websites/production/commons/content/proper/commons-logging/javadocs/api-1.1/org/apache/commons/logging/LogSource.html
------------------------------------------------------------------------------
svn:mime-type = text/html