91精品久久久久久,国产日韩精品久久久,精品中文在线

log4j日志使用詳解[轉(zhuǎn)]

Posted on 2006-04-24 10:34 winder 閱讀(366) 評(píng)論(0) 編輯收藏所屬分類: 資料匯總

一、概述
?Log4j是Apache的一個(gè)開(kāi)放源代碼項(xiàng)目，通過(guò)使用Log4j，我們可以控制日志信息輸送的目的地是控制臺(tái)、文件

、GUI組件、甚至是套接口服務(wù)器、NT的事件記錄器、UNIX Syslog守護(hù)進(jìn)程等；我們也可以控制每一條日志的輸出格式

；通過(guò)定義每一條日志信息的級(jí)別，我們能夠更加細(xì)致地控制日志的生成過(guò)程。最令人感興趣的就是，這些可以通過(guò)一

個(gè)配置文件來(lái)靈活地進(jìn)行配置，而不需要修改應(yīng)用的代碼。
　　
　　此外，通過(guò)Log4j其他語(yǔ)言接口，您可以在C、C++、.Net、PL/SQL程序中使用Log4j，其語(yǔ)法和用法與在Java程序中

一樣，使得多語(yǔ)言分布式系統(tǒng)得到一個(gè)統(tǒng)一一致的日志組件模塊。而且，通過(guò)使用各種第三方擴(kuò)展，您可以很方便地將

Log4j集成到J2EE、JINI甚至是SNMP應(yīng)用中。

二，使用前的準(zhǔn)備。
?1、下載log4j 地址為：http://jakarta.apache.org/log4j/docs/download.html.
?2、你可能要用到的jar文件有：
??如果需要將日志發(fā)送到郵箱，則需要javamail API,JAF API (the JavaBeans Activation Framework)

下載地址：??http://java.sun.com/products/javamail/
?http://java.sun.com/beans/glasgow/jaf.html
??如果需要jms的支持，則需要jms API 下載地址為：

http://java.sun.com/products/jms/vendors.html
三， Log4j介紹
?Log4j由三個(gè)重要的組件構(gòu)成：日志信息的優(yōu)先級(jí) priority，日志信息的輸出目的地Appender，日志信息的輸

出格式（布局）layout。
?1、日志的優(yōu)先級(jí)，
?從低到高，依次有：DEBUG,INFO,WARN,ERROR,分別用來(lái)指定這條日志信息的重要程度；如果定義了了輸入的級(jí)

別為INFO，則只有等于及高于這個(gè)級(jí)別的才進(jìn)行處理，此時(shí)將輸入INFO,WARN,ERROR。值得注意的是，級(jí)別中還有兩個(gè)關(guān)

鍵字，
?ALL:打印所有的日志，
?OFF：關(guān)閉所有的日志輸出。
?
?2、輸出端 Appender

?log4j提供了以下幾種常用的輸出目的地：
?org.apache.log4j.ConsoleAppender，將日志信息輸出到控制臺(tái)
?org.apache.log4j.FileAppender，將日志信息輸出到一個(gè)文件
?org.apache.log4j.DailyRollingFileAppender，將日志信息輸出到一個(gè)，并且每天輸出到一個(gè)新的日志文件,

按照不同的配置可以定義每月一個(gè)日志文件，或者每周，每天，每小時(shí)，每分鐘等輸出一個(gè)新的日志文件。
?org.apache.log4j.RollingFileAppender，將日志信息輸出到一個(gè)文件，通過(guò)指定文件的的尺寸，當(dāng)文件大小

到達(dá)指定尺寸的時(shí)候會(huì)自動(dòng)把文件改名，如名為example.log的文件會(huì)改名為example.log.1，同時(shí)產(chǎn)生一個(gè)新的

example.log文件。如果新的文件再次達(dá)到指定尺寸，又會(huì)自動(dòng)把文件改名為example.log.2，同時(shí)產(chǎn)生一個(gè)example.log

