<rt id="bn8ez"></rt>
<label id="bn8ez"></label>

  • <span id="bn8ez"></span>

    <label id="bn8ez"><meter id="bn8ez"></meter></label>

    posts - 64,comments - 22,trackbacks - 0
    1. 簡(jiǎn)介
    2. 安裝
    3. log4j基本概念
    3.1. Logger
    3.2. Appender
    3.2.1. 使用ConsoleAppender
    3.2.2. 使用FileAppender
    3.2.3. 使用WriterAppender
    3.3. Layout
    3.4. 基本示例
    3.4.1. SimpleLayout和FileAppender
    3.4.2. HTMLLayout和WriterAppender
    3.4.3. PatternLayout和ConsoleAppender
    4. 使用外部配置文件
    5. 參考資料 (以及一些有參考價(jià)值的鏈接)

    程序開(kāi)發(fā)環(huán)境中的日志記錄是由嵌入在程序中以輸出一些對(duì)開(kāi)發(fā)人員有用信息的語(yǔ)句所組成。例如,跟蹤語(yǔ)句(trace),結(jié)構(gòu)轉(zhuǎn)儲(chǔ)和常見(jiàn)的 System.out.println或printf調(diào)試語(yǔ)句。log4j提供分級(jí)方法在程序中嵌入日志記錄語(yǔ)句。日志信息具有多種輸出格式和多個(gè)輸出級(jí)別。

    使用一個(gè)專(zhuān)門(mén)的日志記錄包,可以減輕對(duì)成千上萬(wàn)的System.out.println語(yǔ)句的維護(hù)成本,因?yàn)槿罩居涗浛梢酝ㄟ^(guò)配置腳本在運(yùn)行時(shí)得以控制。 log4j維護(hù)嵌入在程序代碼中的日志記錄語(yǔ)句。通過(guò)規(guī)范日志記錄的處理過(guò)程,一些人認(rèn)為應(yīng)該鼓勵(lì)更多的使用日志記錄并且獲得更高程度的效率。

    為了使用我們即將要安裝的日志記錄工具,還必須要設(shè)置操作環(huán)境,只有這樣,工具才能知道從哪里找到它所需要的信息,并且操作系統(tǒng)知道從哪里找到這個(gè)工具。那么,怎樣做呢?實(shí)際上,它要求更改操作環(huán)境。

    1. 從 http://jakarta.apache.org/log4j/docs/download.html下載log4j發(fā)行版。

    2. 解壓存檔文件到合適的目錄中。

    3. 添加文件 dist/lib/log4j-1.2.6.jar 到 CLASSPATH 環(huán)境變量中。

    使用log4j大概涉及3個(gè)主要概念:

    1. 公共類(lèi) Logger

      Logger 負(fù)責(zé)處理日志記錄的大部分操作。

    2. 公共接口 Appender

      Appender 負(fù)責(zé)控制日志記錄操作的輸出。

    3. 公共抽象類(lèi)Layout

      Layout 負(fù)責(zé)格式化Appender的輸出。

    日志記錄器(Logger)是日志處理的核心組件。log4j具有5種正常級(jí)別(Level)。 日志記錄器(Logger)的可用級(jí)別Level (不包括自定義級(jí)別 Level), 以下內(nèi)容就是摘自log4j API (http://jakarta.apache.org/log4j/docs/api/index.html):

    • static Level DEBUG

      DEBUG Level指出細(xì)粒度信息事件對(duì)調(diào)試應(yīng)用程序是非常有幫助的。

    • static Level INFO

      INFO level表明 消息在粗粒度級(jí)別上突出強(qiáng)調(diào)應(yīng)用程序的運(yùn)行過(guò)程。

    • static Level WARN

      WARN level表明會(huì)出現(xiàn)潛在錯(cuò)誤的情形。

    • static Level ERROR

      ERROR level指出雖然發(fā)生錯(cuò)誤事件,但仍然不影響系統(tǒng)的繼續(xù)運(yùn)行。

    • static Level FATAL

      FATAL level指出每個(gè)嚴(yán)重的錯(cuò)誤事件將會(huì)導(dǎo)致應(yīng)用程序的退出。

    另外,還有兩個(gè)可用的特別的日志記錄級(jí)別: (以下描述來(lái)自log4j APIhttp://jakarta.apache.org/log4j/docs/api/index.html):

    • static Level ALL

      ALL Level是最低等級(jí)的,用于打開(kāi)所有日志記錄。

    • static Level OFF

      OFF Level是最高等級(jí)的,用于關(guān)閉所有日志記錄。

    日志記錄器(Logger)的行為是分等級(jí)的。

    有很多方法可以創(chuàng)建一個(gè)日志記錄器(Logger),下面方法可以取回root日志記錄器:

    Logger logger = Logger.getRootLogger();

    還可以這樣創(chuàng)建一個(gè)新的日志記錄器:

    Logger logger = Logger.getLogger("MyLogger");

    比較常用的用法,就是根據(jù)類(lèi)名實(shí)例化一個(gè)靜態(tài)的全局日志記錄器:

    static Logger logger = Logger.getLogger(test.class);

    所有這些創(chuàng)建的叫"logger"的日志記錄器都可以用下面方法設(shè)置級(jí)別:

    logger.setLevel((Level)Level.WARN);

    可以使用7個(gè)級(jí)別中的任何一個(gè); Level.DEBUG, Level.INFO, Level.WARN, Level.ERROR, Level.FATAL, Level.ALL and Level.OFF.

    Appender 控制日志怎樣輸出。下面列出一些可用的Appender(log4j API中所描述的http://jakarta.apache.org/log4j/docs/api/index.html):

    1. ConsoleAppender:使用用戶指定的布局(layout) 輸出日志事件到System.out或者 System.err。默認(rèn)的目標(biāo)是System.out。

    2. DailyRollingFileAppender 擴(kuò)展FileAppender,因此多個(gè)日志文件可以以一個(gè)用戶選定的頻率進(jìn)行循環(huán)日志記錄。

    3. FileAppender 把日志事件寫(xiě)入一個(gè)文件

    4. RollingFileAppender 擴(kuò)展FileAppender備份容量達(dá)到一定大小的日志文件。

    5. WriterAppender根據(jù)用戶的選擇把日志事件寫(xiě)入到Writer或者OutputStream。

    6. SMTPAppender 當(dāng)特定的日志事件發(fā)生時(shí),一般是指發(fā)生錯(cuò)誤或者重大錯(cuò)誤時(shí),發(fā)送一封郵件。

    7. SocketAppender 給遠(yuǎn)程日志服務(wù)器(通常是網(wǎng)絡(luò)套接字節(jié)點(diǎn))發(fā)送日志事件(LoggingEvent)對(duì)象。

    8. SocketHubAppender 給遠(yuǎn)程日志服務(wù)器群組(通常是網(wǎng)絡(luò)套接字節(jié)點(diǎn))發(fā)送日志事件(LoggingEvent)對(duì)象。

    9. SyslogAppender給遠(yuǎn)程異步日志記錄的后臺(tái)精靈程序(daemon)發(fā)送消息。

    10. TelnetAppender 一個(gè)專(zhuān)用于向只讀網(wǎng)絡(luò)套接字發(fā)送消息的log4j appender。

    還可以實(shí)現(xiàn) Appender 接口,創(chuàng)建以自己的方式進(jìn)行日志輸出的Appender。

    FileAppender可以用這種方式創(chuàng)建:

    FileAppender appender = null;
    try {
    appender = new FileAppender(new PatternLayout(),"filename");
    } catch(Exception e) {}

    上面用到的構(gòu)造函數(shù):

    FileAppender(Layout layout, String filename)
    實(shí)例化一個(gè)FileAppender并且打開(kāi)變量"filename"指定的文件。

    另一個(gè)有用的構(gòu)造函數(shù)是:

    FileAppender(Layout layout, String filename, boolean append)
    實(shí)例化一個(gè)FileAppender并且打開(kāi)變量"filename"指定的文件。

    這個(gè)構(gòu)造函數(shù)還可以選擇是否對(duì)指定的文件進(jìn)行追加的方式輸出。如果沒(méi)有指定值,那么默認(rèn)的方式就是追加。

    Appender必須使用一個(gè)與之相關(guān)聯(lián)的 Layout,這樣它才能知道怎樣格式化它的輸出。當(dāng)前,log4j具有三種類(lèi)型的Layout:

    這里是一個(gè)非常簡(jiǎn)單的例子,程序?qū)崿F(xiàn)了SimpleLayout和FileAppender:

    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");
    }
    }

    你可以下載: simpandfile.java。 還可以查看它的輸出: output1.txt.

    這里是一個(gè)非常簡(jiǎn)單的例子,程序?qū)崿F(xiàn)了 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);
    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");
    }
    }

    你可以下載: simpandfile.java. 還可以查看它的輸出:output1.txt.

    這里是一個(gè)非常簡(jiǎn)單的例子,程序?qū)崿F(xiàn)了PatternLayout和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);
    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");
    }
    }

    你可以下載:simpandfile.java. 還可以查看它的輸出: output2.txt.

    Log4j經(jīng)常與外部日志文件聯(lián)合使用,這樣很多可選項(xiàng)不必硬編碼在軟件中。使用外部配置文件的優(yōu)點(diǎn)就是修改可選項(xiàng)不需要重新編譯程序。唯一的缺點(diǎn)就是,由于用到io 指令,速度稍微有些減慢。

    有兩個(gè)方法可以用來(lái)指定外部配置文件:文本文件或者XML文件。既然現(xiàn)在所有事情都寫(xiě)成XML文件,那么該教程就重點(diǎn)講解XML文件方法,但是也包含相關(guān)文本文件的例子。首先,看看下面的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="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.SimpleLayout"/>
    </appender>
    <root>
    <priority value ="debug" />
    <appender-ref ref="ConsoleAppender"/>
    </root>
    </log4j:configuration>

    文件以標(biāo)準(zhǔn)的XML聲明作為開(kāi)始,后面跟著指出DTD(文檔類(lèi)型定義)的DOCTYPE聲明,它定義了XML文件的結(jié)構(gòu),例如,什么元素可以嵌入在其他元素中等等。上面文件在log4j發(fā)行版的src/java/org/apache/log4j/xml目錄中。 接著看看封裝所有元素的 log4j:configuration 元素,它在DOCTYPE聲明中被指定為根元素。嵌入在根元素中有兩個(gè)結(jié)構(gòu):

    <appender name="ConsoleAppender" class="org.apache.log4j.ConsoleAppender">
    <layout class="org.apache.log4j.SimpleLayout"/>
    </appender>

    這里創(chuàng)建一個(gè)名叫"ConsoleAppender"的 Appender,注意,你可以選擇任何名字,該示例之所以選擇"ConsoleAppender",完全是為了示例的設(shè)計(jì)。接著這個(gè)appender類(lèi)以全名形式給出,經(jīng)常用規(guī)范(fully qualified)類(lèi)名。 Appender必須具有一個(gè)指定的 nameclass。嵌入在 Appender之內(nèi)的是 layout元素,這里它被指定為SimpleLayout。 Layout 必須具有一個(gè) class屬性。

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

    root元素必須存在且不能被子類(lèi)化。示例中的優(yōu)先級(jí)被設(shè)置為"debug",設(shè)置appender飽含一個(gè)appender-ref元素。還有更多的屬性或元素可以指定。查看log4j發(fā)行版中的src/java/org/apache/log4j/xml/log4j.dtd以了解關(guān)于XML配置文件結(jié)構(gòu)的更多信息。可以用下面這種方法把配置信息文件讀入到Java程序中:

    DOMConfigurator.configure("configurationfile.xml");

    DOMConfigurator 用一棵DOM樹(shù)來(lái)初始化log4j環(huán)境。這里是示例中的XML配置文件:plainlog4jconfig.xml。這里是執(zhí)行該配置文件的程序: files/externalxmltest.java:

    import org.apache.log4j.Logger;
    import org.apache.log4j.xml.DOMConfigurator;
    public class externalxmltest {
    static Logger logger = Logger.getLogger(filetest.class);
    public static void main(String args[]) {
    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");
    }
    }

    這里是一個(gè)實(shí)現(xiàn)帶有PatternLayoutFileAppender的日志記錄器Logger的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>

    你可以從這里下載示例: xmllog4jconfig2.xml。 想要得到更多的使用XML文件配置log4j環(huán)境的例子,請(qǐng)查看log4j發(fā)行版的目錄src/java/org/apache/log4j/xml/examples/ 。

    這就是上面討論的文本文件形式的配置文件:

    # initialise root logger with level DEBUG and call it BLAHlog4j.rootLogger=DEBUG,
    BLAH# add a ConsoleAppender to the logger BLAHlog4j.appender.BLAH=
    org.apache.log4j.ConsoleAppender# set set that layout to be SimpleLayoutlog4j.appender.BLAH.layout=
    org.apache.log4j.SimpleLayout

    從這里可以下載: plainlog4jconfig.txt。這就是執(zhí)行該配置文件的程序:

    import org.apache.log4j.Logger;
    import org.apache.log4j.PropertyConfigurator;
    public class externalplaintest {
    static Logger logger = Logger.getLogger(externalplaintest.class);
    public static void main(String args[]) {
    PropertyConfigurator.configure("plainlog4jconfig.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");
    }
    }

    你可以下載使用該配置文件的示例: externalplaintest.java。想要獲得更多的使用文本文件配置log4j環(huán)境的例子,請(qǐng)查看log4j發(fā)行版中的目錄examples

    使用外部配置文件的例子就簡(jiǎn)單的討論到這里,現(xiàn)在應(yīng)該可以肯定你已經(jīng)有能力獨(dú)立學(xué)習(xí)更多的log4j發(fā)行版和測(cè)試版中提供的例子。

    posted on 2011-11-30 11:36 hellxoul 閱讀(16826) 評(píng)論(5)  編輯  收藏

    FeedBack:
    # re: log4j教程
    2013-03-27 09:19 | welody
    非常感謝你的分享!!謝謝。  回復(fù)  更多評(píng)論
      
    # re: log4j教程
    2013-09-05 14:06 | 馬金帥
    寫(xiě)的太好了非常感謝你,讓我在短時(shí)間內(nèi)對(duì)log4j有了比較全面的了解,您辛苦了。  回復(fù)  更多評(píng)論
      
    # re: log4j教程[未登錄](méi)
    2014-01-07 15:18 | jet
    it's very helpful, thanks a lot for sharing  回復(fù)  更多評(píng)論
      
    # re: log4j教程
    2014-09-19 22:23 | zuidaima
    # re: log4j教程
    2014-10-28 14:12 | 波哥哥
    這個(gè)教程太好了!謝謝  回復(fù)  更多評(píng)論
      

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


    網(wǎng)站導(dǎo)航:
     
    主站蜘蛛池模板: 国产亚洲老熟女视频| 6080午夜一级毛片免费看6080夜福利| 亚洲精品无码专区| 亚洲午夜久久久精品电影院| 精品亚洲成a人片在线观看| 亚洲高清在线观看| 亚洲电影中文字幕| 亚洲熟妇色自偷自拍另类| 亚洲国产精品线观看不卡 | 一区二区三区四区免费视频 | 两个人www免费高清视频| 成人免费777777被爆出| 18禁在线无遮挡免费观看网站| 97在线免费观看视频| 污视频在线观看免费| 91精品免费国产高清在线| 黄页网站免费观看| 日韩高清免费观看| 亚洲成a人片在线观看久| 亚洲无码视频在线| 亚洲AV永久无码精品水牛影视| 老司机亚洲精品影院无码| 亚洲人成网站在线观看播放青青| 亚洲国产熟亚洲女视频| 亚洲精品自偷自拍无码| 成人亚洲国产精品久久| 亚洲精品国产日韩无码AV永久免费网| 免费无码又爽又刺激高潮软件| 99精品视频在线免费观看| 野花高清在线观看免费3中文| 日本一道高清不卡免费| 亚洲精品无码成人片在线观看 | 亚洲国产成人影院播放| 国产成人亚洲综合无码精品| 亚洲电影在线免费观看| 亚洲国产精品无码中文lv| 一个人看的免费高清视频日本| 亚洲免费视频网站| 日产乱码一卡二卡三免费| 亚洲码国产精品高潮在线| 亚洲女人初试黑人巨高清|