Author: bimargulies
Date: Mon Apr 14 04:30:28 2008
New Revision: 647735
URL: http://svn.apache.org/viewvc?rev=647735&view=rev
Log:
Add some more javadoc to LogUtils. Declare setLogger to take a
Class<? extends AbstractDelegatingLogger>, which is only the truth.
Modified:
incubator/cxf/trunk/common/common/src/main/java/org/apache/cxf/common/logging/LogUtils.java
Modified:
incubator/cxf/trunk/common/common/src/main/java/org/apache/cxf/common/logging/LogUtils.java
URL:
http://svn.apache.org/viewvc/incubator/cxf/trunk/common/common/src/main/java/org/apache/cxf/common/logging/LogUtils.java?rev=647735&r1=647734&r2=647735&view=diff
==============================================================================
---
incubator/cxf/trunk/common/common/src/main/java/org/apache/cxf/common/logging/LogUtils.java
(original)
+++
incubator/cxf/trunk/common/common/src/main/java/org/apache/cxf/common/logging/LogUtils.java
Mon Apr 14 04:30:28 2008
@@ -37,6 +37,16 @@
/**
* A container for static utility methods related to logging.
+ * By default, CXF logs to java.util.logging. An application can change this.
To log to another system, the
+ * application must provide an object that extends [EMAIL PROTECTED]
AbstractDelegatingLogger}, and advertise that class
+ * via one of the following mechanisms:
+ * <ul>
+ * <li>Create a file, in the classpath, named
META-INF/cxf/org.apache.cxf.logger.
+ * This file should contain the fully-qualified name
+ * of the class.</li>
+ * <li>Call [EMAIL PROTECTED] #setLoggerClass(Class)} with a Class<?>
reference to the logger class.</li>
+ * </ul>
+ * CXF provides [EMAIL PROTECTED] Log4jLogger} to use log4j instead of
java.util.logging.
*/
public final class LogUtils {
public static final String KEY = "org.apache.cxf.Logger";
@@ -78,9 +88,10 @@
/**
+ * Specify a logger class that inherits from [EMAIL PROTECTED]
AbstractDelegatingLogger}.
* Enable users to use their own logger implementation.
*/
- public static void setLoggerClass(Class<?> cls) {
+ public static void setLoggerClass(Class<? extends
AbstractDelegatingLogger> cls) {
loggerClass = cls;
}
