如何使用Log4j?

如何使用Log4j?

1、 Log4j是什麼?
 Log4j可以幫助調試(有時候debug是發揮不了作 用的)和分析,要下載和了解更詳細的內容,還是訪問其官方網站吧:

 http://jakarta.apache.org/log4j 

2、Log4j的概念
  Log4j中有三個主要的組件,它們分別是
 Logger、Appender和Layout,Log4j 允許開發人員定義多個Logger,每個Logger擁有自己的名字,Logger之間通過名字來表明隸屬關係。有一個Logger稱爲Root,它永遠 存在,且不能通過名字檢索或引用,可以通過Logger.getRootLogger()方法獲得,其它Logger通過 Logger.getLogger(String name)方法。
  Appender則是用來指明將所有的log信息存放到什麼地方,Log4j中支持多種appender,如
 console、files、GUI components、NT Event Loggers等,一個Logger可以擁有多個Appender,也就是你既可以將Log信息輸出到屏幕,同時存儲到一個文件中。
  Layout的作用是控制Log信息的輸出方式,也就是格式化輸出的信息。
  Log4j中將要輸出的Log信息定義了5種級別,依次爲DEBUG、INFO、WARN、ERROR和FATAL,當輸出時,只有級別高過配置中規定的 級別的信息才能真正的輸出,這樣就很方便的來配置不同情況下要輸出的內容,而不需要更改代碼,這點
實在是方便啊。


3、Log4j的配置文件
 雖然可以不用配置文件,而在程序中實現配置,但這種方法在如今的系統開發中顯然是不可取的,能採用配置文件的地方一定一定要用配置文件。Log4j支持兩 種格式的配置文件:XML格式和Java的property格式,本人更喜歡後者,首先看一個簡單的例子吧,如下:

 log4j.rootLogger=debug, stdout, R
 log4j.appender.stdout=org.apache.log4j.ConsoleAppender
 log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

 # Pattern to output the caller's file name and line number.
 log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n

 log4j.appender.R=org.apache.log4j.RollingFileAppender
 log4j.appender.R.File=example.log
 log4j.appender.R.MaxFileSize=
 100KB

 # Keep one backup file
 log4j.appender.R.MaxBackupIndex=1

 log4j.appender.R.layout=org.apache.log4j.PatternLayout
 log4j.appender.R.layout.ConversionPattern=%p %t %c - %m%n         

 首先,是設置root,格式爲 log4j.rootLogger=[level],appenderName, ...,其中level就是設置需要輸出信息的級別,後面是appender的輸出的目的地,appenderName就是指定日誌信息輸出到哪個地方。您可以同時指定多個輸出目的地。 配置日誌信息輸出目的地Appender,其語法爲
 log4j.appender.appenderName = fully.qualified.name.of.appender.class
 log4j.appender.appenderName.option1 = value1
 ...
 log4j.appender.appenderName.option = valueN
 
Log4j提供的appender有以下幾種:
 org.apache.log4j.ConsoleAppender(控制檯)
 org.apache.log4j.FileAppender(文件)
 org.apache.log4j.DailyRollingFileAppender(每天產生一個日誌文件)
 org.apache.log4j.RollingFileAppender(文件大小到達指定尺寸的時候產生新文件)
 org.apache.log4j.WriterAppender(將日誌信息以流格式發送到任意指定的地方)
配置日誌信息的格式(佈局),其語法爲:
 log4j.appender.appenderName.layout = fully.qualified.name.of.layout.class
 log4j.appender.appenderName.layout.option1 = value1
 ....
 log4j.appender.appenderName.layout.option = valueN
 
Log4j提供的layout有以下幾種:
 org.apache.log4j.HTMLLayout(以HTML表格形式佈局),
 org.apache.log4j.PatternLayout(可以靈活地指定佈局模式),
 org.apache.log4j.SimpleLayout(包含日誌信息的級別和信息字符串),
 org.apache.log4j.TTCCLayout(包含日誌產生的時間、線程、類別等等信息) 

Log4J採用類似C語言中的printf函數的打印格式格式化日誌信息,打印參數如下: %m 輸出代碼中指定的消息

   %p 輸出優先級,即DEBUG,INFO,WARN,ERROR,FATAL 
  %r 輸出自應用啓動到輸出該log信息耗費的毫秒數 
  %c 輸出所屬的類目,通常就是所在類的全名 
  %t 輸出產生該日誌事件的線程名 
  %n 輸出一個回車換行符,Windows平臺爲“\r\n”,Unix平臺爲“\n” 
  %d 輸出日誌時間點的日期或時間,默認格式爲ISO8601,也可以在其後指定格式,比如:%d{yyy MMM dd HH:mm:ss,SSS},輸出類似:
 
2002年10月18日 22:10:28,921 
  %l 輸出日誌事件的發生位置,包括類目名、發生的線程,以及在代碼中的行數。舉例:Testlog4.main(TestLog4.java:10)



4、Log4j在程序中的使用 

 要在自己的程序中使用Log4j,首先需要將commons-logging.jar和logging-log4j-1.2.9.jar導入到構建路徑 中。然後再將log4j.properties放到src根目錄下。這樣就可以在程序中使用log4j了。在類中使用log4j, 
首先聲明一個靜態變量 Logger logger=Logger.getLog("classname");現在就可以使用了,用法如下:logger.debug("debug message")或者logger.info("info message"),看下面一個小例子: 

 import com.foo.Bar;
 import org.apache.log4j.Logger;
 import org.apache.log4j.PropertyConfigurator;
 public class MyApp {
   static Logger logger = Logger.getLogger(MyApp.class.getName());
   public static void main(String[] args) {
     // BasicConfigurator replaced with PropertyConfigurator.
     PropertyConfigurator.configure(args[0]);
     logger.info("Entering application.");
     Bar bar = new Bar();
     bar.doIt();
     logger.info("Exiting application.");
   }
 }


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章