<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. 簡介
    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à)值的鏈接)

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

    使用一個(gè)專門的日志記錄包,可以減輕對(duì)成千上萬的System.out.println語句的維護(hù)成本,因?yàn)槿罩居涗浛梢酝ㄟ^配置腳本在運(yùn)行時(shí)得以控制。 log4j維護(hù)嵌入在程序代碼中的日志記錄語句。通過規(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. 公共類 Logger

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

    2. 公共接口 Appender

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

    3. 公共抽象類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)行過程。

    • 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í)別: (以下描述來自log4j APIhttp://jakarta.apache.org/log4j/docs/api/index.html):

    • static Level ALL

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

    • 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ù)類名實(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 把日志事件寫入一個(gè)文件

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

    5. WriterAppender根據(jù)用戶的選擇把日志事件寫入到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è)專用于向只讀網(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并且打開變量"filename"指定的文件。

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

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

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

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

    這里是一個(gè)非常簡單的例子,程序?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è)非常簡單的例子,程序?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è)非常簡單的例子,程序?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è)方法可以用來指定外部配置文件:文本文件或者XML文件。既然現(xiàn)在所有事情都寫成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聲明作為開始,后面跟著指出DTD(文檔類型定義)的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類以全名形式給出,經(jīng)常用規(guī)范(fully qualified)類名。 Appender必須具有一個(gè)指定的 nameclass。嵌入在 Appender之內(nèi)的是 layout元素,這里它被指定為SimpleLayout。 Layout 必須具有一個(gè) class屬性。

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

    root元素必須存在且不能被子類化。示例中的優(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樹來初始化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。

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

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

    FeedBack:
    # re: log4j教程
    2013-03-27 09:19 | welody
    非常感謝你的分享!!謝謝。  回復(fù)  更多評(píng)論
      
    # re: log4j教程
    2013-09-05 14:06 | 馬金帥
    寫的太好了非常感謝你,讓我在短時(shí)間內(nèi)對(duì)log4j有了比較全面的了解,您辛苦了。  回復(fù)  更多評(píng)論
      
    # re: log4j教程[未登錄]
    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)航:
     
    主站蜘蛛池模板: 毛片免费观看网址| 中文字幕无码成人免费视频| 在线观看亚洲天天一三视| 深夜a级毛片免费无码| 国产成人亚洲综合无码| 久草视频在线免费看| 亚洲午夜成激人情在线影院| 成人毛片18女人毛片免费| 国产成人精品无码免费看| 免费国产黄网站在线观看动图| 亚洲人成在线中文字幕| 91亚洲精品视频| 国产美女无遮挡免费网站| av电影在线免费看| 亚洲噜噜噜噜噜影院在线播放| 亚洲午夜久久久影院| 久草在视频免费福利| 一级毛片在线完整免费观看| 亚洲黑人嫩小videos| 亚洲日韩中文无码久久| 亚洲成AV人网址| 免费看成人AA片无码视频羞羞网| 免费无码H肉动漫在线观看麻豆| 国产婷婷综合丁香亚洲欧洲| 亚洲综合激情另类专区| 国产a级特黄的片子视频免费| 亚洲视频免费在线观看| 日韩欧美亚洲国产精品字幕久久久| 国产亚洲成av片在线观看| 成人免费视频小说| 日韩欧毛片免费视频| 久视频精品免费观看99| 一出一进一爽一粗一大视频免费的| 亚洲AV日韩综合一区| 亚洲私人无码综合久久网| 亚洲综合视频在线| 亚洲美日韩Av中文字幕无码久久久妻妇| 四虎免费影院ww4164h| 乱淫片免费影院观看| 亚洲xxxx18| 亚洲中文字幕无码久久2020|