log4j的多logger記錄日志的簡明使用

日志，應該是一個應用軟件的基礎功能之一。
使用java語言，必然會使用一個日志庫，我使用的是log4j的日志庫。網上不少文章都有介紹，但是結合logger的不同功能介紹以及示例介紹的清楚的不多，至少我也是翻了不少網頁，然后根據實驗才得出這些功能。

我覺得log4j中主要有2個概念：logger、appender。

1. logger是日志組件的主要概念，用于指定不同的包使用不同的日志級別，或者指定一個logger組件，以便在使用的時候可以使用getLogger(組件名)的方式獲取該logger的定義。logger中主要指定一個日志級別，以及數個具體的記錄器appender，這樣程序中就可以選用哪些記錄器進行記錄日志，以及記錄什么級別的日志。
2. appender是具體執行記錄日志到文件或者終端的組件。

• 多logger組件的使用方式
  getLogger(參數)，如果參數可以在配置文件中找到對應的logger，則使用該logger，如果找不到，則使用rootlogger。

代碼使用方式很簡單，在java工程中引入如下庫

package logStudy;
import org.apache.log4j.Logger;
public class useLog4J {
       public static Logger logger1 = Logger.getLogger(useLog4J.class);
       public static Logger logger2 = Logger.getLogger("logStudy");
       public static void main(String[] args) {
              int i =100;
              while(i>0) {
               logger1.debug("這是一條測試log的數據，級別應該是debug");
               logger1.debug("這是一條測試log的數據，級別應該是debug");
               logger1.info("這是一條測試log的數據，級別info");
               logger1.info("這是一條測試log的數據，級別info");
               logger1.info("這是一條測試log的數據，級別info");
               logger1.debug("這是一條測試log的數據，級別應該是debug");
               logger1.warn("這是一條測試log的數據，級別應該是warn");
               i--;
              }

              logger2.debug("logger2 debug");
              logger2.info("logger2 info");
              logger2.warn("logger2 warn");
              logger2.fatal("logger2 fatal");
       }
}

