Log4j中文手冊(cè)下載地址http://www.matrix.org.cn/resource/upload/forum/2006_04_07_205056_ZCxoePRlHJ.pdf
log4j的好處在于：
1.通過修改配置文件，就可以決定log信息輸出到何處(console,文件,...),是否輸出。
這樣，在系統(tǒng)開發(fā)階段可以打印詳細(xì)的log信息以跟蹤系統(tǒng)運(yùn)行情況,而在系統(tǒng)穩(wěn)定后可以關(guān)閉log輸出,從而在能跟蹤系統(tǒng)運(yùn)行情況的同時(shí),又減少了垃圾代碼(System.out.println(...)等)。
2.使用log4j，需要整個(gè)系統(tǒng)有一個(gè)統(tǒng)一的log機(jī)制，有利于系統(tǒng)的規(guī)劃。
當(dāng)你在開發(fā)程序的時(shí)候, 調(diào)試(debugging)和日志(logging)都是非常重要的工作, 但是, 現(xiàn)在有太多的 logging API 問世, 因?yàn)樗麄兌疾诲e(cuò), 很難做一個(gè)抉擇. 國外 java 論壇對(duì)于這些 logging 方式也是有一番討論.
而 common logging 就是一個(gè)在這幾個(gè)不同的 logging API 中建立小小的橋梁.目前在 Java 中最有名的 Log 方式, 首推是 Log4j, 另是 JDK 1.4 Logging API. 除此之外, 還有 Avalon 中用的 LogKit 等等 . 而 commons-logging 也有實(shí)現(xiàn)一些基本 的 logging 方式為 NoOpLog 及 SimpleLog. 對(duì)于他們的比較不在這次討論范圍,
有興趣者請(qǐng)自行參閱參考文件.
快速使用 Logging 其實(shí) logging 非常簡(jiǎn)單去使用, 將 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");
}
}
在 / 放置一個(gè) jsp 測(cè)試 test-commons-logging.jsp
<%@ page import="com.softleader.newspaper.java.opensource.LoggingTest" %>
<% LoggingTest test = new LoggingTest(); test.hello();%>
你將會(huì)看到 tomcat console 會(huì)有下面輸出
log4j:WARN No appenders could be found for logger (com.softleader.newspaper.java.opensource.LoggingTest).
log4j:WARN Please initialize the log4j system properly.OKOK
是因?yàn)槟氵€沒有配置 commons-logging.properties, 馬上會(huì)為你介紹 ~~~.
設(shè)定 commons-logging.properties 你可以設(shè)置你的 log factory 是要使用哪一個(gè) 我以 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
接著根據(jù)你的 Logger 撰寫符合他的 properties 拿 Log4j 為例子 你就要在
/WEB-INF/classes/ 下放置一個(gè)
//日志輸出到文件
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
//日志輸出到控制臺(tái)
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
#日志的錯(cuò)誤級(jí)別
log4j.appender.MAIL.Threshold=ERROR
#緩存文件大小，日志達(dá)到512K時(shí)發(fā)送Email
log4j.appender.MAIL.BufferSize=512
#發(fā)件人
log4j.appender.MAIL.From=webmaster@bcxy.com
#發(fā)送郵件的服務(wù)器
log4j.appender.MAIL.SMTPHost=smtp.163.com
#郵件的標(biāo)題
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
此時(shí)你去執(zhí)行 test-commons-logging.jsp 輸出的內(nèi)容, 就會(huì)記錄在你的 c:\log 目錄的 test.log 中了 ps:如果沒有相關(guān)的 class 會(huì)使用到 SimpLog, 此時(shí)要設(shè)定的是
simplelog.properties 結(jié)論以我自己本身使用的經(jīng)驗(yàn), Log4j 可以滿足所有工程師, 所以我也是直接使用 log4j 而沒有使用 commons-logging.
不過為了增加產(chǎn)品的通用性, 避免移植時(shí)候的麻煩, 新的產(chǎn)品及項(xiàng)目, 我會(huì)將他改成 commons-logging api 去調(diào)用.
如果你對(duì)commons-logging的工作原理不是很了解，請(qǐng)參考＜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的配置之簡(jiǎn)單使它遍及于越來越多的應(yīng)用中了：Log4J配置文件實(shí)現(xiàn)了輸出到控制臺(tái)、文件、回滾文件、發(fā)送日志郵件、輸出到數(shù)據(jù)庫日志表、自定義標(biāo)簽等全套功能。擇其一二使用就夠用了，
log4j.rootLogger=DEBUG,CONSOLE,A1,im
log4j.addivity.org.apache=true
# 應(yīng)用于控制臺(tái)
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
#應(yīng)用于文件
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
# 應(yīng)用于文件回滾
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
#應(yīng)用于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
# 用于數(shù)據(jù)庫
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