程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> C語言 >> 關於C語言 >> C#中log4net使用方法(一)

C#中log4net使用方法(一)

編輯:關於C語言
Log4net是一個第三方開源組件,它設計的主要目的是組合,生成日志信息,同時將配置保存到各種存儲介質或者展現平台中,在實際項目中,Log4net可以保存系統運行情況,可以在系統出現異常時,根據保存的日志信息,查看當時系統的狀態。

  1.Log4net的優點:

  幾乎所有的大型應用都會有自己的用於跟蹤調試的API。因為一旦程序被部署以後,就不太可能再利用專門的調試工具了。然而一個管理員可能需要有一套強大的日志系統來診斷和修復配置上的問題。

  經驗表明,日志記錄往往是軟件開發周期中的重要組成部分。它具有以下幾個優點:它可以提供應用程序運行時的精確環境,可供開發人員盡快找到應用程序中的Bug;一旦在程序中加入了Log 輸出代碼,程序運行過程中就能生成並輸出日志信息而無需人工干預。另外,日志信息可以輸出到不同的地方(控制台,文件等)以備以後研究之用。

  Log4net就是為這樣一個目的設計的,用於.Net開發環境的日志記錄包。

  2 Log4net的安裝:

  用戶可以從http://logging.apache.org/log4net/下載log4net的源代碼。解壓軟件包後,在解壓的src目錄下將log4net.sln載入Visual Studio .Net,編譯後可以得到log4net.dll。用戶要在自己的程序裡加入日志功能,只需將log4net.dll引入工程即可。

  3 Log4net的結構

  log4net 有四種主要的組件,分別是Logger(記錄器), Repository(庫), Appender(附著器)以及 Layout(布局).

  (1) Logger接口

  Logger是應用程序需要交互的主要組件,它用來產生日志消息。產生的日志消息並不直接顯示,還要預先經過Layout的格式化處理後才會輸出。

  Logger提供了多種方式來記錄一個日志消息,你可以在你的應用程序裡創建多個Logger,每個實例化的Logger對象都被log4net框架作為命名實體(named entity)來維護。這意味著為了重用Logger對象,你不必將它在不同的類或對象間傳遞,只需要用它的名字為參數調用就可以了。log4net框架使用繼承體系,繼承體系類似於.Net中的名字空間。也就是說,如果有兩個logger,分別被定義為a.b.c和a.b,那麼我們說a.b是a.b.c 的祖先。每一個logger都繼承了祖先的屬性

  Log4net框架定義了一個ILog接口,所有的logger類都必須實現這個接口。如果你想實現一個自定義的logger,你必須首先實現這個接口。你可以參考在/extension目錄下的幾個例子。

  ILog接口的定義如下:

  public interface ILog { void Debug(object message); void Info(object message); void Warn(object message); void Error(object message); void Fatal(object message); //以上的每一個方法都有一個重載的方法,用來支持異常處理。 //每一個重載方法都如下所示,有一個異常類型的附加參數。 void Debug(object message, Exception ex); // ... //Boolean 屬性用來檢查Logger的日志級別 //(我們馬上會在後面看到日志級別) bool isDebugEnabled; bool isInfoEnabled; //… 其他方法對應的Boolean屬性 }

  Log4net框架定義了一個叫做LogManager的類,用來管理所有的logger對象。它有一個GetLogger()靜態方法,用我們提供的名字參數來檢索已經存在的Logger對象。如果框架裡不存在該Logger對象,它也會為我們創建一個Logger對象。代碼如下所示:

  log4net.ILog log = log4net.LogManager.GetLogger("logger-name");

  通常來說,我們會以類(class)的類型(type)為參數來調用GetLogger(),以便跟蹤我們正在進行日志記錄的類。傳遞的類(class)的類型(type)可以用typeof(Classname)方法來獲得,或者可以用如下的反射方法來獲得:

  System.Reflection.MethoDBase.GetCurrentMethod().DeclaringType

  盡管符號長了一些,但是後者可以用於一些場合,比如獲取調用方法的類(class)的類型(type)。

  (2)日志的級別

  正如你在ILog的接口中看到的一樣,有五種不同的方法可以跟蹤一個應用程序。事實上,這五種方法是運作在Logger對象設置的不同日志優先級別上。這幾種不同的級別是作為常量定義在log4net.spi.Level類中。你可以在程序中使用任何一種方法。但是在最後的發布中你也許不想讓所有的代碼來浪費你的CPU周期,因此,框架提供了7種級別和相應的Boolean屬性來控制日志記錄的類型。

  Level有以下幾種取值:

  

 Logger的日志級別

  表1 Logger的日志級別

  在log4net框架裡,通過設置配置文件,每個日志對象都被分配了一個日志優先級別。如果沒有給一個日志對象顯式地分配一個級別,那麼該對象會試圖從他的祖先繼承一個級別值。

  ILog接口的每個方法都有一個預先定義好了的級別值。正如你在表1看到的,ILog的Inof()方法具有INFO級別。同樣的,以此類推,Error()方法具有ERROR級別。當我們使用以上的任何一種方法時,log4net框架會檢查日志對象logger的級別和方法的級別。只有當方法的級別高於日志級別時,日志請求才會被接受並執行。

  舉例說明,當你創建了一個日志對象,並且把他的級別設置為INFO。於是框架會設置日志的每個Boolean屬性。當你調用相應的日志方法時,框架會檢查相應的Boolean屬性,以決定該方法能不能執行。如下的代碼:Logger.Info("message");

  Logger.Debug("message");

  Logger.Warn("message");

  對於第一種方法,Info()的級別等與日志的級別(INFO),因此日志請求會被傳遞,我們可以得到輸出結果”message”。

  對於第二種方法,Debug()的級別低於日志對象logger的日志級別(INFO),因此,日志請求被拒絕了,我們得不到任何輸出。同樣的,針對第三行語句,我們可以很容易得出結論。

  在表1中有兩個特殊的級別:ALL和OFF。ALL表示允許所有的日志請求。OFF是拒絕所有的請求。

  你也可以顯式地檢查Logger對象的Boolean屬性,如下所示:

  if (logger.IsDebugEnabled)

  {

  Logger.Debug("message");

  }

  Repository

  Repository主要用於負責日志對象組織結構的維護。在log4net的以前版本中,框架僅支持分等級的組織結構(hierarchical organization)。這種等級結構本質上是庫的一個實現,並且定義在log4net.Repository.Hierarchy 名字空間中。要實現一個Repository,需要實現log4net.Repository.ILoggerRepository 接口。但是通常並不是直接實現該接口,而是以log4net.Repository.LoggerRepositorySkeleton為基類繼承。體系庫(hierarchical repository )則由log4net.Repository.Hierarchy.HIErarchy類實現。

  如果你是個log4net框架的使用者,而非擴展者,那麼你幾乎不會在你的代碼裡用到Repository的類。相反的,你需要用到LogManager類來自動管理庫和日志對象。

  Appender

  一個好的日志框架應該能夠產生多目的地的輸出。比如說輸出到控制台或保存到一個日志文件。log4net 能夠很好的滿足這些要求。它使用一個叫做Appender的組件來定義輸出介質。正如名字所示,這些組件把它們附加到Logger日志組件上並將輸出傳遞到輸出流中。你可以把多個Appender組件附加到一個日志對象上。Log4net框架提供了幾個Appender組件。關於log4net提供的 Appender組件的完整列表可以在log4net框架的幫助手冊中找到。有了這些現成的Appender組件,一般來說你沒有必要再自己編寫了。但是如果你願意,可以從log4net.Appender.AppenderSkeleton類繼承

  Appender Filters

  一個Appender 對象缺省地將所有的日志事件傳遞到輸出流。Appender的過濾器(Appender Filters) 可以按照不同的標准過濾日志事件。在log4net.Filter的名字空間下已經有幾個預定義的過濾器。使用這些過濾器,你可以按照日志級別范圍過濾日志事件,或者按照某個特殊的字符串進行過濾。你可以在API的幫助文件中發現更多關於過濾器的信息。

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved