第一、Logger.getLogger()和LogFactory.getLog()的區別
1.Logger.getLogger()是使用log4j的方式記錄日志;
2.LogFactory.getLog()則來自apache的common-logging包。
Jakarta Commons Logging (JCL)提供的是一個日志(Log)接口(interface),同時兼顧輕量級和不依賴於具體的日志實現工具。它提供給中間件/日志工具開發者一個簡單的日志操作抽象,允許程序開發人員使用不同的具體日志實現工具。了解包里情況,可以查看它的API文檔:http://www.oschina.net/uploads/doc/commons-logging-1.1.1/index.html , 其中Log(基本記錄器)和LogFactory(負責創建Log實例)是兩個基類。該API直接提供對下列底層日志記錄工具的支持:Jdk14Logger,Log4JLogger,LogKitLogger,NoOpLogger (直接丟棄所有日志信息),還有一個SimpleLog。 有必要詳細說明一下調用LogFactory.getLog()時發生的事情。調用該函數會啟動一個發現過程,即找出必需的底層日志記錄功能的實現,具體的發現過程在下面列出: ( 換句話說就是, 有這么多工具,common-logging該使用哪一個呢?這取決於系統的設置,common-logging將按以下順序決定使用哪個日志記錄工具:) (1).common-logging首先在CLASSPATH中查找commons-logging.properties文件。這個屬性文件至少定義org.apache.commons.logging.Log屬性,它的值應該是上述任意Log接口實現的完整限定名稱。如果找到 org.apache.commons.logging.Log屬相,則使用該屬相對應的日志組件。結束發現過程。 (2).如果上面的步驟失敗(文件不存在或屬相不存在),common-logging接着檢查系統屬性org.apache.commons.logging.Log。如果找到org.apache.commons.logging.Log系統屬性,則使用該系統屬性對應的日志組件。結束發現過程。 (3).如果找不到org.apache.commons.logging.Log系統屬性,common-logging接着在CLASSPATH中尋找log4j的類。如果找到了就假定應用要使用的是log4j。不過這時log4j本身的屬性仍要通過log4j.properties文件正確配置。結束發現過程。 (4).如果上述查找均不能找到適當的Logging API,但應用程序正運行在JRE 1.4或更高版本上,則默認使用JRE 1.4的日志記錄功能。結束發現過程。 (5).最后,如果上述操作都失敗(JRE 版本也低於1.4),則應用將使用內建的SimpleLog。SimpleLog把所有日志信息直接輸出到System.err。結束發現過程。 為了簡化配置 commons-logging ,一般不使用 commons-logging 的配置文件,也不設置與 commons-logging 相關的系統環境變量,而只需將 Log4j 的 Jar 包放置到 classpash 中就可以了。這樣就很簡單地完成了 commons-logging 與 Log4j 的融合。 根據不同的性質,日志信息通常被分成不同的級別,從低到高依次是:“調試( DEBUG )”“信息( INFO )”“警告( WARN )”“錯誤(ERROR )”“致命錯誤( FATAL )”。
舉例說明:
基於common-logging的運行方式:
package org; import org.apache.commons.logging.Log; import org.apache.log4j.Logger; public class Test extends TagSupport{ public static Log log=LogFactory.getLog(Test.class); public static void test() { log.debug("111"); log.info("125"); log.warn("485"); log.error("error"); } public static void main(String[] a) { Test.test(); } }
基於log4j的運行方式
import org.apache.log4j.Logger; import org.apache.log4j.PropertyConfigurator; public class TestLog4j { static Logger logger = Logger.getLogger(TestLog4j.class); public static void main(String args[]) { PropertyConfigurator.configure("log4j.properties"); logger.debug("Here is some DEBUG"); logger.info("Here is some INFO"); logger.warn("Here is some WARN"); logger.error("Here is some ERROR"); logger.fatal("Here is some FATAL"); } }
第二、詳細介紹Log4j
① Log4j的架構
Log4j系統的三大板塊:日志寫入器、日志輸出終端、日志布局模式
Logger類是日志包的核心,Logger的名稱是大小寫敏感的,並且名稱之間有繼承關系。子名由父名做前綴,用點號“.”分隔,如x.y是x.y.z的父親Logger。Logger系統中有個根logger,是所有logger的祖先,它總是存在的,並且不可以通過名字獲取,可以通過Logger.getRootLogger()來獲取。獲取Logger對象的方法很多,可以參考API文檔,在某對象中,用該對象所屬的類作為參數,調用Logger.getLogger(Class clazz)以獲取logger對象被認為是目前所知最理智的命名logger方法。
②Log4j的日志級別(Level)
每個logger都有一個日志級別,用來控制日志的輸出。未分配級別的logger將自動繼承它最近的父logger的日志級別。Logger的由低到高級別如下:
ALL< DEBUG < INFO < WARN < ERROR < FATAL < OFF
③Log4j的輸出終端(Appender接口)
Log4j提供了以下幾個實現:
org.apache.log4j.ConsoleAppender(控制台) org.apache.log4j.FileAppender(文件) org.apache.log4j.DailyRollingFileAppender(每天都產生一個日志文件) org.apache.log4j.RollingFileAppender(文件大小達到指定尺寸時產生一個新的日志文件,文件名稱上會自動添加數字序號。) org.apache.log4j.WriterAppender(將日志信息以流的格式發送到任意指定的地方) org.apache.log4j.ConsoleAppender(控制台) org.apache.log4j.FileAppender(文件) org.apache.log4j.DailyRollingFileAppender(每天都產生一個日志文件) org.apache.log4j.RollingFileAppender(文件大小達到指定尺寸時產生一個新的日志文件,文件名稱上會自動添加數字序號。) org.apache.log4j.WriterAppender(將日志信息以流的格式發送到任意指定的地方)
默認情況下,子logger將繼承父logger的所有appenders。
④Log4j的輸出布局模式(Layout接口)
Log4j提供Layout有以下幾種:
org.apache.log4j.HTMLLayout(以HTML表格形式布局) org.apache.log4j.PatternLayout(可以靈活地指定布局模式) org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串) org.apache.log4j.TTCCLayout(包含日志產生的時間、線程、類別等信息) org.apache.log4j.HTMLLayout(以HTML表格形式布局) org.apache.log4j.PatternLayout(可以靈活地指定布局模式) org.apache.log4j.SimpleLayout(包含日志信息的級別和信息字符串) org.apache.log4j.TTCCLayout(包含日志產生的時間、線程、類別等信息)
Log4j采用類似C語言中的printf函數的打印格式格式化日志信息。打印參數如下:
%m:輸出代碼中指定的消息。 %p:輸出優先級。 %r:輸入自應用啟動到輸出該log信息耗費的毫秒數。 %c:輸出所屬的類目,通常就是所在類的全名。 %n:輸出一個回車換行符。Windows平台為“\r\n”,UNIX為“\n”。 %d:輸出日志時間點的日期或時間,默認格式為ISO8601,推薦使用“%d{ABSOLUTE}”,這個輸出格式形如:“2007-05-07 18:23:23,500”,符合中國人習慣。 %l:輸出日志事件發生的位置,包括類名、線程名,以及所在代碼的行數。 %m:輸出代碼中指定的消息。 %c:輸出所屬的類目,通常就是所在類的全名。 %t:輸出產生該日志線程的線程名。 %n:輸出一個回車換行符。Windows平台為“\r\n”,UNIX為“\n”。 %d:輸出日志時間點的日期或時間,默認格式為ISO8601,推薦使用“%d{ABSOLUTE}”,這個輸出格式形如:“2007-05-07 18:23:23,500”,符合中國人習慣。 %l:輸出日志事件發生的位置,包括類名、線程名,以及所在代碼的行數。 %d 輸出日志時間點的日期或時間,默認格式為ISO8601,也可以在其后指定格式,比如:%d{yyy-MM-dd HH:mm:ss },輸出類似:2002-10-18- 22:10:28 %f 輸出日志信息所屬的類的類名 %l 輸出日志事件的發生位置,即輸出日志信息的語句處於它所在的類的第幾行 %m 輸出代碼中指定的信息,如log(message)中的message %p 輸出優先級,即DEBUG,INFO,WARN,ERROR,FATAL。如果是調用debug()輸出的,則為DEBUG,依此類推 %r 輸出自應用啟動到輸出該日志信息所耗費的毫秒數 %t 輸出產生該日志事件的線程名
⑤Log4j的配置
在實際使用中,Log4j一般是通過配置文件配置使用的。配置文件有兩種,Java properties和XML文件。一般都選用properties文件來配置,因為簡潔易讀。下面只介紹Java properties的配置方式。
對Log4j的配置就是對rootLogger和子Logger的配置。主要的配置項為:rootLogger、輸出終端、輸出布局模式,所有的配置項都必須以log4j開頭。
配置文件的示例
##Log4J的配置之簡單使它遍及於越來越多的應用中了 ##Log4J配置文件實現了輸出到控制台、文件、回滾文件、發送日志郵件、輸出到數據庫日志表、自定義標簽等全套功能。擇其一二使用就夠用了。 ##此文件(log4j.properties)內容來自網絡,非本文作者liigo原創。 log4j.rootLogger = DEBUG, CONSOLE,A1 log4j.addivity.org.apache = true # 應用於控制台 log4j.appender.CONSOLE = org.apache.log4j.ConsoleAppender log4j.appender.Threshold = DEBUG log4j.appender.CONSOLE.Target = System.out log4j.appender.CONSOLE.layout = org.apache.log4j.PatternLayout log4j.appender.CONSOLE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n #log4j.appender.CONSOLE.layout.ConversionPattern = [start] % d {DATE} [DATE] % n % p[PRIORITY] % n % x[NDC] % n % t[THREAD] n % c[CATEGORY] % n % m[MESSAGE] % n % n #應用於文件 log4j.appender.FILE = org.apache.log4j.FileAppender log4j.appender.FILE.File = file.log log4j.appender.FILE.Append = false log4j.appender.FILE.layout = org.apache.log4j.PatternLayout log4j.appender.FILE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n # Use this layout for LogFactor 5 analysis # 應用於文件回滾 log4j.appender.ROLLING_FILE = org.apache.log4j.RollingFileAppender log4j.appender.ROLLING_FILE.Threshold = ERROR log4j.appender.ROLLING_FILE.File = rolling.log log4j.appender.ROLLING_FILE.Append = true log4j.appender.ROLLING_FILE.MaxFileSize = 10KB log4j.appender.ROLLING_FILE.MaxBackupIndex = 1 log4j.appender.ROLLING_FILE.layout = org.apache.log4j.PatternLayout log4j.appender.ROLLING_FILE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n #應用於socket log4j.appender.SOCKET = org.apache.log4j.RollingFileAppender log4j.appender.SOCKET.RemoteHost = localhost log4j.appender.SOCKET.Port = 5001 log4j.appender.SOCKET.LocationInfo = true # Set up for Log Facter 5 log4j.appender.SOCKET.layout = org.apache.log4j.PatternLayout log4j.appender.SOCET.layout.ConversionPattern = [start] % d {DATE} [DATE] % n % p[PRIORITY] % n % x[NDC] % n % t[THREAD] % n % c[CATEGORY] % n % m[MESSAGE] % n % n # Log Factor 5 Appender log4j.appender.LF5_APPENDER = org.apache.log4j.lf5.LF5Appender log4j.appender.LF5_APPENDER.MaxNumberOfRecords = 2000 # 發送日志給郵件 log4j.appender.MAIL = org.apache.log4j.net.SMTPAppender log4j.appender.MAIL.Threshold = FATA log4j.appender.MAIL.BufferSize = 10 log4j.appender.MAIL.From = web@www.wuset.com log4j.appender.MAIL.SMTPHost = www.wusetu.com log4j.appender.MAIL.Subject = Log4J Message log4j.appender.MAIL.To = web@www.wusetu.com log4j.appender.MAIL.layout = org.apache.log4j.PatternLayout log4j.appender.MAIL.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n # 用於數據庫 log4j.appender.DATABASE = org.apache.log4j.jdbc.JDBCAppender log4j.appender.DATABASE.URL = jdbc:mysql: // localhost:3306/test log4j.appender.DATABASE.driver = com.mysql.jdbc.Driver log4j.appender.DATABASE.user = root log4j.appender.DATABASE.password = log4j.appender.DATABASE.sql = INSERT INTO LOG4J (Message) VALUES ( ' [framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n ' ) log4j.appender.DATABASE.layout = org.apache.log4j.PatternLayout log4j.appender.DATABASE.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n log4j.appender.A1 = org.apache.log4j.DailyRollingFileAppender log4j.appender.A1.File = SampleMessages.log4j log4j.appender.A1.DatePattern = yyyyMMdd - HH ' .log4j ' log4j.appender.A1.layout = org.apache.log4j.xml.XMLLayout #自定義Appender log4j.appender.im = net.cybercorlin.util.logger.appender.IMAppender log4j.appender.im.host = mail.cybercorlin.net log4j.appender.im.username = username log4j.appender.im.password = password log4j.appender.im.recipient = corlin@cybercorlin.net log4j.appender.im.layout = org.apache.log4j.PatternLayout log4j.appender.im.layout.ConversionPattern = [framework] % d - % c -%- 4r [ % t] %- 5p % c % x - % m % n # 結束