log4j與Spring集成


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平台為“ ”,Unix平台為“ ”
  %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的使用方法。程序代碼如下:

 1 import org.apache.log4j.*;
2
3 public class LogTest ...{
4
5
6 static Logger logger = Logger.getLogger(LogTest.class.getName());
7
8 public static void main(String[] args) ...{
9
10 PropertyConfigurator.configure ( “.\srclog4j.properties”);
11 logger.debug("Debug ...");
12
13 logger.info("Info ...");
14
15 logger.warn("Warn ...");
16
17 logger.error("Error ...");
18
19 }
20 }

程序說明:
① 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的內容:

程序說明:
1. log4j.rootCategory=DEBUG, stdout,R
就是說我要顯示所有優先權等於和高於Debug的信息。
"stdout",”R”表示我定義了兩個輸出端(隨便什么名字都好)。
2 .下面的三行說stdout輸出端其實是標准輸出Console,也就是屏幕。輸出的格式是PatternLayout。轉換方式是%5p (%F:%L) - %m%n,即前五格用來顯示優先權,再顯示當前的文件名,加當前的行數。最后是logger.debug()或logger.info()或logger.warn()或logger.error()里的信息。%n表示回車空行。
3 . 再加上下面六行則log信息不光顯示在屏幕上,而且將被保存在一個叫"log.txt"的文件里,文件最大為100KB。如果文件大小超過100KB,文件會被備份成"log.txt.1",新的"log.txt"繼續記錄log信息。
接下來我們可以改變log4j.properties,而不需重新編譯就可以控制log信息是否顯示、log信息的輸出端類型、輸出方式、輸出格式,
等等。舉例如下:
1. 在log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=OFF, stdout,R",這樣所有的log信息都不會顯示了;解決了本文開始提出的問題。

2 . 在log4j.properties文件里把"log4j.rootCategory=DEBUG,stdout,R"改寫成"log4j.rootCategory=INFO, stdout,R",這樣只顯示INFO, WARN, ERROR的log信息,而DEBUG信息不會被顯示;

在web程序中使用log4j注意問題
1、 由於jsp或servlet在執行狀態時沒有當前路徑概念,所有使用PropertyConfigurator.configure (String)語句找log4j.properties文件時要給出相對於當前jsp或servlet的路徑轉化成為一個絕對的文件系統路徑。方法是使用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;所有的這一切只需要你點點鼠標或者按一次快捷鍵,

在Spring的項目中配置Log4j

1.在classpath的根目錄下面不放置log4j.properties
在用junit本地測試的時候會提示:

log4j:WARN No appenders could be found for logger (org.springframework.beans.factory.access.SingletonBeanFactoryLocator).
log4j:WARN Please initialize the log4j system properly.

然后我們是看不到spring加載bean的配置信息的。
在classpath路徑下加入:log4j.properties,則能夠顯示bean的加載信息

2. 在web應用中為Spring配置log4j
Spring的做法是使用一個Servlet Listener,在Web Container啟動時把ROOT的絕對路徑寫到系統變量里,這樣log4j的配置文件里就可以用${myAppfuse.root}來表示剛剛設進去的系統變量:log4j.appender.logfile.File=${myAppfuse.root}/logs/mylog.log
在Web.xml中配置語句如下:

 1  <!--如果不設,默認為web.root,但最好設置,以免項目間沖突 -->
2 <context-param>
3 <param-name>webAppRootKey</param-name>
4 <param-value>myappfuse.root</param-value>
5 </context-param>
6 <context-param>
7 <param-name>log4jConfigLocation</param-name>
8 <param-value>/WEB-INF/classes/log4j.properties</param-value>
9 </context-param>
10 <listener>
11 <listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
12 </listener>
13 <!--這里配置了一個listener,也可以配置servlet -->
14 <servlet>
15 <servlet-name>log4j</servlet-name>
16 <servlet-class>
17 org.springframework.web.util.Log4jConfigServlet
18 </servlet-class>
19 <load-on-startup>1</load-on-startup>
20 </servlet>

配置好了以后我們就可以在當前應用的logs目錄下找到日志記錄文件:mylog.log
屬性log4jConfigLocation的值建議還是設置為:/WEB-INF/classes/log4j.properties,這樣我們在不啟動web應用的時候,做一些測試這能夠正確地記錄日志信息。



免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM