隨筆-8  評論-2  文章-24  trackbacks-0

          Log4J的配置文件(Configuration File)就是用來設(shè)置記錄器的級別、存放器和布局的,它可接key=value格式的設(shè)置或xml格式的設(shè)置信息。通過配置,可以創(chuàng)建出Log4J的運行環(huán)境。

          1. 配置文件
          Log4J配置文件的基本格式如下:

          ???#配置根Logger
          ??????log4j.rootLogger?
          = ? [ level ] ? , ?appenderName1 , ?appenderName2 ,
          ?…
          ???
          ???#配置日志信息輸出目的地Appender
          ??????log4j.appender.appenderName?
          =
          ?fully.qualified.name.of.appender.class?
          ??????log4j.appender.appenderName.option1?
          =
          ?value1?
            …?
          ??????log4j.appender.appenderName.optionN?
          =
          ?valueN?

          ???#配置日志信息的格式(布局)
          ??????log4j.appender.appenderName.layout?
          =
          ?fully.qualified.name.of.layout.class????
          ??????log4j.appender.appenderName.layout.option1?
          =
          ?value1?
            …?
          ??????log4j.appender.appenderName.layout.optionN?
          = ?valueN?

          其中 [level] 是日志輸出級別,共有5級:
          ???FATAL????? 0? ?
          ???ERROR?????
          3?
          ?
          ???WARN??????
          4?
          ?
          ???INFO??????
          6?
          ?
          ???DEBUG?????
          7


          Appender
          為日志輸出目的地,Log4j提供的appender有以下幾種:
          org.apache.log4j.ConsoleAppender(控制臺),
          org.apache.log4j.FileAppender(文件),
          org.apache.log4j.DailyRollingFileAppender(每天產(chǎn)生一個日志文件),
          org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產(chǎn)生一個新的文件),
          org.apache.log4j.WriterAppender(將日志信息以流格式發(fā)送到任意指定的地方)

          Layout:日志輸出格式,Log4j提供的layout有以下幾種:
          org.apache.log4j.HTMLLayout(以HTML表格形式布局),
          org.apache.log4j.PatternLayout(可以靈活地指定布局模式),
          org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串),
          org.apache.log4j.TTCCLayout(包含日志產(chǎn)生的時間、線程、類別等等信息)

          打印參數(shù): Log4J采用類似C語言中的printf函數(shù)的打印格式格式化日志信息,如下:
             %m?? 輸出代碼中指定的消息
            %p?? 輸出優(yōu)先級,即DEBUG,INFO,WARN,ERROR,F(xiàn)ATAL?
            %r?? 輸出自應(yīng)用啟動到輸出該log信息耗費的毫秒數(shù)?
            %c?? 輸出所屬的類目,通常就是所在類的全名?
            %t?? 輸出產(chǎn)生該日志事件的線程名?
            %n?? 輸出一個回車換行符,Windows平臺為“\r\n”,Unix平臺為“\n”?
            %d?? 輸出日志時間點的日期或時間,默認格式為ISO8601,也可以在其后指定格式,比如:%d{yyy?MMM?dd?HH:mm:ss
          , SSS},輸出類似:2002年10月18日? 22 10 28 921
          ?
            %l?? 輸出日志事件的發(fā)生位置,包括類目名、發(fā)生的線程,以及在代碼中的行數(shù)。舉例:Testlog4.main(TestLog4.java:
          10 )?

          2. 在代碼中初始化Logger:
          1)在程序中調(diào)用BasicConfigurator.configure()方法:給根記錄器增加一個ConsoleAppender,輸出格式通過PatternLayout設(shè)為"%-4r [%t] %-5p %c %x - %m%n",還有根記錄器的默認級別是Level.DEBUG.
          2)配置放在文件里,通過命令行參數(shù)傳遞文件名字,通過PropertyConfigurator.configure(args[x])解析并配置;
          3)配置放在文件里,通過環(huán)境變量傳遞文件名等信息,利用log4j默認的初始化過程解析并配置;
          4)配置放在文件里,通過應(yīng)用服務(wù)器配置傳遞文件名等信息,利用一個特殊的servlet來完成配置。

          3. 為不同的 Appender 設(shè)置日志輸出級別:
          ???當調(diào)試系統(tǒng)時,我們往往注意的只是異常級別的日志輸出,但是通常所有級別的輸出都是放在一個文件里的,如果日志輸出的級別是BUG!?那就慢慢去找吧。
          ???這時我們也許會想要是能把異常信息單獨輸出到一個文件里該多好啊。當然可以,Log4j已經(jīng)提供了這樣的功能,我們只需要在配置中修改AppenderThreshold
          就能實現(xiàn),比如下面的例子:

          [配置文件]
          ###?set?log?levels?###
          log4j.rootLogger
          = debug , ?stdout , ?D ,
          ?E

          ###?輸出到控制臺?###
          log4j.appender.stdout
          =
          org.apache.log4j.ConsoleAppender
          log4j.appender.stdout.Target
          =
          System.out
          log4j.appender.stdout.layout
          =
          org.apache.log4j.PatternLayout
          log4j.appender.stdout.layout.ConversionPattern
          = ?%d{ABSOLUTE}?%5p?%c{ 1
          }:%L?-?%m%n

          ###?輸出到日志文件?###
          log4j.appender.D
          =
          org.apache.log4j.DailyRollingFileAppender
          log4j.appender.D.File
          = d:/
          logs/log.log? ##debug 級別以上存入
          log4j.appender.D.Append
          =
          true
          log4j.appender.D.Threshold
          =
          DEBUG?##?輸出DEBUG級別以上的日志
          log4j.appender.D.layout
          =
          org.apache.log4j.PatternLayout
          log4j.appender.D.layout.ConversionPattern
          = %d{yyyy-MM-dd?HH:mm:ss}? [ %t:%r ] - [ %p ]
          ?%m%n

          ###?保存異常信息到單獨文件?###
          log4j.appender.D
          =
          org.apache.log4j.DailyRollingFileAppender
          log4j.appender.D.File
          = e:/
          logs/error.log?##?異常日志文件名? error級別以上cun
          log4j.appender.D.Append
          =
          true
          log4j.appender.D.Threshold
          =
          ERROR ?##?只輸出ERROR級別以上的日志!!!
          log4j.appender.D.layout
          = org.apache.log4j.PatternLayout
          log4j.appender.D.layout.ConversionPattern
          = %d{yyyy-MM-dd?HH:mm:ss}? [ %t:%r ] - [ %p ] ?%m%n

          [代碼中使用]
          public ? class ?TestLog4j? {
          ????
          public ? static ? void ?main(String[]?args)?
          {
          ????????PropertyConfigurator.configure(
          " D:/Code/conf/log4j.properties "
          );
          ????????Logger?logger?
          = ?Logger.getLogger(TestLog4j. class
          );
          ????????logger.debug(
          " debug "
          );
          ????????logger.error(
          " error "
          );
          ????}

          }
          posted on 2006-10-26 17:02 MyBox 閱讀(142) 評論(0)  編輯  收藏

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


          網(wǎng)站導(dǎo)航:
           
          主站蜘蛛池模板: 大新县| 安新县| 监利县| 白山市| 大城县| 苗栗市| 高安市| 威远县| 天水市| 沂水县| 衡阳市| 潞西市| 双柏县| 日土县| 道孚县| 拉孜县| 白朗县| 旬邑县| 剑阁县| 长垣县| 莒南县| 高碑店市| 天等县| 克东县| 曲阳县| 涪陵区| 上林县| 宝坻区| 兴义市| 青田县| 乡城县| 汽车| 衡山县| 南皮县| 安吉县| 大新县| 叶城县| 如皋市| 含山县| 电白县| 尖扎县|