Log4j配置及詳解

1、下載log4j.jar

http://archive.apache.org/dist/logging/log4j/

2、將jar包導入到java項目中

3、在src文件下建立Log4j.properties配置文件

    Log4j.properties配置內容以下：

log4j.rootLogger=DEBUG,CONSOLE,FILE

##for console
log4j.appender.CONSOLE=org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.layout=org.apache.log4j.PatternLayout
log4j.appender.CONSOLE.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss}[%c-%L][%t][%r] - %m%n  

##for file
log4j.appender.FILE=org.apache.log4j.RollingFileAppender
log4j.appender.FILE.File=E:/logTest/log4j.log
log4j.appender.FILE.MaxFileSize=1MB
log4j.appender.FILE.Append=true
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d{yyyy-MM-dd HH\:mm\:ss}[%t] %-5p %c(line-%L) %r %x - %m%n

4、配置講解

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

   （1）配置根Logger
           log4j.rootLogger  =   [ level ]   ,  appenderName1 ,  appenderName2 ,  ...

   其中[level]是日誌輸出級別，總共有5個級別：

FATAL      0  
ERROR      3  
WARN       4  
INFO       6  
DEBUG      7

• logger的level越低，表示該logger越詳細

• logging request的level越高，表示該logging request越優先輸出

 

（2）Appender爲日誌輸出的目的地，Log4j提供瞭如下幾種appender：

org.apache.log4j.ConsoleAppender（控制檯），
org.apache.log4j.FileAppender（文件），
org.apache.log4j.DailyRollingFileAppender（天天產生一個日誌文件），
org.apache.log4j.RollingFileAppender（文件大小到達指定尺寸的時候產生一個新的文件），
org.apache.log4j.WriterAppender（將日誌信息以流格式發送到任意指定的地方）

  （3）Layout：日誌輸出格式，Log4j提供的layout有如下幾種：

org.apache.log4j.HTMLLayout（以HTML表格形式佈局），
org.apache.log4j.PatternLayout（能夠靈活地指定佈局模式），
org.apache.log4j.SimpleLayout（包含日誌信息的級別和信息字符串），
org.apache.log4j.TTCCLayout（包含日誌產生的時間、線程、類別等等信息）

  （4）打印參數: Log4J採用相似C語言中的printf函數的打印格式格式化日誌信息，以下:

%m   輸出代碼中指定的消息
%p   輸出優先級，即DEBUG，INFO，WARN，ERROR，FATAL 
%r   輸出自應用啓動到輸出該log信息耗費的毫秒數 
%c   輸出所屬的類目，一般就是所在類的全名 
%t   輸出產生該日誌事件的線程名 
%n   輸出一個回車換行符，Windows平臺爲「\r\n」，Unix平臺爲「\n」 
%d   輸出日誌時間點的日期或時間，默認格式爲ISO8601，也能夠在其後指定格式，好比：%d{yyyy-MM-dd HH\:mm\:ss}
%l   輸出日誌事件的發生位置，包括類目名、發生的線程，以及在代碼中的行數。

5、根據配置文件初始化log4j

log4j可使用3中配置器來初始化：BasicConfigurator,DOMConfigurator,PropertyConfigurator

其語法分別爲：

• BasicConfigurator.configure ()： 自動快速地使用缺省Log4j環境。

• PropertyConfigurator.configure ( String configFilename) ：讀取使用Java的特性文件編寫的配置文件。

• DOMConfigurator.configure ( String filename ) ：讀取XML形式的配置文件。

使用PropertyConfigurator適用於全部的系統。以下的語句：   

PropertyConfigurator.configure("log4j.properties");//就以log4j.properties爲配置文件初始化好了log4j環境。

對於通常的java project 能夠不使用上面的語句初始化log4j，log4j會自動在classpath下，找到配置文件並初始化。若是log4j不能自動初始化配置文件，那麼就須要用上面的方法進行初始化。   

注意：初始化配置文件，最好只在系統啓動的時候執行一次，若是執行屢次，一是浪費資源，二就是對於老版本的log4j，使用DailyRollingFileAppender時，可能會出現問題。

6、Log4j使用示例

import org.apache.log4j.BasicConfigurator;
import org.apache.log4j.Logger;

public class ApacheLoggerTest {
    static Logger logger = Logger.getLogger(ApacheLoggerTest.class);//在須要使用log4j的地方獲取Logger實例

    public static void main(String[] args) {
        //BasicConfigurator.configure();//初始化log4j環境
        logger.error("error_level");
        logger.debug("debug_level");
        logger.info("info_level");
    }
}

  控制檯打印信息：

2015-07-23 17:24:18[logger.ApacheLoggerTest-11][main][0] - error_level
2015-07-23 17:24:18[logger.ApacheLoggerTest-12][main][0] - debug_level
2015-07-23 17:24:18[logger.ApacheLoggerTest-13][main][0] - info_level

  在 E:\logTest 目錄下會生成一個log4j文件，文件內容：