There is a great need for debugging and logging information inside of Commons components such as HTTPClient and dbcp. However, there are many logging APIs out there and it is difficult to choose among them. -
- -The Logging package will be an ultra-thin bridge between different logging libraries. Commons components may use the Logging JAR to remove compile-time/runtime dependencies on any particular logging package, and contributors may write Log implementations for the library of their choice. -
- -The package shall create and maintain a package that provides extremely basic logging functionality and bridges to other, more sophisticated logging implementations. -
- --The package should : -
-Non-goals: -
Logging relies on: -
- -logging in the
-jakarta-commons CVS repository.The initial committers on the Digester component shall be:
- -- * The specific {@link Log} implementation returned - * is determined by the value of the - * httpclient.log property. - * The value of httpclient.log may be set to - * the fully specified name of a class that implements - * the {@link Log} interface. This class must also - * have a public constructor that takes a single - * {@link String} argument (containing the name - * of the {@link Log} to be constructed. - *
- * When httpclient.log is not set, - * or when no corresponding class can be found, - * this method will return a {@link Log4JCategoryLog} - * if the log4j {@link org.apache.log4j.Category} class is - * available in the {@link LogSource}'s classpath, or - * a {@link NoOpLog} if it is not. - * - * @param name the log name (or category) - */ - static public Log makeNewLogInstance(String name) { - Log log = null; - String logclassname = System.getProperty("httpclient.log","org.apache.commons.httpclient.log.NoOpLog"); - try { - Class logclass = Class.forName(logclassname); - Class[] argtypes = new Class[1]; - argtypes[0] = "".getClass(); - Constructor ctor = logclass.getConstructor(argtypes); - Object[] args = new Object[1]; - args[0] = name; - log = (Log)(ctor.newInstance(args)); - } catch(Exception e) { - log = null; - } - if(null == log) { - if(_log4jIsAvailable) { - return new Log4JCategoryLog(name); - } else { - log = new NoOpLog(name); - } - } - return log; - } -} diff --git a/src/java/org/apache/commons/logging/NoOpLog.java b/src/java/org/apache/commons/logging/NoOpLog.java deleted file mode 100644 index 3af9d35..0000000 --- a/src/java/org/apache/commons/logging/NoOpLog.java +++ /dev/null @@ -1,30 +0,0 @@ -/* - * Copyright (C) The Apache Software Foundation. All rights reserved. - * - * This software is published under the terms of the Apache Software License - * version 1.1, a copy of which has been included with this distribution in - * the LICENSE file. - */ - -package org.apache.commons.logging; - -/** - * @author Rod Waldhoff - * @version $Id: NoOpLog.java,v 1.4 2001/08/08 20:35:22 morgand Exp $ - */ -public final class NoOpLog implements Log { - public NoOpLog() { } - public NoOpLog(String name) { } - public void debug(Object message) { } - public void debug(Object message, Throwable t) { } - public void info(Object message) { } - public void info(Object message, Throwable t) { } - public void warn(Object message) { } - public void warn(Object message, Throwable t) { } - public void error(Object message) { } - public void error(Object message, Throwable t) { } - public void fatal(Object message) { } - public void fatal(Object message, Throwable t) { } - public final boolean isDebugEnabled() { return false; } - public final boolean isInfoEnabled() { return false; } -} diff --git a/src/java/org/apache/commons/logging/SimpleLog.java b/src/java/org/apache/commons/logging/SimpleLog.java deleted file mode 100644 index f1ada19..0000000 --- a/src/java/org/apache/commons/logging/SimpleLog.java +++ /dev/null @@ -1,169 +0,0 @@ -/* - * Copyright (C) The Apache Software Foundation. All rights reserved. - * - * This software is published under the terms of the Apache Software License - * version 1.1, a copy of which has been included with this distribution in - * the LICENSE file. - */ - -package org.apache.commons.logging; - -import java.util.Properties; -import java.util.Enumeration; -import java.io.InputStream; -import java.text.SimpleDateFormat; -import java.text.DateFormat; -import java.util.Date; - -/** - * @author Rod Waldhoff - * @version $Id: SimpleLog.java,v 1.4 2001/08/08 20:35:22 morgand Exp $ - */ -public class SimpleLog implements Log { - static protected final Properties _simplelogProps = new Properties(); - static protected boolean _showlogname = false; - static protected boolean _showtime = false; - static protected DateFormat _df = null; - - static { - // add all system props that start with "httpclient." - Enumeration enum = System.getProperties().propertyNames(); - while(enum.hasMoreElements()) { - String name = (String)(enum.nextElement()); - if(null != name && name.startsWith("httpclient.")) { - _simplelogProps.setProperty(name,System.getProperty(name)); - } - } - - // add props from the resource simplelog.properties - InputStream in = ClassLoader.getSystemResourceAsStream("simplelog.properties"); - if(null != in) { - try { - _simplelogProps.load(in); - in.close(); - } catch(java.io.IOException e) { - // ignored - } - } - try { - } catch(Throwable t) { - // ignored - } - _showlogname = "true".equalsIgnoreCase(_simplelogProps.getProperty("httpclient.simplelog.showlogname","true")); - _showtime = "true".equalsIgnoreCase(_simplelogProps.getProperty("httpclient.simplelog.showdate","true")); - if(_showtime) { - _df = new SimpleDateFormat(_simplelogProps.getProperty("httpclient.simplelog.dateformat","yyyy/MM/dd HH:mm:ss:SSS zzz")); - } - } - - protected static final int DEBUG = 5; - protected static final int INFO = 4; - protected static final int WARN = 3; - protected static final int ERROR = 2; - protected static final int FATAL = 1; - protected int _logLevel = 2; - - protected String _name = null; - - public SimpleLog(String name) { - _name = name; - - String lvl = _simplelogProps.getProperty("httpclient.simplelog.log." + _name); - int i = String.valueOf(name).lastIndexOf("."); - while(null == lvl && i > -1) { - name = name.substring(0,i); - lvl = _simplelogProps.getProperty("httpclient.simplelog.log." + name); - i = String.valueOf(name).lastIndexOf("."); - } - if(null == lvl) { - lvl = _simplelogProps.getProperty("httpclient.simplelog.defaultlog"); - } - - if("debug".equalsIgnoreCase(lvl)) { - _logLevel = DEBUG; - } else if("info".equalsIgnoreCase(lvl)) { - _logLevel = INFO; - } else if("warn".equalsIgnoreCase(lvl)) { - _logLevel = WARN; - } else if("error".equalsIgnoreCase(lvl)) { - _logLevel = ERROR; - } else if("fatal".equalsIgnoreCase(lvl)) { - _logLevel = FATAL; - } - } - - protected void log(int type, Object message, Throwable t) { - if(_logLevel >= type) { - StringBuffer buf = new StringBuffer(); - if(_showtime) { - buf.append(_df.format(new Date())); - buf.append(" "); - } - switch(type) { - case DEBUG: buf.append("[DEBUG] "); break; - case INFO: buf.append("[INFO] "); break; - case WARN: buf.append("[WARN] "); break; - case ERROR: buf.append("[ERROR] "); break; - case FATAL: buf.append("[FATAL] "); break; - } - if(_showlogname) { - buf.append(String.valueOf(_name)).append(" - "); - } - buf.append(String.valueOf(message)); - if(t != null) { - buf.append(" <"); - buf.append(t.toString()); - buf.append(">"); - t.printStackTrace(); - } - System.out.println(buf.toString()); - } - } - - public final void debug(Object message) { - log(DEBUG,message,null); - } - - public final void debug(Object message, Throwable t) { - log(DEBUG,message,t); - } - - public final void info(Object message) { - log(INFO,message,null); - } - - public final void info(Object message, Throwable t) { - log(INFO,message,t); - } - - public final void warn(Object message) { - log(WARN,message,null); - } - public final void warn(Object message, Throwable t) { - log(WARN,message,t); - } - - public final void error(Object message) { - log(ERROR,message,null); - } - - public final void error(Object message, Throwable t) { - log(ERROR,message,t); - } - - public final void fatal(Object message) { - log(FATAL,message,null); - } - - public final void fatal(Object message, Throwable t) { - log(FATAL,message,t); - } - - public final boolean isDebugEnabled() { - return (_logLevel >= DEBUG); - } - - public final boolean isInfoEnabled() { - return (_logLevel >= INFO); - } -}