ABP(現代ASP.NET樣板開發框架)系列之八、ABP日誌管理

點這裏進入ABP系列文章總目錄

 

基於DDD的現代ASP.NET開發框架--ABP系列之八、ABP日誌管理

 

ABP是「ASP.NET Boilerplate Project (ASP.NET樣板項目)」的簡稱。

ABP的官方網站：http://www.aspnetboilerplate.com

ABP在Github上的開源項目：https://github.com/aspnetboilerplate

 

---

本文由東莞-天道提供翻譯

Server side(服務器端)

ASP.NET Boilerplate使用Castle Windsor's logging facility日誌記錄工具，而且可使用不一樣的日誌類庫，好比：Log4Net, NLog, Serilog... 等等。對於全部的日誌類庫，Castle提供了一個通用的接口來實現，咱們能夠很方便的處理各類特殊的日誌庫，並且當業務須要的時候，很容易替換日誌組件。

譯者註釋：Castle是什麼：Castle是針對.NET平臺的一個開源項目，從數據訪問框架ORM到IOC容器，再到WEB層的MVC框架、AOP，基本包括了整個開發過程當中的全部東西。ASP.NET Boilerplate的ioc容器就是經過Castle實現的。

Log4Net 是asp.net下面最流行的一個日誌庫組件， ASP.NET Boilerplate 模板也使用了Log4Net日誌庫組件，可是呢，咱們這裏僅僅經過一行關鍵代碼就實現Log4Net 的依賴注入（具體說明在下面的配置文件），因此，若是你想替換成本身的日誌組件，也很容易。

獲取日誌記錄器logger

無論你選擇哪個日誌庫組件，經過代碼來進行日誌記錄都是同樣的。（這裏吐槽， Castle's 通用 ILogger 接口實在太牛逼了）。

下面進入正題：(譯者注:下面的代碼是abp框架的Castle.Core源碼分析以及實現)

一、首先呢，咱們要先處理日誌記錄器對象logger， ASP.NET Boilerplate框架使用了dependency injection依賴注入技術,咱們能夠很方便的使用依賴注入生成日誌記錄器對象logger。

接下來咱們看一下 ASP.NET Boilerplate是怎麼實現日誌記錄功能的吧：

using Castle.Core.Logging; //1: 導入日誌的命名空間，Castle.Core.Logging

public class TaskAppService : ITaskAppService
{ 
   //2:經過依賴注入獲取日誌記錄器對象。
   這裏先定義了一個ILogger類型的public屬性Logger，這個對象就是咱們用來記錄日誌的對象。在建立了TaskAppService對象（就是咱們應用中定義的任務）之後，經過屬性注入的方式來實現。
   public ILogger Logger { get; set; }

   public TaskAppService()
   { 
      //3: 若是沒有日誌記錄器，將日誌記錄器返回一個空的實例，不寫日誌。這是依賴注入的最佳實現方式，
      //   若是你不定義這個空的日誌記錄器，當咱們獲取對象引用而且實例化的時候，就會產生異常。
      //   這麼作，保證了對象不爲空。因此，換句話說，不設置日誌記錄器，就不記錄日誌，返回一個null的對象。
      //   NullLogger對象實際上什麼都木有，空的。這麼作，才能保證咱們定義的類在實例化時正常運做。
      Logger = NullLogger.Instance;
   }
 
   public void CreateTask(CreateTaskInput input) 
   {
      //4: 寫入日誌
     Logger.Info("Creating a new task with description: " + input.Description);

     //TODO: save task to database... 
   } 
} 

寫入日誌之後，咱們能夠查看日誌文件，就像下面的格式：

INFO 2014-07-13 13:40:23,360 [8 ] SimpleTaskSystem.Tasks.TaskAppService - Creating a new task with description:Remember to drink milk before sleeping!

 

經過基類使用Logger

