級別 | 描述 |
---|---|
OFF | 最高級別,用於關閉日志記錄。 |
FATAL | 將導致應用程序提前終止的嚴重錯誤的信息將立即呈現在日志上。 |
ERROR | 將其他運行時錯誤或意外情況的信息呈現在日志上。 |
WARN | 使用已過時的API,API的濫用,潛在錯誤,其他不良的或意外的運行時的狀況(但不一定是錯誤的) |
INFO | 一些感興趣的運行時事件(啟動/關閉 |
DEBUG | 一些詳細信息,查看程序的運行狀態 |
TRACE |
下面介紹如何在java項目中如何使用Log4j。
1. 配置maven,引入jar包
<dependencies> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> </dependencies>
2. 配置log4j的配置文件
其配置文件名為log4j.properties,需要手動在java/resources下創建,如果建在其他位置,idea這個工具將無法識別(如果無法識別后面會介紹怎么解決)。下面介紹該配置文件的幾個基本配置項。
a. 日志的輸出的目的地
形式 | 描述 |
---|---|
org.apache.log4j.ConsoleAppender | 控制台 |
org.apache.log4j.FileAppender | 文件 |
org.apache.log4j.DailyRollingFileAppender | 每天產生一個日志文件 |
org.apache.log4j.RollingFileAppender | 文件大小到達指定尺寸的時候產生一個新的文件 |
org.apache.log4j.WriterAppender | 將日志信息以流格式發送到任意指定的地方 |
b. Layout:日志輸出格式
形式 | 描述 |
---|---|
org.apache.log4j.HTMLLayout | 以HTML表格形式布局 |
org.apache.log4j.PatternLayout | 可以靈活地指定布局模式 |
org.apache.log4j.SimpleLayout | 包含日志信息的級別和信息字符串 |
org.apache.log4j.TTCCLayout | 包含日志產生的時間、線程、類別等等信息 |
c. 格式化日志信息
采用類似C語言中的printf函數的打印格式格式化日志信息
形式 | 描述 |
---|---|
%d | 輸出日志時間點的日期或時間,可以在其后指定格式,比如:%d{yyy MMM dd HH:mm:ss , SSS} |
%t | 輸出產生該日志事件的線程名 |
%p | 優先級 DEBUG/INFO/ERROR |
%c | 所屬類的全名(包括包名) |
%l | 發生的位置,在某個類的某行 |
%m | 輸出代碼中指定的訊息,如log(message)中的message |
%n | 輸出一個換行符號 |
案例
案例使用如下的配置信息:
### set log levels ### log4j.rootLogger = DEBUG,Console,File ### 輸出到控制台 ### 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=[%d{yy/MM/dd HH:mm:ss:SSS}]-%l:%m%n ### 輸出到日志文件 ### log4j.appender.File=org.apache.log4j.RollingFileAppender log4j.appender.File.File=${project}src\\main\\resources\\app.log log4j.appender.File.MaxFileSize=10MB log4j.appender.File.Threshold=ALL log4j.appender.File.layout=org.apache.log4j.PatternLayout log4j.appender.File.layout.ConversionPattern=[%p][%d{yyyy-MM-dd HH\:mm\:ss,SSS}][%c]%m%n
3. 使用Log4j
配置完上面信息后就可以創建一個Java文件去測試日志的文件的使用了。
package com.gqx.test; import org.apache.log4j.Logger; public class Hello { private static Logger log = Logger.getLogger(Hello.class.getClass()); public static void main(String[] args) { log.debug("debug..."); log.error("error..."); } }
結果如圖左側(左上是控制台的log,左下是app.log文件的log),其中整個工程的布局如圖右側:
4 . 問題
過程中可能出現下面的問題:
log4j:WARN No appenders could be found for logger (java.lang.Class).
log4j:WARN Please initialize the log4j system properly. log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.
這個其實是IDE(Idea)找不到log4j的properties文件,有些博客說可以去project_structure去改配置,嘗試了一下可惜沒有用,但發現了可以在程序中通過代碼去指定properties文件的位置,如果出現了 上面的錯誤,可以改成如下形式:
package com.gqx.test; import org.apache.log4j.Logger; import org.apache.log4j.PropertyConfigurator; public class Hello { private static Logger log = Logger.getLogger(Hello.class.getClass()); public static void main(String[] args) { //獲取當前項目的根目錄 String relativelyPath=System.getProperty("user.dir"); PropertyConfigurator.configure(relativelyPath+ "\\src\\main\\resources\\log4j.properties"); log.debug("debug..."); log.error("error..."); } }