開發使用logging
//在程序文件頭部import相關的類
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
......
//在類中獲取一個實例
public class MYCLASS
{
private static Log log = LogFactory.getLog(MyCLASS.class);
...
 }

日志信息被送往記錄器,如上例中的log。這個發送過程,是通過調用Log接口中定義的方法完成的,不同方法跟不同的級別聯系在一起,日志信息通過哪個級別的方法發送,就標明了日志信息的級別。org.apache.commons.logging.Log接口中定義的方法,按嚴重性由高到低的順序有:

  1. log.fatal(Object message);
  2. log.fatal(Object message, Throwable t);
  3. log.error(Object message);
  4. log.error(Object message, Throwable t);
  5. log.warn(Object message);
  6. log.warn(Object message, Throwable t);
  7. log.info(Object message);
  8. log.info(Object message, Throwable t);
  9. log.debug(Object message);
  10. log.debug(Object message, Throwable t);
  11. log.trace(Object message);
  12. log.trace(Object message, Throwable t);
除此以外,還提供下列方法以便代碼保護.
  1. log.isFatalEnabled();
  2. log.isErrorEnabled();
  3. log.isWarnEnabled();
  4. log.isInfoEnabled();
  5. log.isDebugEnabled();
  6. log.isTraceEnabled();

  信息級別
  確保日志信息在內容上和反應問題的嚴重程度上的恰當,是非常重要的。
  1. fatal非常嚴重的錯誤,導致系統中止。期望這類信息能立即顯示在狀態控制臺上。
  2. error其它運行期錯誤或不是預期的條件。期望這類信息能立即顯示在狀態控制臺上。
  3. warn使用了不贊成使用的API、非常拙劣使用API, '幾乎就是'錯誤, 其它運行時不合需要和不合預期的狀態但還沒必要稱為 "錯誤"。期望這類信息能立即顯示在狀態控制臺上。
  4. info運行時產生的有意義的事件。期望這類信息能立即顯示在狀態控制臺上。
  5. debug系統流程中的細節信息。期望這類信息僅被寫入log文件中。
  6. trace更加細節的信息。期望這類信息僅被寫入log文件中。

通常情況下,記錄器的級別不應低于info.也就是說,通常情況下debug的信息不應被寫入log文件中。
  工作機理
  1. 生命周期
    JCL LogFactory必須實現建立/斷開到日志工具的連接,實例化/初始化/解構一個日志工具.
  2. 異常處理
    JCL Log 接口沒有指定任何異常處理,對接口的實現必須捕獲并處理異常。

  3. 多線程
    JCL Log 和 LogFactory 的實現,必須確保任何日志工具對并行的要求.

  記錄器的設置
  JCL采用的記錄器的不同其設置內容也不同。Log4J是默認首選記錄器,對其設置可通過系統屬性(system properties)或一個屬性文件進行設置,下面是其設置參數。
參數 值域 默認值 說明
log4j.configuration log4j.properties 指定配置文件的名字
log4j.rootCategory priority [, appender]* 設定根記錄器的級別
log4j.logger<.logger.name> DEBUG, INFO, WARN, ERROR, or FATAL 設定logger.name這個記錄器的級別
log4j.appender<.appender>.Threshold priority 指定記錄設備appender(console, files, sockets, and others)的最低級別。