Enterprise Library 2.0 -- Logging Application Block (补充)

        在前面的文章中,有朋友提到我们在实际项目中往往是把一些事件的日志(比如异常)写入到数据库中,这样更方便查看和管理,而在前面的文章中我都是以写入到文本文件为例的，今天这篇文章就算是对前两篇的一个补充,主要来介绍如何将日志信息写入到数据库中,同时也很感谢那位朋友的建议,下面我们进入正题，分为以下几个步骤：
       一、 根据Enterprise Library 2.0中将日志写入到数据库中的需要，我们在数据库中添加一张记录日志的表(RX_Log):

-- 日志信息表
create   table  RX_Log
(
    id                         int   identity           not   null ,         -- 流水号
    EventId                     int                   null ,             -- 事件ID
    Priority                 int                      null ,             -- 优先级
    Category                 varchar ( 1000 )         null ,             -- 类别
    Title                     varchar ( 500 )         null ,             -- 日志标题
    Message                     varchar ( 1000 )         null ,             -- 日志信息
    Machine                     varchar ( 100 )         null ,             -- 主机名
    Timestamps                 smalldatetime          null ,             -- 记录时间
    Severity                 varchar ( 100 )         null ,             -- 严重级别
    ApplicationDomain         varchar ( 1000 )         null ,             -- 应用程序名
    ProcessId                 int                      null ,             -- 进程ID
    ProcessName                 varchar ( 500 )         null ,             -- 进程名
    Win32ThreadId             int                      null ,             -- 线程ID
    ThreadName                 varchar ( 500 )         null ,             -- 线程名
    ExtendedProperties         varchar ( 1000 )         null ,             -- 扩展信息

     primary   key (id)
)

 Logging Application Block 在写日志到数据库的过程中，还需要两个存储过程（注意：这也是和1.0的一点小区别，上一个版本只需要一个存储过程），分别为：

-- 建立存储过程
-- 写日志
create   procedure  usp_writelogtodatabase
(
     @EventId                  int ,
     @Priority                  int ,
     @Title                      varchar ( 500 ),
     @Message                  varchar ( 4000 ),
     @machineName              varchar ( 100 ),
     @Timestamp                  smalldatetime ,
     @Severity                  varchar ( 100 ),
     @AppDomainName              varchar ( 1000 ),
     @ProcessId                  int ,
     @ProcessName              varchar ( 500 ),
     @Win32ThreadId              int ,
     @ThreadName                  varchar ( 500 ),
     @formattedmessage          varchar ( 4000 ),
     @LogId                      int     out
)
as
begin

     insert   into  RX_Log 
    (
        EventId,
        Priority,
        Title,
        Message,
        Machine,
        Timestamps,
        Severity,
        ApplicationDomain,
        ProcessId,
        ProcessName,
        Win32ThreadId,
        ThreadName,
        ExtendedProperties
    )
     values
    (
         @EventId ,
         @Priority ,
         @Title ,
         @Message ,
         @machineName ,
         @Timestamp ,
         @Severity ,
         @AppDomainName ,
         @ProcessId ,
         @ProcessName ,
         @Win32ThreadId ,
         @ThreadName ,
         @formattedmessage
    )

     set   @LogId = @@identity
    
    
end

-- 设置日志类别
create   procedure  usp_addcategory
(
     @categoryName          varchar ( 1000 ),
     @logID                  int
)
as  
begin
     UPDATE  RX_Log  SET  Category = @categoryName   WHERE  ID = @logID
end

上面的工作做好之后，我们在来配置我们的配置文件，首先我们需要添加一个DataBase的Trace Listener，如下图：



然后指定一些该Trace Listener的属性，包括AddCategoryStoreProcedure,DataBaseInstance,Formatter,Name,TraceOutputOptions以及WriteLogStoreProcedure。



其中AddCategoryStoredProcedure和WriteLogStoredProcedureName就是我们刚刚在数据库中建的存储过程，前者是设置日志类别，后者为向数据库中插入日志的存储过程。DataBaseInstance是我们在Data Access Application Block中建立的一个数据库实例，具体方法可以参考： 
Enterprise Library 2.0 -- Data Access Application Block,Formatter则是我们选择上篇文章中设置的SHY520 Formatter，具体的配置方法请参考：
Enterprise Library 2.0 -- Logging Application Block (上)
Enterprise Library 2.0 -- Logging Application Block (下)
其他选项我们先保持默认，接着我们需要添加一个Category，命名为DataBase



然后为这个Category添加一个Trace Listener,并设置其RefrencedTraceListener为我们刚刚建的Database Trace Listener，



这样就完成了我们的配置工作，此时你的配置文件中(Web.Config或App.Config)应该会包含下面的信息：

<? xml version="1.0" encoding="utf-8" ?>
< configuration >
   < configSections >
     < section  name ="loggingConfiguration"  type ="Microsoft.Practices.EnterpriseLibrary.Logging.Configuration.LoggingSettings, Microsoft.Practices.EnterpriseLibrary.Logging, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"   />
     < section  name ="dataConfiguration"  type ="Microsoft.Practices.EnterpriseLibrary.Data.Configuration.DatabaseSettings, Microsoft.Practices.EnterpriseLibrary.Data, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"   />
   </ configSections >
   < loggingConfiguration  name ="Logging Application Block"  tracingEnabled ="true"
    defaultCategory ="General"  logWarningsWhenNoCategoriesMatch ="true" >
     < listeners >
       < add  databaseInstanceName ="Connection String"  writeLogStoredProcName ="usp_writelogtodatabase"
        addCategoryStoredProcName ="usp_addcategory"  formatter ="SHY520 Formatter"
        listenerDataType ="Microsoft.Practices.EnterpriseLibrary.Logging.Database.Configuration.FormattedDatabaseTraceListenerData, Microsoft.Practices.EnterpriseLibrary.Logging.Database, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"
        traceOutputOptions ="None"  type ="Microsoft.Practices.EnterpriseLibrary.Logging.Database.FormattedDatabaseTraceListener, Microsoft.Practices.EnterpriseLibrary.Logging.Database, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"
        name ="Database Trace Listener"   />
     </ listeners >
     < formatters >
       < add  template ="Timestamp: {timestamp} Message: {message} Category: {category} Priority: {priority} EventId: {eventid} Severity: {severity} Title:{title} Machine: {machine} Application Domain: {appDomain} Process Id: {processId} Process Name: {processName} Win32 Thread Id: {win32ThreadId} Thread Name: {threadName} Extended Properties: {dictionary({key} - {value} )}"
        type ="Microsoft.Practices.EnterpriseLibrary.Logging.Formatters.TextFormatter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"
        name ="SHY520 Formatter"   />
     </ formatters >
     < logFilters >
       < add  categoryFilterMode ="AllowAllExceptDenied"  type ="Microsoft.Practices.EnterpriseLibrary.Logging.Filters.CategoryFilter, Microsoft.Practices.EnterpriseLibrary.Logging, Version=2.0.0.0, Culture=neutral, PublicKeyToken=null"
        name ="Category Filter"   />
     </ logFilters >
     < categorySources >
       < add  switchValue ="All"  name ="DataBase" >
         < listeners >
           < add  name ="Database Trace Listener"   />
         </ listeners >
       </ add >
       < add  switchValue ="All"  name ="General" >
         < listeners >
           < add  name ="SHY520 Listeners"   />
         </ listeners >
       </ add >
     </ categorySources >
     < specialSources >
       < allEvents  switchValue ="All"  name ="All Events"   />
       < notProcessed  switchValue ="All"  name ="Unprocessed Category"   />
       < errors  switchValue ="All"  name ="Logging Errors &amp; Warnings" >
         < listeners >
           < add  name ="Formatted EventLog TraceListener"   />
         </ listeners >
       </ errors >
     </ specialSources >
   </ loggingConfiguration >
   < dataConfiguration  defaultDatabase ="Connection String"   />
   < connectionStrings >
     < add  name ="Connection String"  connectionString ="Database=EnterpriseLibrary;Server=shy;Integrated Security=SSPI;uid=sa;pwd=;"
      providerName ="System.Data.SqlClient"   />
   </ connectionStrings >
</ configuration >

上面的工作做完之后，我们就可以在应用程序中添加代码，用于将日志写入数据库了，如下：

        [TestMethod]
         public   void  LogToDataBase()
         {
            LogEntry log = new LogEntry();
            //事件ID
            log.EventId = 2000;
            //日志优先级
            log.Priority = 2;
            log.Message = "Test Log Information To DataBase";

            //日志类别
            ICollection<string> coll = new List<string>();
            //设置类别为DataBase,这就确定了你的日志是写入到数据库的
            //因为DataBase这个类别中包含一个DataBase Trace Listener
            coll.Add("DataBase");
            
            log.Categories = coll;

            //添加额外信息
            Dictionary<string, object> dic = new Dictionary<string, object>();
            dic.Add("name", "SHY520");
            dic.Add("sex","男");
            dic.Add("age", "22");

            log.ExtendedProperties = dic;
            //写入日志
            Logger.Write(log);
        }

运行这个测试方法，然后到数据库中看一下，此时上面的一条日志信息已经写入到数据库中了，关于利用Logging Application Block写日志到数据库中的方法就说到这里，如有遗漏，错误的地方，欢迎您指正！