org.apache.log4j.Level類提供以下級別,但也可以通過Level類的子類自定義級別。
Level | 描述 |
---|---|
ALL | 各級包括自定義級別 |
DEBUG | 指定細粒度資訊事件是最有用的應用程式偵錯 |
ERROR | 錯誤事件可能仍然允許應用程式繼續執行 |
FATAL | 指定非常嚴重的錯誤事件,這可能導致應用程式中止 |
INFO | 指定能夠突出在粗粒度級別的應用程式執行情況的資訊的訊息 |
OFF | 這是最高等級,為了關閉紀錄檔記錄 |
TRACE | 指定細粒度比DEBUG更低的資訊事件 |
WARN | 指定具有潛在危害的情況 |
級別p的級別使用q,在記錄紀錄檔請求時,如果p>=q啟用。這條規則是log4j的核心。它假設級別是有序的。對於標準級別它們關係如下:ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF。
下面的例子明確指出如何可以過濾所有的DEBUG和INFO訊息。這個程式使用記錄並執行setLevel(Level.X)方法來設定所需的紀錄檔記錄級別:
這個例子將列印,除了偵錯和資訊的所有訊息:
import org.apache.log4j.*; public class LogClass { private static org.apache.log4j.Logger log = Logger .getLogger(LogClass.class); public static void main(String[] args) { log.setLevel(Level.WARN); log.trace("Trace Message!"); log.debug("Debug Message!"); log.info("Info Message!"); log.warn("Warn Message!"); log.error("Error Message!"); log.fatal("Fatal Message!"); } }
當編譯並執行LogClass程式會產生以下結果:
Warn Message! Error Message! Fatal Message!
Log4j提供這些可以讓程式員自由更改原始碼,改變偵錯級別的組態級別是基於檔案設定。
以下是上面的例子使用 log.setLevel(Level.WARN)方法的組態檔案與上面的例子例子功能一樣。
# Define the root logger with appender file log = /usr/home/log4j log4j.rootLogger = WARN, FILE # Define the file appender log4j.appender.FILE=org.apache.log4j.FileAppender log4j.appender.FILE.File=${log}/log.out # Define the layout for file appender log4j.appender.FILE.layout=org.apache.log4j.PatternLayout log4j.appender.FILE.layout.conversionPattern=%m%n
現在,使用下面的程式:
import org.apache.log4j.*; public class LogClass { private static org.apache.log4j.Logger log = Logger .getLogger(LogClass.class); public static void main(String[] args) { log.trace("Trace Message!"); log.debug("Debug Message!"); log.info("Info Message!"); log.warn("Warn Message!"); log.error("Error Message!"); log.fatal("Fatal Message!"); } }
現在,編譯和執行上面的程式,得到以下結果在 /usr/home/log4j/log.out 檔案:
Warn Message! Error Message! Fatal Message!