詳解ABP框架中的日志管理和設置管理的基本配置

日志管理
Server side(服務(wù)器端)
ASP.NET Boilerplate使用Castle Windsor's logging facility日志記錄工具，并且可以使用不同的日志類(lèi)庫，比如：Log4Net, NLog, Serilog... 等等。對于所有的日志類(lèi)庫，Castle提供了一個(gè)通用的接口來(lái)實(shí)現，我們可以很方便的處理各種特殊的日志庫，而且當業(yè)務(wù)需要的時(shí)候，很容易替換日志組件。

譯者注釋?zhuān)篊astle是什么：Castle是針對.NET平臺的一個(gè)開(kāi)源項目，從數據訪(fǎng)問(wèn)框架ORM到IOC容器，再到WEB層的MVC框架、AOP，基本包括了整個(gè)開(kāi)發(fā)過(guò)程中的所有東西。ASP.NET Boilerplate的ioc容器就是通過(guò)Castle實(shí)現的。

Log4Net 是asp.net下面最流行的一個(gè)日志庫組件， ASP.NET Boilerplate 模板也使用了Log4Net日志庫組件，但是呢，我們這里僅僅通過(guò)一行關(guān)鍵代碼就實(shí)現Log4Net 的依賴(lài)注入（具體說(shuō)明在下面的配置文件），所以，如果你想替換成自己的日志組件，也很容易。

獲取日志記錄器logger
不管你選擇哪一個(gè)日志庫組件，通過(guò)代碼來(lái)進(jìn)行日志記錄都是一樣的。（這里吐槽， Castle's 通用 ILogger 接口實(shí)在太牛逼了）。

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

1、首先呢，我們要先處理日志記錄器對象logger， ASP.NET Boilerplate框架使用了dependency injection依賴(lài)注入技術(shù),我們可以很方便的使用依賴(lài)注入生成日志記錄器對象logger。

接下來(lái)我們看一下 ASP.NET Boilerplate是怎么實(shí)現日志記錄功能的吧：

using Castle.Core.Logging; //1: 導入日志的命名空間，Castle.Core.Logging
public class TaskAppService : ITaskAppService
{ 
 //2:通過(guò)依賴(lài)注入獲取日志記錄器對象。
 這里先定義了一個(gè)ILogger類(lèi)型的public屬性L(fǎng)ogger，這個(gè)對象就是我們用來(lái)記錄日志的對象。在創(chuàng  )建了TaskAppService對象（就是我們應用中定義的任務(wù)）以后，通過(guò)屬性注入的方式來(lái)實(shí)現。
 public ILogger Logger { get; set; }

