log4j使用詳細解析

簡單的說log4j就是幫助開發(fā)人員進行日志輸出管理的API類庫。它最重要的特點就可以配置文件靈活的設置日志信息的優(yōu)先級、日志信息的輸出目的地、日志信息的輸出格式

Log4j 除了可以記錄程序運行日志信息外還有一重要的功能就是用來顯示調(diào)試信息。

程序員經(jīng)常會遇到脫離Java ide環(huán)境調(diào)試程序的情況，這時大多數(shù)人會選擇使用System.out.println語句輸出某個變量值的方法進行調(diào)試。這樣會帶來一個非常麻煩的問題：一旦哪天程序員決定不要顯示這些System.out.println的東西了就只能一行行的把這些垃圾語句注釋掉。若哪天又需調(diào)試變量值，則只能再一行行去掉這些注釋恢復System.out.println語句。使用log4j可以很好的處理類似情況。

log4j使用方法

下面介紹的是log4j一些理論方面的知識。

1、定義配置文件

首先使用配置文件將使我們的應用程序更加靈活配置log日志輸出方式包括輸出優(yōu)先級、輸出目的地、輸出格式。

Log4j支持兩種配置文件格式，

1）XML格式的文件，

2）Java特性文件log4j.properties（鍵=值）。

下面將介紹使用log4j.properties文件作為配置文件的方法：

①配置根Logger，其語法為：0　　

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

其中，level 是日志記錄的優(yōu)先級，分為OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定義的級別。

Log4j建議只使用四個級別，優(yōu)先級從高到低分別是 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（每天產(chǎn)生一個日志文件），
　　org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產(chǎn)生一個新的文件）， 
　　org.apache.log4j.WriterAppender（將日志信息以流格式發(fā)送到任意指定的地方）

③配置日志信息的格式（布局），其語法為：

　　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（包含日志產(chǎn)生的時間、線程、類別等等信息）

Log4J采用類似C語言中的printf函數(shù)的打印格式格式化日志信息，打印參數(shù)如下： 

     %m 輸出代碼中指定的消息
　　%p 輸出優(yōu)先級，即DEBUG，INFO，WARN，ERROR，F(xiàn)ATAL 
     %r 輸出自應用啟動到輸出該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、在代碼中使用Log4j

①得到記錄器

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

public static Logger getLogger( String name)

通過指定的名字獲得記錄器，如果必要的話，則為這個名字創(chuàng)建一個新的記錄器。Name一般取本類的名字，比如：　

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

②讀取配置文件

當獲得了日志記錄器之后，第二步將配置Log4j環(huán)境，其語法為：　

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

例：

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

③插入記錄信息（格式化日志信息）

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

 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());就是創(chuàng)建一個屬于LogTest類的Logger對象，創(chuàng)建時要告知Logger你當前的Class是什么。

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

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

下面是配置文件log4j.properties的內(nèi)容：

log4j.rootCategory=DEBUG, stdout，R
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, stdout，R

就是說我要顯示所有優(yōu)先權等於和高于Debug的信息。

"stdout"，”R”表示我定義了兩個輸出端(隨便什么名字都好)

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

③再加上下面六行則log信息不光顯示在屏幕上，而且將被保存在一個叫"log.txt"的文件里，文件最大為100KB。如果文件大小超過100KB，文件會被備份成"log.txt.1"，新的"log.txt"繼續(xù)記錄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, ERROR的log信息，而DEBUG信息不會被顯示；

在web程序中使用log4j注意問題

1、 由于jsp或servlet在執(zhí)行狀態(tài)時沒有當前路徑概念，所有使用PropertyConfigurator.configure（String）語句找log4j.properties文件時要給出相對于當前jsp或servlet的路徑轉(zhuǎn)化成為一個絕對的文件系統(tǒng)路徑。

方法是使用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配置文件的方法進行靈活設置。

在spring框架下，使用log4j更是容易，下面介紹一下spring下的log4j應用。

1）首先要下載相應的jar包（log4j.jar）

2）配置web.xml，在web.xml中加入如下配置

<context-param>
    <param-name>log4jConfigLocation</param-name>
    <param-value>/WEB-INF/config/log4j.properties</param-value>
  </context-param>
  <context-param>
    <param-name>log4jRefreshInterval</param-name>
    <param-value>6000</param-value>
  </context-param>
  <listener>
    <listener-class>
     org.springframework.web.util.Log4jConfigListener
    </listener-class>
  </listener>

說明：在上文的配置里，Log4jConfigListener會去WEB-INF/config/log4j.propeties 讀取配置文件;

開一條watchdog線程每60秒掃描一下配置文件的變化（這樣在web服務啟動后再去修改配置文件也不用重新啟動web服務了）;

并把web目錄的路徑壓入一個叫webapp.root的系統(tǒng)變量（webapp.root將在log4j.properties文件中使用）。

總結(jié)

以上所述是小編給大家介紹的log4j使用詳細解析，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復大家的。在此也非常感謝大家對億速云網(wǎng)站的支持！