文件。依此類推，直到example.log. MaxBackupIndex，MaxBackupIndex的值可在配置文件中定義。
?org.apache.log4j.WriterAppender，將日志信息以流格式發(fā)送到任意指定的地方。
?org.apache.log4j.jdbc.JDBCAppender，通過(guò)JDBC把日志信息輸出到數(shù)據(jù)庫(kù)中。
?org.apache.log4j.net.SMTPAppender,將日志信息以郵件的方式發(fā)送到指定的郵箱。

?3、輸出格式（布局）layout
?通過(guò)appender可以控制輸出的目的地，而如果要控制輸出的格式，就可通過(guò)log4j的layout組件來(lái)實(shí)現(xiàn)。通過(guò)配

置文件定義一個(gè)appender的輸出格式，Log4j提供的布局模式有以下幾種：
?org.apache.log4j.ConsoleAppender，輸出到控制臺(tái)
?org.apache.log4j.HTMLLayout，以HTML表格形式布局
?org.apache.log4j.PatternLayout，可以靈活地指定布局模式
?org.apache.log4j.SimpleLayout，包含日志信息的級(jí)別和信息字符串

?值得一提的是org.apache.log4j.PatternLayout 以Pattern方式的布局，使用Pattern的方式來(lái)指定布局。

pattern 的參數(shù)如下：ConversionPattern參數(shù)的格式含義
?格式名含義
?%c 輸出日志信息所屬的類的全名
?%d 輸出日志時(shí)間點(diǎn)的日期或時(shí)間，默認(rèn)格式為ISO8601，也可以在其后指定格式，比如：%d{yyy-MM-dd

HH:mm:ss }，輸出類似：2002-10-18- 22：10：28 ;比如 %d{HH:mm:ss,SSS} 或 %d{dd MMM yyyy HH:mm:ss,SSS}.
格式可以參考 java類 SimpleDateFormat,不過(guò) 按照此類的設(shè)置會(huì)影響速度。你可以選擇更快的方式 %d{ISO8601},

%d{ABSOLUTE}, %d{RELATIVE}.或者使用log4j的ISO8601DateFormat, AbsoluteTimeDateFormat,

RelativeTimeDateFormat 和 DateTimeDateFormat 方式.
?%f 輸出日志信息所屬的類的類名
?%l 輸出日志事件的發(fā)生位置，即輸出日志信息的語(yǔ)句處于它所在的類的第幾行
?%m 輸出代碼中指定的信息，如log(message)中的message
?%M 輸出日志信息中所發(fā)生的方法名。
?%n 輸出一個(gè)回車換行符，Windows平臺(tái)為“\r\n”，Unix平臺(tái)為“\n”
?%p 輸出優(yōu)先級(jí)，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL。如果是調(diào)用debug()輸出的，則為DEBUG，依此類推
?%r 輸出自應(yīng)用啟動(dòng)到輸出該日志信息所耗費(fèi)的毫秒數(shù)
?%t 輸出產(chǎn)生該日志事件的線程名
四、使用
?4.1.1 SimpleLayout 和 FileAppender 方式
以下是以文件的輸出方式Appender和簡(jiǎn)單的布局方式SimpleLayout的例子：

import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.SimpleLayout;
import org.apache.log4j.FileAppender;
public class simpandfile {
?? static Logger logger = Logger.getLogger(simpandfile.class);
?? public static void main(String args[]) {
????? SimpleLayout layout = new SimpleLayout();

????? FileAppender appender = null;
????? try {
???????? appender = new FileAppender(layout,"output1.txt",false);
????? } catch(Exception e) {}

????? logger.addAppender(appender);
????? logger.setLevel((Level) Level.DEBUG);

????? logger.debug("Here is some DEBUG");
????? logger.info("Here is some INFO");
????? logger.warn("Here is some WARN");
????? logger.error("Here is some ERROR");
????? logger.fatal("Here is some FATAL");
?? }
}
???????
?首先實(shí)例化Logger對(duì)象。static Logger logger = Logger.getLogger(simpandfile.class);然后指定輸出的方

式和布局 appender = new FileAppender(layout,"output1.txt",false);logger.addAppender(appender);
最后定義級(jí)別：logger.addAppender(appender);這樣完成了log4j日志類的初始化.接著就可以進(jìn)行日志輸出了。這就是

log4j日志類的使用時(shí)的一般順序。因以下程序比較簡(jiǎn)單，特別的地方將會(huì)有注釋，將不再解釋。

?4.1.2. HTMLLayout 和 WriterAppender

import java.io.*;
import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.HTMLLayout;
import org.apache.log4j.WriterAppender;
public class htmlandwrite {
?? static Logger logger = Logger.getLogger(htmlandwrite.class);
?? public static void main(String args[]) {
????? HTMLLayout layout = new HTMLLayout();

????? WriterAppender appender = null;
????? try {
???????? FileOutputStream output = new FileOutputStream("output2.html");
???????? appender = new WriterAppender(layout,output);
????? } catch(Exception e) {}

????? logger.addAppender(appender);
????? logger.setLevel((Level) Level.DEBUG);

4.1.3. PatternLayout and ConsoleAppender

import org.apache.log4j.Level;
import org.apache.log4j.Logger;
import org.apache.log4j.PatternLayout;
import org.apache.log4j.ConsoleAppender;
public class consandpatt {
?? static Logger logger = Logger.getLogger(consandpatt.class);
?? public static void main(String args[]) {

????? // Note, %n is newline
????? String pattern =? "Milliseconds since program start: %r %n";
???????????? pattern += "Classname of caller: %C %n";
???????????? pattern += "Date in ISO8601 format: %d{ISO8601} %n";
???????????? pattern += "Location of log event: %l %n";
???????????? pattern += "Message: %m %n %n";
?????
????? PatternLayout layout = new PatternLayout(pattern);
????? ConsoleAppender appender = new ConsoleAppender(layout);

????? logger.addAppender(appender);
????? logger.setLevel((Level) Level.DEBUG);

4.2 使用配置文件來(lái)定義輸出Appender和布局格式Layout
?log4j支持兩種方式的配置方式，.properties 二進(jìn)制文件和xml文件的方式。我們簡(jiǎn)單講一下.properties的配

置方式后，將主要討論xml文件的配置方式。
?
?4.2.1? 我們將以.properties文件的格式定義兩種輸出方式，一種是輸出到文件中，另一種是輸出到數(shù)據(jù)庫(kù)中

。
?
?首先定義simple.properties文件,文件定義如下：
?
?#定義了兩個(gè)輸出端
?log4j.rootLogger = INFO,f,db

?# 定義f輸出到文件,并且文件是隨著大小而增加的
?log4j.appender.f = org.apache.log4j.RollingFileAppender?
?log4j.appender.f.File = F:\\nepalon\\classes\\test1.log?
?log4j.appender.f.MaxFileSize = 1000KB?
?log4j.appender.f.MaxBackupIndex = 3?
?log4j.appender.f.layout = org.apache.log4j.PatternLayout
?
?log4j.appender.f.layout.ConversionPattern = %d{yyyy-MM-dd hh:mm:ss}:%p %t %c - %m%n

?#定義db輸出到數(shù)據(jù)庫(kù)
?log4j.appender.db = org.apache.log4j.jdbc.JDBCAppender
?log4j.appender.db.BufferSize = 40
?log4j.appender.db.Driver = com.microsoft.jdbc.sqlserver.SQLServerDriver
?log4j.appender.db.URL = jdbc:microsoft:sqlserver://127.0.0.1:1433;DatabaseName=test
?log4j.appender.db.User = sa
?log4j.appender.db.Password =
?log4j.appender.db.layout = org.apache.log4j.PatternLayout
?log4j.appender.db.layout.ConversionPattern = INSERT INTO log4j (createDate, thread, priority,

category, message) values('%d{ISO8601}', '%t', '%-5p', '%c', '%m')

?然后程序中將引用這配置文件。定義如下：

?import org.apache.log4j.Logger;
?import org.apache.log4j.xml.DOMConfigurator;

?public class Test {
?
?? ??static Logger logger = Logger.getLogger(Test.class);
?? ??public static void main(String args[]) {
????? ???//以property方式讀到配置文件。
???PropertyConfigurator.configure ( "simple.properties" ) ;
　
????? ???logger.debug("Here is some DEBUG");
????? ???logger.info("Here is some INFO");
????? ???logger.warn("Here is some WARN");
????? ???logger.error("Here is some ERROR");
????? ???logger.fatal("Here is some FATAL");
?? ??}
?}

?4.2.2 以xml配置

?程序如下：
?import org.apache.log4j.Logger;
?import org.apache.log4j.xml.DOMConfigurator;

?public class Test {
?
?? ??static Logger logger = Logger.getLogger(Test.class);
?? ??public static void main(String args[]) {
????? ???//以XML方式讀到配置文件。
??? DOMConfigurator.configure("xmllog4jconfig.xml");

　
????? ???logger.debug("Here is some DEBUG");
????? ???logger.info("Here is some INFO");
????? ???logger.warn("Here is some WARN");
????? ???logger.error("Here is some ERROR");
????? ???logger.fatal("Here is some FATAL");
?? ??}
?}

?xmllog4jconfig.xml 如下：

?<?xml version="1.0" encoding="UTF-8" ?>
?<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

?<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???????
? ?<appender name="appender" class="org.apache.log4j.FileAppender">
??? ??<param name="File" value="Indentify-Log.txt"/>
??? ??<param name="Append" value="false"/>
??? ??<layout class="org.apache.log4j.PatternLayout">
???? ??? <param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
??? ??</layout>
? ?</appender>

? ?<root>
??? ??<priority value ="debug"/>
??? ??<appender-ref ref="appender"/>
? ?</root>

?</log4j:configuration>

?對(duì)比properties方式和xml方式，可以看出他們程序中，除了定義讀取配置文件的方式不同外,其它的根本就沒(méi)

有區(qū)別了，這也就是log4j的魅力所在了，不需要改變程序，只需要通過(guò)改變定義的配置文件，我們就可以控制日志的輸

出方式，是否輸出，輸出格式。我們可以通過(guò)定義不同的xml文件來(lái)控制輸出方式.以下是各種輸出方式與布局的例子。
?
?4.2.3 比較簡(jiǎn)單的一個(gè)。
?<?xml version="1.0" encoding="gb2312" ?>
?<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
?<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???
? ?<appender name="CA" class="org.apache.log4j.ConsoleAppender">???
??? ??<layout class="org.apache.log4j.PatternLayout">
????? ??<param name="ConversionPattern" value="%d{ISO8601} %r [%c :: %p %m]%n"/>
??? ??</layout>
? ?</appender>

? ?<root>
??? ??<priority value ="debug"/>
??? ?<appender-ref ref="CA"/>
? ?</root>

?</log4j:configuration>
?
?4.2.4 文件的輸出 pattern的布局
?<?xml version="1.0" encoding="UTF-8" ?>
?<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

?<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???????
? ?<appender name="appender" class="org.apache.log4j.FileAppender">
??? ??<param name="File" value="Indentify-Log.txt"/>
??? ??<param name="Append" value="false"/>
??? ??<layout class="org.apache.log4j.PatternLayout">
????? ???<param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
??? ??</layout>
? ?</appender>

? ?<root>
??? ??<priority value ="debug"/>
??? ?<appender-ref ref="appender"/>
? ?</root>

?</log4j:configuration>

?4.2.5 控制臺(tái)的輸出和簡(jiǎn)單的布局
?<?xml version="1.0" encoding="UTF-8" ?>
?<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

?<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
???????
? ?<appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
??? ??<layout class="org.apache.log4j.SimpleLayout"/>
? ?</appender>

? ?<root>
??? ?<priority value ="debug" />
??? ??<appender-ref ref="ConsoleAppender"/>
? ?</root>

?</log4j:configuration>

?4.2.6 定義三種輸出方式，按照不同的級(jí)別，選擇不同的輸出方式.debug,info,級(jí)別通過(guò)System.out來(lái)打印。
?WARN,FATAL通過(guò)System.err來(lái)輸出。ERROR,FATAL發(fā)送到郵箱。

?<?xml version="1.0" encoding="UTF-8" ?>
?<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
?<log4j:configuration>
??? ?<appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
??????? ?<param name="Target" value="System.out" />
??????? ?<layout class="org.apache.log4j.PatternLayout">
??????????? ??<param name="ConversionPattern" value="[%d{ISO8601}] %-5p %c %m %n" />
?????? ?? </layout>
??????? ?<filter class="org.apache.log4j.varia.LevelRangeFilter">
??????????? ??<param name="LevelMin" value="DEBUG"/>
??????????? ??<param name="LevelMax" value="INFO"/>
??????? ?</filter>
??? ?</appender>
??? ?<appender name="STDERR"? class="org.apache.log4j.ConsoleAppender">
??????? ?<param name="Target" value="System.err" />
??????? ?<layout class="org.apache.log4j.PatternLayout">
??????????? ??<param name="ConversionPattern" value="[%d{ISO8601}] %-5p %c %m %n" />
?????? ??</layout>
??????? ?<filter class="org.apache.log4j.varia.LevelRangeFilter">
??????????? ??<param name="LevelMin" value="WARN"/>
?????????? ??<param name="LevelMax" value="FATAL"/>
??????? ?</filter>
??? ?</appender>

??? ?
??? ?
??? ?
??? ?<appender name="EMAIL"? class="org.apache.log4j.net.SMTPAppender">
??????? ?<param name="BufferSize" value="512" />
??????? ?<param name="SMTPHost" value="mail.suiyuanwu.com" />
??????? ?<param name="From" value="log4j@server5" />
??????? ?<param name="To" value="web@suiyuanwu.com" />
??????? ?<param name="Subject" value="[SMTPAppender] Application message" />
??????? ?<layout class="org.apache.log4j.PatternLayout">
??????????? ??<param name="ConversionPattern" value="[%d{ISO8601}]%n%n%-5p%n%n%c%n%n%m%n%n" />
??????? ?</layout>
??????? ?<filter class="org.apache.log4j.varia.LevelRangeFilter">
??????????? ??<param name="LevelMin" value="ERROR"/>
??????????? ??<param name="LevelMax" value="FATAL"/>
??????? ?</filter>
??? ?</appender>

??? ?
??? ?
??? ?
??? ?<root>
?????? ??<level value="all" />
??????? ?<appender-ref ref="STDOUT"/>
??????? ?<appender-ref ref="STDERR"/>
??????? ?<appender-ref ref="EMAIL" />
?? ? </root>
?</log4j:configuration>
???
五、參考資料
?1.http://www.vipan.com/htdocs/log4jhelp.html
???????? Don't Use System.out.println! Use Log4j - Vipan Singla
?2.http://jakarta.apache.org/log4j/docs/manual.html
? Short introduction to log4j - Ceki Gülcü - March 2002
?3.http://www-128.ibm.com/developerworks/cn/java/jw-log4j/
?log4j提供了對(duì)日志記錄的控制
?4.http://logging.apache.org/log4j/docs/documentation.html
?log4j提供的文檔。

新用戶注冊(cè) 刷新評(píng)論列表


只有注冊(cè)用戶登錄后才能發(fā)表評(píng)論。




網(wǎng)站導(dǎo)航: 博客園 IT新聞 Chat2DB C++博客博問(wèn) 管理
相關(guān)文章: log4j日志使用詳解[轉(zhuǎn)] 免費(fèi)JAVA電子書(shū)網(wǎng)站收集騾友們推薦的各個(gè)學(xué)習(xí)英文網(wǎng)站的匯總[轉(zhuǎn)]

冰之雨

log4j日志使用詳解[轉(zhuǎn)]

日歷

常用鏈接

留言簿(1)

隨筆分類

收藏夾

BLOG站點(diǎn)

CSS

JavaScript

JAVA站點(diǎn)

JAVA論壇

JAVA資源站

Linux站點(diǎn)

國(guó)外JAVA站點(diǎn)

國(guó)外JAVA站點(diǎn)2

國(guó)外站點(diǎn)

在線API

開(kāi)發(fā)綜合站

開(kāi)源站點(diǎn)

開(kāi)源項(xiàng)目

搜索引擎

網(wǎng)絡(luò)硬盤(pán)

網(wǎng)頁(yè)設(shè)計(jì)

考試認(rèn)證

英語(yǔ)學(xué)習(xí)站

酷站收集

最新評(píng)論