 public TaskAppService()
 { 
  //3: 如果沒(méi)有日志記錄器，將日志記錄器返回一個(gè)空的實(shí)例，不寫(xiě)日志。這是依賴(lài)注入的最佳實(shí)現方式，  // 如果你不定義這個(gè)空的日志記錄器，當我們獲取對象引用并且實(shí)例化的時(shí)候，就會(huì )產(chǎn)生異常。  // 這么做，保證了對象不為空。所以，換句話(huà)說(shuō)，不設置日志記錄器，就不記錄日志，返回一個(gè)null的對象。  // NullLogger對象實(shí)際上什么都木有，空的。這么做，才能保證我們定義的類(lèi)在實(shí)例化時(shí)正常運作。
  Logger = NullLogger.Instance;
 } 
 public void CreateTask(CreateTaskInput input) 
 {
  //4: 寫(xiě)入日志
  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!

寫(xiě)入日志以后，我們可以查看日志文件，就像下面的格式：

通過(guò)基類(lèi)使用Logger
ASP.NET Boilerplate框架提供了MVC Controllers、Web API Controllers和Application service classes的基類(lèi)（自己定義的控制器和應用服務(wù)，都必須要繼承ASP.NET Boilerplate的基類(lèi)，換句話(huà)說(shuō)，當你自定義的Web API controllers、mvc controllers，Application service classes都繼承了ASP.NET Boilerplate框架對應的基類(lèi)，你就可以直接使用日志記錄器）。

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

說(shuō)明：SimpleTaskSystemControllerBase這個(gè)基類(lèi)控制器是我們自己定義的基類(lèi)控制器，他必須繼承自 AbpController。

這樣實(shí)現，日志記錄器才能正常工作。當然了，你也可以實(shí)現自己的基類(lèi)，這樣的話(huà)你也可以不使用依賴(lài)注入了。

 配置
如果你在官網(wǎng)上通過(guò)ASP.NET Boilerplate templates 來(lái)生成了你的工程，Log4Net的所有配置都自動(dòng)生成了。

默認的配置格式如下：

•Log level: 日志記錄等級，有DEBUG, INFO, WARN, ERROR or FATAL5個(gè)。
•Date and time: 日志記錄時(shí)間。
•Thread number: 每行日志寫(xiě)時(shí)候的線(xiàn)程號。
•Logger name: 日志記錄器的名字，通常情況就是類(lèi)名稱(chēng)。
•Log text: 你寫(xiě)入的日志內容。
配置文件：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是一個(gè)非常強大和易用的日志庫組件，你可以寫(xiě)各種日志，比如寫(xiě)到txt文件，寫(xiě)入到數據庫等等。你能設置最小的日志等級，就像上面這個(gè)針對NHibernate的配置。不同的記錄器寫(xiě)不同的日志，等等。

具體的用法大家可以參照：http://logging.apache.org/log4net/release/config-examples.html

最后，在工程的Global.asax 文件中，來(lái)定義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這個(gè)日志記錄組件，工程中的Log4Net庫是在 nuget package包中的，你也可以換成其他日志組件庫，但是代碼不用做任何改變。因為，我們的框架是通過(guò)依賴(lài)注入實(shí)現日志記錄器的！

 Client side（客戶(hù)端）
最后，更厲害的是，你還可以在客戶(hù)端調用日志記錄器。在客戶(hù)端，ASP.NET Boilerplate框架有對應的 javascript 日志API，這意味著(zhù)你可以記錄下來(lái)瀏覽器的日志，實(shí)現代碼如下：

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

附上：客戶(hù)端javascript的api，這里要說(shuō)明的是，你可以使用console.log在客戶(hù)端輸出日志，但是這個(gè)API 不一定支持所有的瀏覽器，還有可能導致你的腳本出現異常，你可以使用我們的api，我們的是安全的，你甚至可以重載或者擴展這些api。

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

設置管理
介紹
每個(gè)應用程序需要存儲一些設置并在應用程序的某個(gè)地方使用這些設置。ABP框架提供強大的基礎架構，我們可以在服務(wù)端或者客戶(hù)端設置，來(lái)存儲/獲取應用程序、 租戶(hù)和用戶(hù)級別的配置。

設置通常是存儲在數據庫（或另一個(gè)來(lái)源）中，用名稱(chēng)-值（name-value）字符串對應的結構來(lái)表示。我們可以把非字符串值轉換成字符串值來(lái)存儲。

注意：關(guān)于ISettingStore接口

為了使用設置管理必須實(shí)現 ISettingStore 接口。你可以用自己的方式實(shí)現它，在module-zero項目中有完整的實(shí)現可以參考。

定義設置
使用設置之前必須要先定義。ABP框架是模塊化設計，所以不同的模塊可以有不同的設置。為了定義模塊自己的設置，每個(gè)模塊都應該創(chuàng )建繼承自SettingProvider 的派生類(lèi)。設置提供程序示例如下所示：

public class MySettingProvider : SettingProvider
{
 public override IEnumerable<SettingDefinition> GetSettingDefinitions(SettingDefinitionProviderContext context)
 {
  return new[]
    {
     new SettingDefinition(
      "SmtpServerAddress",
      "127.0.0.1"
      ),

     new SettingDefinition(
      "PassiveUsersCanNotLogin",
      "true",
      scopes: SettingScopes.Application | SettingScopes.Tenant
      ),

     new SettingDefinition(
      "SiteColorPreference",
      "red",
      scopes: SettingScopes.User,
      isVisibleToClients: true
      )
    };
 }
} 

GetSettingDefinitions 方法返回 SettingDefinition 對象。SettingDefinition 類(lèi)的構造函數中有如下參數：

•Name (必填):必須具有全系統唯一的名稱(chēng)。比較好的辦法是定義字符串常量來(lái)設置Name。
•Default value: 設置一個(gè)默認值。此值可以是null 或空字符串。
•Scopes: 定義設置的范圍 (見(jiàn)下文)。
•Display name: 一個(gè)可本地化的字符串，用于以后在UI中顯示設置的名稱(chēng)。
•Description: 一個(gè)可本地化的字符串，用于以后在UI中顯示設置的描述。
•Group: 可用于設置組。這僅僅是UI使用，不用于設置管理。
•IsVisibleToClients: 設置為 true 將使設置在客戶(hù)端可用。
在創(chuàng )建設置提供程序(SettingProvider)之后，我們應該在預初始化(PreIntialize)方法中注冊我們的模塊:

Configuration.Settings.Providers.Add<MySettingProvider>();設置提供程序會(huì )自動(dòng)注冊依賴(lài)注入。所以，設置提供程序可以注入任何依賴(lài)項 (如存儲庫) 來(lái)生成設置定義的一些其它來(lái)源。

 設置范圍
有三個(gè)設置范圍 (或級別) 在 SettingScopes 枚舉中定義:

•Application：應用程序范圍設置用于用戶(hù)/租戶(hù)獨立的設置。例如，我們可以定義一個(gè)名為"SmtpServerAddress"的設置，當發(fā)送電子郵件時(shí)，獲取服務(wù)器的 IP 地址。如果此設置有一個(gè)單一的值 (不基于用戶(hù)改變)，那么我們可以定義它為應用程序范圍。
•Tenant：如果應用程序是多租戶(hù)的，我們可以定義特定于租戶(hù)的設置。
•User：我們可以使用的用戶(hù)范圍的設置來(lái)為每個(gè)用戶(hù)存儲/獲取設置的值。
SettingScopes 枚舉具有Flags屬性，所以我們可以定義一個(gè)具有多個(gè)作用域的設置。

設置范圍是分層的。例如，如果我們定義設置范圍為"Application | Tenant | User"并嘗試獲取當前設置的值;

•我們獲取特定用戶(hù)的值，如果它定義 (重寫(xiě)) User。
•如果沒(méi)有，我們獲取特定的租戶(hù)值，如果它定義 (重寫(xiě)) Tenant。
•如果沒(méi)有，我們獲取應用的值，如果它定義Application。
•如果沒(méi)有，我們得到的默認值。
默認值可以是 null 或空字符串。如果可以，建議為設置提供一個(gè)默認值。

獲取設置值
定義設置后，我們可以在服務(wù)器和客戶(hù)端獲取到它的當前值。

(1)服務(wù)器端（Server side）
ISettingManager 用于執行設置操作。我們可以在應用程序中任何地方注入和使用它。ISettingManager 定義了很多獲取設置值方法。

最常用的方法是 GetSettingValue (或GetSettingValueAsync 為異步調用)。它將返回當前設置的基于默認值、 應用程序、 租戶(hù)和用戶(hù)設置范圍的值(如設置范圍之前的一段中所述)。例子:

//Getting a boolean value (async call)
var value1 = await SettingManager.GetSettingValueAsync<bool>("PassiveUsersCanNotLogin");
//Getting a string value (sync call)
var value2 = SettingManager.GetSettingValue("SmtpServerAddress"); 

GetSettingValue 有泛型和異步版本，如上所示。也有方法來(lái)獲取特定的租戶(hù)或用戶(hù)的設置值或所有設置值的列表。

由于ISettingManager使用廣泛，一些特定的基類(lèi) (如 ApplicationService、 DomainService 和 AbpController) 有一個(gè)名為 SettingManager的屬性。如果我們從這些類(lèi)繼承，就無(wú)需顯式地注入它。

(2)客戶(hù)端
如果定義設置時(shí)將 IsVisibleToClients 設置為 true，就可以在客戶(hù)端使用 javascript得到它的當前值。abp.setting 命名空間定義所需的函數和對象。示例:

var currentColor = abp.setting.get("SiteColorPreference");也有 getInt 和 getBoolean 這樣的方法。你可以使用 abp.setting.values 對象獲取所有值。請注意，如果你在服務(wù)器端更改設置，客戶(hù)端不會(huì )知道這種變化，除非刷新頁(yè)面或者以某種方式重新加載頁(yè)面或者通過(guò)代碼手動(dòng)更新。

更改設置
ISettingManager 定義了 ChangeSettingForApplicationAsync，ChangeSettingForTenantAsync 和 ChangeSettingForUserAsync 方法（以及同步版本）來(lái)更改應用程序，租戶(hù)和用戶(hù)分別的設置。

關(guān)于緩存
緩存在服務(wù)器端設置管理，所以，我們不應直接使用存儲庫或數據庫更新語(yǔ)句改變設置的值。