以上代碼中，使用了兩個logger組件，主要是為了演示兩者的區別，logger1是使用的rootlogger的內容，而logger2使用的是名為logStudy的logger，這個logger使用的只是CONSOLE，以下配置會有介紹。
log4j的使用代碼很簡單明了，主要工作是在配置文件中，即log4j.properties中的配置，示例中的配置示例如下。

ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF
### 設置級別和目的地(這里多個目的地) ###
log4j.rootLogger = INFO,CONSOLE,HelloLog,Hello2Log
### 第一個用處，默認這里的logStudy是包，也就是在這個包記錄日志時，是只記錄WARN及以上級別的日志.  
### 第二個用處，可以在程序中任何地方，通過Logger.getLogger("logStudy")主動使用這個名為logStudy的logger。
log4j.logger.logStudy=WARN,CONSOLE
### 配置日志信息輸出目的地Appender，此處第一個appender名為CONSOLE，使用的輸出方式為org.apache.log4j.ConsoleAppender，即輸出到控制臺
log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender
log4j.appender.CONSOLE.Target = System.out
log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout
#輸出格式，具體格式內容可以網上查找
log4j.appender.CONSOLE.layout.ConversionPattern = %c %d{ABSOLUTE} %5p  %c{1}:%L - %m%n
#每天創建一個日志
log4j.appender.HelloLog = org.apache.log4j.DailyRollingFileAppender
log4j.appender.HelloLog.File =.\\log\\debug.log
#log4j.appender.HelloLog.File =/var/log/debug.log
log4j.appender.HelloLog.Append = true
## 只輸出DEBUG級別以上的日志
log4j.appender.HelloLog.Threshold = INFO
#'.'yyyy-MM-dd: 每天產生一個新的文件
log4j.appender.HelloLog.DatePattern = '.'yyyy-MM-dd
log4j.appender.HelloLog.layout = org.apache.log4j.PatternLayout
log4j.appender.HelloLog.layout.ConversionPattern = %-d{yyyy-MM-dd  HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n
log4j.additivity.logStudy = false    #不繼承根rootLogger，這樣就不會把日志輸出到rootLogger中指定的appender中。
#當文本文件為3KB大時新建一個文件
log4j.appender.Hello2Log = org.apache.log4j.RollingFileAppender
log4j.appender.Hello2Log.File =.\\log\\debug2.log
#log4j.appender.Hello2Log.File =/var/log/debug.log
log4j.appender.Hello2Log.Append = true
## 只輸出DEBUG級別以上的日志
log4j.appender.Hello2Log.Threshold = INFO
log4j.appender.Hello2Log.MaxFileSize = 2KB
log4j.appender.Hello2Log.MaxBackupIndex = 5
#'.'yyyy-MM-dd: 每天產生一個新的文件
log4j.appender.Hello2Log.layout = org.apache.log4j.PatternLayout
log4j.appender.Hello2Log.layout.ConversionPattern = %-d{yyyy-MM-dd  HH:mm:ss} [%t:%r] - [%p] [%c{1}:%L] [%M] %m%n

以下內容為每個介紹：
1、log4j.rootLogger
log4j.rootLogger= [ level ] , appenderName, appenderName2,...
level：是log4j的日志級別，優先級從高到低分別是FATAL、ERROR、WARN、INFO、DEBUG、ALL。appenderName：就是指定日志信息輸出到哪個地方。

2、 配置日志信息輸出目的地Appender，其語法為：
log4j.appender.appenderName = fully.qualified.name.of.appender.class

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

3、設置好appender后，針對appender的配置
也就是設置好要輸出到什么地方后，其它配置選項，很多配置選項是相同的，每個appender類型有一些特別的選項
1.ConsoleAppender選項
Threshold=WARN:指定日志消息的輸出最低層次。
ImmediateFlush=true:默認值是true,意謂著所有的消息都會被立即輸出。
Target=System.err：默認情況下是：System.out,指定輸出控制臺
2.FileAppender 選項
File=log.txt:指定消息輸出到log.txt文件。
Append=false:默認值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內容。
3.DailyRollingFileAppender 選項
Append=false:默認值是true,即將消息增加到指定文件中，false指將消息覆蓋指定的文件內容。
DatePattern=’.’yyyy-ww:每周滾動一次文件，即每周產生一個新的文件。當然也可以指定按月、周、天、時和分。
4.RollingFileAppender 選項
MaxFileSize=100KB: 后綴可以是KB, MB 或者是 GB. 在日志文件到達該大小時，將會自動滾動，即將原來的內容移到mylog.log.1文件
MaxBackupIndex=2:指定可以產生的滾動文件的最大數。

4.輸出格式介紹

日志輸出格式，所用到的參數如下，按需添加：
%p: 輸出日志信息優先級，即DEBUG，INFO，WARN，ERROR，FATAL,
%d: 輸出日志時間點的日期或時間，默認格式為ISO8601，也可以在其后指定格式，比如：%d{yyy MMM dd HH:mm:ss,SSS}，輸出類似：2002年10月18日 22：10：28，921
%r: 輸出自應用啟動到輸出該log信息耗費的毫秒數
%c: 輸出日志信息所屬的類目，通常就是所在類的全名
%t: 輸出產生該日志事件的線程名
%l: 輸出日志事件的發生位置，相當于%C.%M(%F:%L)的組合,包括類目名、發生的線程，以及在代碼中的行數。舉例：Testlog4.main(TestLog4.java:10)
%x: 輸出和當前線程相關聯的NDC(嵌套診斷環境),尤其用到像java servlets這樣的多客戶多線程的應用中。
%%: 輸出一個”%”字符
%F: 輸出日志消息產生時所在的文件名稱
%L: 輸出代碼中的行號
%m: 輸出代碼中指定的消息,產生的日志具體信息
%n: 輸出一個回車換行符，Windows平臺為”\r\n”，Unix平臺為”\n”輸出日志信息換行
可以在%與模式字符之間加上修飾符來控制其最小寬度、最大寬度、和文本的對齊方式。如：
1)%20c：指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，默認的情況下右對齊。
2)%-20c:指定輸出category的名稱，最小的寬度是20，如果category的名稱小于20的話，”-”號指定左對齊。
3)%.30c:指定輸出category的名稱，最大的寬度是30，如果category的名稱大于30的話，就會將左邊多出的字符截掉，但小于30的話也不會有空格。
4)%20.30c:如果category的名稱小于20就補空格，并且右對齊，如果其名稱長于30字符，就從左邊交遠銷出的字符截掉。