ASP.NET Boilerplate框架提供了MVC Controllers、Web API Controllers和Application service classes的基類（本身定義的控制器和應用服務，都必需要繼承ASP.NET Boilerplate的基類，換句話說，當你自定義的Web API controllers、mvc controllers，Application service classes都繼承了ASP.NET Boilerplate框架對應的基類，你就能夠直接使用日誌記錄器）。

public class HomeController : SimpleTaskSystemControllerBase  
{ 
   public ActionResult Index() 
   { 
      Logger.Debug("A sample log message..."); 
      return View(); 
   } 
} 

說明：SimpleTaskSystemControllerBase這個基類控制器是咱們本身定義的基類控制器，他必須繼承自 AbpController。

這樣實現，日誌記錄器才能正常工做。固然了，你也能夠實現本身的基類，這樣的話你也能夠不使用依賴注入了。

 

配置

若是你在官網上經過ASP.NET Boilerplate templates 來生成了你的工程，Log4Net的全部配置都自動生成了。

默認的配置格式以下：

• Log level: 日誌記錄等級，有DEBUG, INFO, WARN, ERROR or FATAL5個。
• Date and time: 日誌記錄時間。
• Thread number: 每行日誌寫時候的線程號。
• Logger name: 日誌記錄器的名字，一般狀況就是類名稱。
• Log text: 你寫入的日誌內容。

配置文件：log4net.config 通常都在項目的web目錄下面。

<?xml version="1.0" encoding="utf-8" ?>
<log4net>
  <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender" >
    <file value="Logs/Logs.txt" />
    <appendToFile value="true" />
    <rollingStyle value="Size" />
    <maxSizeRollBackups value="10" />
    <maximumFileSize value="10000KB" />
    <staticLogFileName value="true" />
    <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%-5level %date [%-5.5thread] %-40.40logger - %message%newline" />
    </layout>
  </appender>
  <root>
    <appender-ref ref="RollingFileAppender" />
    <level value="DEBUG" />
  </root>
  <logger name="NHibernate">
    <level value="WARN" />
  </logger>
</log4net>

Log4Net是一個很是強大和易用的日誌庫組件，你能夠寫各類日誌，好比寫到txt文件，寫入到數據庫等等。你能設置最小的日誌等級，就像上面這個針對NHibernate的配置。不一樣的記錄器寫不一樣的日誌，等等。

具體的用法你們能夠參照：http://logging.apache.org/log4net/release/config-examples.html

最後，在工程的Global.asax 文件中，來定義Log4Net的配置文件：

public class MvcApplication : AbpWebApplication
{
    protected override void Application_Start(object sender, EventArgs e)
    {
        IocManager.Instance.IocContainer.AddFacility<LoggingFacility>(f => f.UseLog4Net().WithConfig("log4net.config"));
        base.Application_Start(sender, e);
    }
}

幾行代碼就調用了Log4Net這個日誌記錄組件，工程中的Log4Net庫是在 nuget package包中的，你也能夠換成其餘日誌組件庫，可是代碼不用作任何改變。由於，咱們的框架是經過依賴注入實現日誌記錄器的！

 

Client side（客戶端）

最後，更厲害的是，你還能夠在客戶端調用日誌記錄器。在客戶端，ASP.NET Boilerplate框架有對應的 javascript 日誌API，這意味着你能夠記錄下來瀏覽器的日誌，實現代碼以下：

abp.log.warn('a sample log message...'); 

 

附上：客戶端javascript的api，這裏要說明的是，你可使用console.log在客戶端輸出日誌，可是這個API 不必定支持全部的瀏覽器，還有可能致使你的腳本出現異常，你可使用咱們的api，咱們的是安全的，你甚至能夠重載或者擴展這些api。

abp.log.debug('...');
abp.log.info('...');
abp.log.warn('...');
abp.log.error('...'); 
abp.log.fatal('...');

 

 

---

 

但願更多國內的架構師能關注到ABP這個項目，也許這其中有能幫助到您的地方，也許有您的參與，這個項目能夠發展得更好。

歡迎加ABP架構設計交流QQ羣：134710707

 

點這裏進入ABP系列文章總目錄