Log4j中文手冊下載地址http://www.matrix.org.cn/resource/upload/forum/2006_04_07_205056_ZCxoePRlHJ.pdf
log4j的好處在于:
1.通過修改配置文件,就可以決定log信息輸出到何處(console,文件,...),是否輸出。
這樣,在系統(tǒng)開發(fā)階段可以打印詳細的log信息以跟蹤系統(tǒng)運行情況,而在系統(tǒng)穩(wěn)定后可以關閉log輸出,從而在能跟蹤系統(tǒng)運行情況的同時,又減少了垃圾代碼(System.out.println(...)等)。
2.使用log4j,需要整個系統(tǒng)有一個統(tǒng)一的log機制,有利于系統(tǒng)的規(guī)劃。
當你在開發(fā)程序的時候, 調試(debugging)和日志(logging)都是非常重要的工作, 但是, 現(xiàn)在有太多的 logging API 問世, 因為他們都不錯, 很難做一個抉擇. 國外 java 論壇對于這些 logging 方式也是有一番討論.
而 common logging 就是一個在這幾個不同的 logging API 中建立小小的橋梁.目前在 Java 中最有名的 Log 方式, 首推是 Log4j, 另是 JDK 1.4 Logging API. 除此之外, 還有 Avalon 中用的 LogKit 等等 . 而 commons-logging 也有實現(xiàn)一些基本 的 logging 方式為 NoOpLog 及 SimpleLog. 對于他們的比較不在這次討論范圍,
有興趣者請自行參閱參考文件.
快速使用 Logging 其實 logging 非常簡單去使用, 將 commons-logging.jar 放到 /WEB-INF/lib 之下.接著寫以下的代碼
LoggingTest.java
package com.softleader.newspaper.java.opensource;
import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
public class LoggingTest {
Log log = LogFactory.getLog(LoggingTest.class);
public void hello() {
log.error("ERROR");
log.debug("DEBUG");
log.warn("WARN");
log.info("INFO");
log.trace("TRACE");
System.out.println("OKOK");
}
}
在 / 放置一個 jsp 測試 test-commons-logging.jsp
<%@ page import="com.softleader.newspaper.java.opensource.LoggingTest" %>
<% LoggingTest test = new LoggingTest(); test.hello();%>
你將會看到 tomcat console 會有下面輸出
log4j:WARN No appenders could be found for logger (com.softleader.newspaper.java.opensource.LoggingTest).
log4j:WARN Please initialize the log4j system properly.OKOK
是因為你還沒有配置 commons-logging.properties, 馬上會為你介紹 ~~~.
設定 commons-logging.properties 你可以設置你的 log factory 是要使用哪一個 我以 Log4J 為例子 在 /WEB-INF/classes/commons-logging.properties 中寫入
org.apache.commons.logging.Log=org.apache.commons.logging.impl.Log4JCategoryLog
如果你 server 是使用 jdk1.4 以上的版本
可以使用 org.apache.commons.logging.impl.Jdk14Logger
接著根據你的 Logger 撰寫符合他的 properties 拿 Log4j 為例子 你就要在
/WEB-INF/classes/ 下放置一個
//日志輸出到文件
log4j.rootLogger=DEBUG, A_default
log4j.appender.A_default=org.apache.log4j.RollingFileAppender
log4j.appender.A_default.File=c://log/test.log
log4j.appender.A_default.MaxFileSize=4000KB
log4j.appender.A_default.MaxBackupIndex=10
log4j.appender.A_default.layout=org.apache.log4j.PatternLayout
log4j.appender.A_default.layout.ConversionPattern=%d{ISO8601} - %p - %m%n
//日志輸出到控制臺
log4j.rootLogger=INFO, A1
log4j.appender.A1=org.apache.log4j.ConsoleAppender
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n
//發(fā)送郵件
# Configuration for receiving e-mails when ERROR messages occur.
#自定義的Appender
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
#日志的錯誤級別
log4j.appender.MAIL.Threshold=ERROR
#緩存文件大小,日志達到512K時發(fā)送Email
log4j.appender.MAIL.BufferSize=512
#發(fā)件人
log4j.appender.MAIL.From=webmaster@bcxy.com
#發(fā)送郵件的服務器
log4j.appender.MAIL.SMTPHost=smtp.163.com
#郵件的標題
log4j.appender.MAIL.Subject=Log4J Message
#日志郵件的接收者
log4j.appender.MAIL.To=ezerg@126.com
#日志PatternLayout
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
#日志的格式
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
此時你去執(zhí)行 test-commons-logging.jsp 輸出的內容, 就會記錄在你的 c:\log 目錄的 test.log 中了 ps:如果沒有相關的 class 會使用到 SimpLog, 此時要設定的是
simplelog.properties 結論以我自己本身使用的經驗, Log4j 可以滿足所有工程師, 所以我也是直接使用 log4j 而沒有使用 commons-logging.
不過為了增加產品的通用性, 避免移植時候的麻煩, 新的產品及項目, 我會將他改成 commons-logging api 去調用.
如果你對commons-logging的工作原理不是很了解,請參考<commons-logging的使用方法>
另,mvnforum里面的commons-logging.properties寫法:
# This is configuration file which used to config Logging for mvnForum application
# mvnForum supports 2 Loggings: Log4J and jzonic
# Depend on your web server, you should choose a logging properly
# IMPORTANT NOTE FOR TOMCAT 5.x USERS:
#
# By default, Tomcat 5.x will not work with Log4J.
# However, this file (commons-logging.properties) with a line
# config : org.apache.commons.logging.LogFactory=org.apache.commons.logging.impl.Log4jFactory
# make Tomcat 5.x and Log4J work happyly together forever, I dont know why :-)
# Log4J
# This used to config logging Log4J
# Note that by default, common logging will look for Log4J first
# Comment out folling line to if you will use Jlo logging (also remember to enable Jlo below)
org.apache.commons.logging.LogFactory=org.apache.commons.logging.impl.Log4jFactory
# Jlo
# jlo.xml config logging which only log the statements (DEBUG, ERROR, TRACE, INFO, WARN)
# from the packages start with net.myvietnam and com.mvnforum.
# See properities/jlo.xml for detail about this logging
# See http://jzonic.org for documentation
# If you want to extend mvnForum application, you should be aware of that
# Uncomment folling line to choose jlo logging
# You will need Jlo if Log4j could not run on Tomcat 5.0.x, Tomcat 5.5.x or JRun 4
# NOTE: read comment above about Tomcat 5.x issue
# org.apache.commons.logging.LogFactory=org.jzonic.jlo.LogManager
====================================================================
LOG4J的配置之簡單使它遍及于越來越多的應用中了:Log4J配置文件實現(xiàn)了輸出到控制臺、文件、回滾文件、發(fā)送日志郵件、輸出到數據庫日志表、自定義標簽等全套功能。擇其一二使用就夠用了,
log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apache=true
# 應用于控制臺
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.Threshold=DEBUG
log4j.appender.CONSOLE.Target=System.out
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#log4j.appender.CONSOLE.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD] n%c[CATEGORY]%n%m[MESSAGE]%n%n
#應用于文件
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=file.log
log4j.appender.FILE.Append=false
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# Use this layout for LogFactor 5 analysis
# 應用于文件回滾
log4j.appender.ROLLING_FILE=org.apache.log4j.RollingFileAppender
log4j.appender.ROLLING_FILE.Threshold=ERROR
log4j.appender.ROLLING_FILE.File=rolling.log
log4j.appender.ROLLING_FILE.Append=true
log4j.appender.ROLLING_FILE.MaxFileSize=10KB
log4j.appender.ROLLING_FILE.MaxBackupIndex=1
log4j.appender.ROLLING_FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.ROLLING_FILE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#應用于socket
log4j.appender.SOCKET=org.apache.log4j.RollingFileAppender
log4j.appender.SOCKET.RemoteHost=localhost
log4j.appender.SOCKET.Port=5001
log4j.appender.SOCKET.LocationInfo=true
# Set up for Log Facter 5
log4j.appender.SOCKET.layout=org.apache.log4j.PatternLayout
log4j.appender.SOCET.layout.ConversionPattern=[start]%d{DATE}[DATE]%n%p[PRIORITY]%n%x[NDC]%n%t[THREAD]%n%c[CATEGORY]%n%m[MESSAGE]%n%n
# Log Factor 5 Appender
log4j.appender.LF5_APPENDER=org.apache.log4j.lf5.LF5Appender
log4j.appender.LF5_APPENDER.MaxNumberOfRecords=2000
# 發(fā)送日志給郵件
log4j.appender.MAIL=org.apache.log4j.net.SMTPAppender
log4j.appender.MAIL.Threshold=FATAL
log4j.appender.MAIL.BufferSize=10
log4j.appender.MAIL.From=web@www.wuset.com
log4j.appender.MAIL.SMTPHost=www.wusetu.com
log4j.appender.MAIL.Subject=Log4J Message
log4j.appender.MAIL.To=web@www.wusetu.com
log4j.appender.MAIL.layout=org.apache.log4j.PatternLayout
log4j.appender.MAIL.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
# 用于數據庫
log4j.appender.DATABASE=org.apache.log4j.jdbc.JDBCAppender
log4j.appender.DATABASE.URL=jdbc:mysql://localhost:3306/test
log4j.appender.DATABASE.driver=com.mysql.jdbc.Driver
log4j.appender.DATABASE.user=root
log4j.appender.DATABASE.password=
log4j.appender.DATABASE.sql=INSERT INTO LOG4J (Message) VALUES ('[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n')
log4j.appender.DATABASE.layout=org.apache.log4j.PatternLayout
log4j.appender.DATABASE.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=SampleMessages.log4j
log4j.appender.A1.DatePattern=yyyyMMdd-HH'.log4j'
log4j.appender.A1.layout=org.apache.log4j.xml.XMLLayout
#自定義Appender
log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender
log4j.appender.im.host = mail.cybercorlin.net
log4j.appender.im.username = username
log4j.appender.im.password = password
log4j.appender.im.recipient = corlin@cybercorlin.net
log4j.appender.im.layout=org.apache.log4j.PatternLayout
log4j.appender.im.layout.ConversionPattern =[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n