Pudgy's World
          posts - 13,  comments - 16,  trackbacks - 0

          目錄

          使用log4j大概涉及3個主要概念:

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

          • static Level DEBUG

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

          • static Level INFO

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

          • static Level WARN

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

          • static Level ERROR

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

          • static Level FATAL

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

          另外,還有兩個可用的特別的日志記錄級別: (以下描述來自log4j API http://jakarta.apache.org/log4j/docs/api/index.html):

          • static Level ALL

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

          • static Level OFF

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

          日志記錄器(Logger)的行為是分等級的。如下表所示:

          日志記錄器(Logger)將只輸出那些級別高于或等于它的級別的信息。如果沒有設(shè)置日志記錄器(Logger)的級別,那么它將會繼承最近的祖先的級別。因此,如果在包com.foo.bar中創(chuàng)建一個日志記錄器(Logger)并且沒有設(shè)置級別,那它將會繼承在包com.foo中創(chuàng)建的日志記錄器(Logger)的級別。如果在com.foo中沒有創(chuàng)建日志記錄器(Logger)的話,那么在com.foo.bar中創(chuàng)建的日志記錄器(Logger)將繼承root 日志記錄器(Logger)的級別,root日志記錄器(Logger)經(jīng)常被實例化而可用,它的級別為DEBUG

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

          Logger logger = Logger.getRootLogger();

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

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

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

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

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

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

          可以使用7個級別中的任何一個; 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 擴展FileAppender,因此多個日志文件可以以一個用戶選定的頻率進行循環(huán)日志記錄。

          3. FileAppender 把日志事件寫入一個文件

          4. RollingFileAppender 擴展FileAppender備份容量達到一定大小的日志文件。

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

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

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

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

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

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

          還可以實現(xiàn) Appender 接口,創(chuàng)建以自己的方式進行日志輸出的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) 
          實例化一個FileAppender并且打開變量"filename"指定的文件。

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

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

          這個構(gòu)造函數(shù)還可以選擇是否對指定的文件進行追加的方式輸出。如果沒有指定值,那么默認(rè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.

          這里是一個非常簡單的例子,程序?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.

          這里是一個非常簡單的例子,程序?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)合使用,這樣很多可選項不必硬編碼在軟件中。使用外部配置文件的優(yōu)點就是修改可選項不需要重新編譯程序。唯一的缺點就是,由于用到io 指令,速度稍微有些減慢。

          有兩個方法可以用來指定外部配置文件:文本文件或者XML文件。既然現(xiàn)在所有事情都寫成XML文件,那么該教程就重點講解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聲明中被指定為根元素。嵌入在根元素中有兩個結(jié)構(gòu):

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

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

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

          root元素必須存在且不能被子類化。示例中的優(yōu)先級被設(shè)置為"debug",設(shè)置appender飽含一個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");
          }
          }

          這里是一個實現(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)境的例子,請查看log4j發(fā)行版的目錄src/java/org/apache/log4j/xml/examples/ 。

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

          # initialise root logger with level DEBUG and call it BLAH
          log4j.rootLogger=DEBUG, BLAH
          # add a ConsoleAppender to the logger BLAH
          log4j.appender.BLAH=org.apache.log4j.ConsoleAppender
          # set set that layout to be SimpleLayout
          log4j.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)境的例子,請查看log4j發(fā)行版中的目錄examples。

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

          posted on 2005-08-18 16:58 Pudgy's World 閱讀(1690) 評論(1)  編輯  收藏 所屬分類: Log4j

          FeedBack:
          # re: log4j Tutorials
          2005-11-15 14:08 | pursuer
          excellent  回復(fù)  更多評論
            

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


          網(wǎng)站導(dǎo)航:
           

          <2005年11月>
          303112345
          6789101112
          13141516171819
          20212223242526
          27282930123
          45678910

          常用鏈接

          留言簿(1)

          隨筆分類(13)

          隨筆檔案(13)

          文章分類(4)

          文章檔案(5)

          相冊

          Developer

          Favorite blogs

          搜索

          •  

          積分與排名

          • 積分 - 22548
          • 排名 - 1626

          最新評論

          閱讀排行榜

          評論排行榜

          主站蜘蛛池模板: 邢台市| 故城县| 吴桥县| 山丹县| 嘉峪关市| 富宁县| 西华县| 喀什市| 新津县| 修水县| 潮安县| 探索| 睢宁县| 崇左市| 千阳县| 三台县| 德令哈市| 根河市| 睢宁县| 甘南县| 靖宇县| 高碑店市| 通河县| 旬邑县| 资阳市| 长丰县| 行唐县| 离岛区| 靖西县| 田林县| 大港区| 什邡市| 涿州市| 尤溪县| 广河县| 林口县| 郧西县| 崇信县| 河北省| 凌海市| 青州市|