Ready Test? Go, Go, Go !!!
           

          關注測試,也關注成長

          公告
          • 關注軟件測試自動化,性能測試。
            目前負責醫療軟件功能測試以及
            測試過程改進

          日歷
          <2005年6月>
          2930311234
          567891011
          12131415161718
          19202122232425
          262728293012
          3456789
          統計
          • 隨筆 - 22
          • 文章 - 0
          • 評論 - 87
          • 引用 - 0

          導航

          常用鏈接

          留言簿(17)

          隨筆分類

          隨筆檔案

          搜索

          •  

          最新評論

          閱讀排行榜

          評論排行榜

           

           原文作者:天才    Kylin項目小組

          log4j簡介

          簡單的說log4j就是幫助開發人員進行日志輸出管理的API類庫。它最重要的特點就

          可以配置文件靈活的設置日志信息的優先級、日志信息的輸出目的地以及日志信息的輸出格式。

          Log4j除了可以記錄程序運行日志信息外還有一重要的功能就是用來顯示調試信息。程序員經常會遇到脫離java ide環境調試程序的情況,這時大多數人會選擇使用System.out.println語句輸出某個變量值的方法進行調試。這樣會帶來一個非常麻煩的問題:一旦哪天程序員決定不要顯示這些System.out.println的東西了就只能一行行的把這些垃圾語句注釋掉。若哪天又需調試變量值,則只能再一行行去掉這些注釋恢復System.out.println語句。使用log4j可以很好的處理類似情況。

          log4j使用方法

          下面介紹的是log4j一些理論方面的知識,讀者覺得枯燥的話可以跳過本節直接閱讀第三節實例部分。

            1、定義配置文件

             首先使用配置文件將使我們的應用程序更加靈活配置log日志輸出方式包括輸出優先級、輸出目的地、輸出格式。Log4j支持兩種配置文件格式,一種是XML格式的文件,一種是Java特性文件log4j.properties(鍵=值)。下面將介紹使用log4j.properties文件作為配置文件的方法:

            配置根Logger,其語法為:0

            log4j.rootLogger = [ level ] , appenderName, appenderName, …

            其中,level 是日志記錄的優先級,分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級別。Log4j建議只使用四個級別,優先級從高到低分別是ERROR、WARN、INFO、DEBUG。通過在這里定義的級別,您可以控制到應用程序中相應級別的日志信息的開關。比如在這里定義了INFO級別,則應用程序中所有DEBUG級別的日志信息將不被打印出來。 appenderName就是指定日志信息輸出到哪個地方。可同時指定多個輸出目的地。

            配置日志信息輸出目的地Appender,其語法為:

            log4j.appender.appenderName = fully.qualified.name.of.appender.class
            log4j.appender.appenderName.option1 = value1
            …
            log4j.appender.appenderName.option = valueN

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

            配置日志信息的格式(布局),其語法為:

            log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
            log4j.appender.appenderName.layout.option1 = value1
            …
            log4j.appender.appenderName.layout.option = valueN

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

            Log4J采用類似C語言中的printf函數的打印格式格式化日志信息,打印參數如下: %m 輸出代碼中指定的消息

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

            2、在代碼中使用Log4j

            得到記錄器

            使用Log4j,第一步就是獲取日志記錄器,這個記錄器將負責控制日志信息。其語法為:

            public static Logger getLogger( String name)

            通過指定的名字獲得記錄器,如果必要的話,則為這個名字創建一個新的記錄器。Name一般取本類的名字,比如:

            static Logger logger = Logger.getLogger ( ServerWithLog4j.class.getName () )

            讀取配置文件

            當獲得了日志記錄器之后,第二步將配置Log4j環境,其語法為:

          BasicConfigurator.configure (): 自動快速地使用缺省Log4j環境。
            PropertyConfigurator.configure ( String configFilename) :讀取使用Java的特性文件編寫的配置文件。

          例:PropertyConfigurator.configure(".\\src\\log4j.properties")
            DOMConfigurator.configure ( String filename ) :讀取XML形式的配置文件。

            插入記錄信息(格式化日志信息)

            當上兩個必要步驟執行完畢,就可輕松地使用不同優先級別的日志記錄語句插入到您想記錄日志的任何地方,其語法如下:

            Logger.debug ( Object message ) ;
            Logger.info ( Object message ) ;
            Logger.warn ( Object message ) ;
            Logger.error ( Object message ) ;

          log4j范例程序

          下面將使用一個最簡單的范例程序來進一步說明log4j的使用方法。程序代碼如下:

           

          import org.apache.log4j.*;

           

          public class LogTest {

           

           

              static Logger logger = Logger.getLogger(LogTest.class.getName());

           

              public static void main(String[] args) {

           

                  PropertyConfigurator.configure ( “.\\src\log4j.properties”)

          logger.debug("Debug ...");

           

                  logger.info("Info ...");

           

                  logger.warn("Warn ...");

           

                  logger.error("Error ...");

           

              }

          }

          程序說明:

          static Logger logger = Logger.getLogger(LogTest.class.getName());就是創建一個屬于LogTest類的Logger對象,創建時要告知Logger你當前的Class是什么。

          PropertyConfigurator.configure ( “log4j.properties”)就是說使用當前工程目錄下的src文件夾中的log4j.properties文件作為配置文件。若將log4j.properties放在工程根目錄下也可不寫此句,程序會自動找到配置文件。

          logger.debug就是輸出debug的信息,logger.info就是輸出提示信息,logger.warn就是顯示警告信息,logger.error就是顯示錯誤信息。

           

          下面是配置文件log4j.properties的內容:

          log4j.rootCategory=DEBUG, stdoutR

          log4j.appender.stdout=org.apache.log4j.ConsoleAppender

          log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

          log4j.appender.stdout.layout.ConversionPattern=%5p (%F:%L) - %m%n

          log4j.appender.R=org.apache.log4j.RollingFileAppender

          log4j.appender.R.File=log.txt

          log4j.appender.R.MaxFileSize=100KB

          log4j.appender.R.MaxBackupIndex=1

          log4j.appender.R.layout=org.apache.log4j.PatternLayout

          log4j.appender.R.layout.ConversionPattern=%d{yyyy MMM dd HH:mm:ss} %-5p %c - %m%n

          程序說明:

          log4j.rootCategory=DEBUG, stdoutR

          就是說我要顯示所有優先權等於和高于Debug的信息。
          "stdout",
          ”R”表示我定義了兩個輸出端(隨便什么名字都好)

          下面的三行說stdout輸出端其實是標準輸出Console,也就是屏幕。輸出的格式是PatternLayout。轉換方式是%5p (%F:%L) - %m%n,即前五格用來顯示優先權,再顯示當前的文件名,加當前的行數。最后是logger.debug()logger.info()logger.warn()logger.error()里的信息。%n表示回車空行。

          再加上下面六行則log信息不光顯示在屏幕上,而且將被保存在一個叫"log.txt"的文件里,文件最大為100KB。如果文件大小超過100KB,文件會被備份成"log.txt.1",新的"log.txt"繼續記錄log信息。

          接下來我們可以改變log4j.properties,而不需重新編譯就可以控制log信息是否顯示、log信息的輸出端類型、輸出方式、輸出格式,等等。舉例如下:

          log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=OFF, stdout,R",這樣所有的log信息都不會顯示了;解決了本文開始提出的問題。
          log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=INFO, stdout,R",這樣只顯示INFO, WARN, ERRORlog信息,而DEBUG信息不會被顯示;

           

          web程序中使用log4j注意問題

          1、    由于jsp或servlet在執行狀態時沒有當前路徑概念,所有使用PropertyConfigurator.configureString)語句找log4j.properties文件時要給出相對于當前jspservlet的路徑轉化成為一個絕對的文件系統路徑。方法是使用servletcontext.getrealpath(string)語句。例:

          //得到當前jsp路徑

          String prefix =  getServletContext().getRealPath("/");

          //讀取log4j.properties

          PropertyConfigurator.configure(prefix+"\\WEB-INF\\log4j.properties");

          2、相應的log4j.properties設置某個屬性時也要在程序中設置絕對路徑。例:

          log4j.appender.R.File屬性設置日志文件存放位置。我們可以用讀寫.properties配置文件的方法進行靈活設置。


          log4e使用說明

          在了解了log4j的功能后,我們肯定會我們的程序中編寫一些Log4j日志記錄。對于使用Eclipse的程序員Log4e將是我們最得力的log4j日志編寫助手,現在開始Log4e之旅。

          Log4e是一個免費的Eclipse Plugin,它可幫助你在你的Java工程中快速加入Log 我們可以在http://log4e.jayefem.de/index.php/Download網站上下載Log4e最新版本。下載后將相應文件夾拷貝到Eclipse的插件目錄下,重新Eclipse,在首選項中會多出一個Log4e選項。

          Log4e可以有多個插入Log為一個方法、類,當然也可以在當前位置插入Log,同時其也可以把Sysout.out.println()的轉換為log;所有的這一切只需要你點點鼠標或者按一次快捷鍵,下面我們只以為一個方法插入Log為例來講解

          1.JPG

          Java編輯上下文中點擊右鍵,選擇Log4E,你將看到如下界面:

          2.JPG點擊Insert Log Statement For This Method,你將看到驗證頁面:

          3.JPG
          Finish
          后這時你將看到插入Log后的函數如下:
          4.JPG
          Log4e
          更多的實例參照http://log4e.jayefem.de

           

           -==========
          郁悶,格式總是調不好,不能在這里浪費時間了
          有點失望~

          posted on 2005-06-13 11:34 Cinderella 閱讀(14720) 評論(20)  編輯  收藏 所屬分類: 程序設計
          評論:
          • # re: log4j/log4e的使用  hedong Posted @ 2005-06-17 16:15
            如果在每次調用logger.debug或info之前,檢測一下這個功能是否enabled,可能是個好習慣。因為log的信息的生成,還是有一定的性能消耗的。遺憾的是,log4j舉得例子里,也少有提到這一點。

            女生就是女生,好端端的一個blog界面,改得花里胡哨的,讓人眼暈啊。  回復  更多評論   

          • # re: log4j/log4e的使用  Cinderella Posted @ 2005-06-17 17:22
            |||_!我正準備加音樂呢,讓您這一說~唉~無論如何,謝謝您的回復^_^至于花里胡哨的問題,過兩天再改吧~畢竟是愛美的女生,先讓我歡喜兩天再修改成符合大眾口味吧^_^  回復  更多評論   

          • # re: log4j/log4e的使用  wwx Posted @ 2005-06-20 10:30
            強烈要求公開小荷mm的qq
            偶的29204760 ^_^
            至少得加我一下吧  回復  更多評論   

          • # 一個喜歡你的文章的人  f_qiangqiang Posted @ 2005-07-11 16:36
            我的泡泡 f_qiangqiang,加我吧,求你了!  回復  更多評論   

          • # re: log4j/log4e的使用  blood Posted @ 2005-07-12 14:06
            感謝小荷MM,你的文章讓我log4j入門了  回復  更多評論   

          • # re: log4j/log4e的使用  丑男 Posted @ 2005-07-25 00:15
            你的版本是多少?我安裝沒有成功
            eclipse 3.02 + de.jayefem.log4e_free_1.0.3.zip
              回復  更多評論   

          • # re: log4j/log4e的使用  Cinderella Posted @ 2005-07-25 18:54
            eclipse 3.01 + de.jayefem.log4e_0.7.7  回復  更多評論   

          • # re: log4j/log4e的使用  Pearson Posted @ 2005-07-25 21:58
            已經很不錯了,謝謝整理~  回復  更多評論   

          • # re: log4j/log4e的使用  yw Posted @ 2005-08-03 14:50
            我作為新手有豁然開朗的感覺,非常感謝,  回復  更多評論   

          • # re: log4j/log4e的使用  samplerain Posted @ 2005-08-19 17:02
            日志文件的路徑怎么配?請問!  回復  更多評論   

          • # re: log4j/log4e的使用  ddm Posted @ 2006-01-12 00:47
            如果在每次調用logger.debug或info之前,檢測一下這個功能是否enabled,可能是個好習慣。
            --log4j的logger類代碼已經實現了,不需要自己檢測  回復  更多評論   

          • # re: log4j/log4e的使用  andpass Posted @ 2006-01-12 15:08
            最恐怖的東西不在于是否isDebugenabled,而在于Log信息拼接消耗的時序,JDK1.5推薦用StringBuilder,可以在eclise中型以一個代碼模板,

            if (logger.isDebugEnabled())
              logger.error(new StringBuilder("@--->").append(${cursor}).toString(), e);

            從而借助hotkey而不是右鍵菜單(快一點,再快一點,……),我最喜歡Log4E的就是Ctrl+Alt+D了,至于log格式還是自己定義模版會比較舒服吧~
            不過這里發帖子想泡妞的人還真是很多……  回復  更多評論   

          • # re: log4j/log4e的使用  Joule Posted @ 2006-07-01 13:00
            log4j.appender.R.File=log.txt
            log.txt的路徑是?
            相對與什么的,
              回復  更多評論   

          • # re: log4j/log4e的使用  LOG4E Posted @ 2006-07-04 09:12
            LOG.TXT應該是放在根目錄下面  回復  更多評論   

          • # re: log4j/log4e的使用  若凡 Posted @ 2006-08-09 15:59
            我在項目中使用了log4j,幾乎是每個類的方法的入口和出口都使用了,這樣好象對性能有很大的影響啊(即使關閉了日志的開關),不知道有沒有更好的辦法?  回復  更多評論   

          • # re: log4j/log4e的使用  yaoyao Posted @ 2006-09-06 11:35
            謝了MM.受益匪淺.  回復  更多評論   

          • # re: log4j/log4e的使用  freezingxu Posted @ 2007-03-04 21:49
            google到這里來的
            謝謝樓主,不介意的話我把這篇引用到自己那里去了  回復  更多評論   

          • # re: log4j/log4e的使用  王巍 Posted @ 2007-07-22 21:33
            崇拜啊,以前光用,先在終于有點懂了,頂啊  回復  更多評論   

          • # re: log4j/log4e的使用[未登錄]  paul Posted @ 2007-11-23 17:44
            # re: log4j/log4e的使用 hedong Posted @ 2005-06-17 16:15
            如果在每次調用logger.debug或info之前,檢測一下這個功能是否enabled,可能是個好習慣。因為log的信息的生成,還是有一定的性能消耗的。遺憾的是,log4j舉得例子里,也少有提到這一點。


            同意這個說法,在輸出前先判斷enabled,這樣效率會有提高  回復  更多評論   

          • # re: log4j/log4e的使用  游客 Posted @ 2008-06-03 12:48
            還是有點模糊  回復  更多評論   

           
          Copyright © Cinderella Powered by: 博客園 模板提供:滬江博客
          主站蜘蛛池模板: 天镇县| 宝鸡市| 凉城县| 黄陵县| 松滋市| 天全县| 黎平县| 苗栗县| 佛学| 察哈| 乌苏市| 丹棱县| 宜黄县| 菏泽市| 铁岭市| 开远市| 绥宁县| 辽阳市| 手游| 瑞昌市| 灵寿县| 合川市| 凉山| 平顶山市| 兴化市| 白水县| 平谷区| 翼城县| 黄浦区| 晋宁县| 禄丰县| 临汾市| 屯留县| 澳门| 西华县| 山东省| 新乡县| 汶川县| 青岛市| 永安市| 松原市|