Enterprise Library 2.0 -- Logging Application Block (上)

   Enterprise Library 2.0 中的 Logging Application Block 在1.0版本中是Logging and Instrumentation Application Block，因为把重点放在了日志记录上，所以改名为Logging Application Block。Logging Application Block提供了统一的日志记录功能，它支持将日志写入到多种目的地中，比如：1、数据库；2、文本文件；3、Email；4、消息队列；5、WMI event；6、事件日志；7、自定义区域(For Example:XML File)等等。
   Logging Application Block 提供了统一的接口用于将日志写入到任何指定的目的地，我们不需要在代码中指定日志信息该写到什么地方，而是在配置文件中设定我们什么情况

下写日志以及将日志信息写到什么地方，这也就意味着操作员可以和我们开发人员一样不通过修改代码来改变日志记录行为。它对于我们程序开发有以下几点好处：
1、可以使我们的应用程序中的日志记录方法保持一致；
2、正是因为它提供一致的结构模型，很大程度上方便了我们开发人员对其的学习；
3、很好的解决了应用程序中的日志问题；
4、可扩展，我们可以自定义日志信息的过滤程序以及格式化日志信息的程序
... ...

   相对于上一个版本，Logging Application Block 2.0作出了下列改变：
1、LogEntry对象现在可以属于一个或多个类别(category);
2、2.0版本中我们可以自定义过滤器，在Logging Application Block 将日志信息发送给监听器(trace listeners)之前就将该信息过滤掉，过滤器支持我们根据事件的类别和(或)优先级来过滤事件，我们可以定制符合自己需要的标准的过滤器来过滤事件；
3、你可以在代码中通过查询过滤器来判断当前事件是否需要被记录日志，这样就大大减少了我们日志记录量，可以有效的提高应用程序的性能。

   下面我们就来说一下Logging Application Block的使用方法，首先需要添加对下面三个程序集的引用：

using Microsoft.Practices.EnterpriseLibrary.Logging;
using Microsoft.Practices.EnterpriseLibrary.Logging.ExtraInformation;
using Microsoft.Practices.EnterpriseLibrary.Logging.Filters;

       和前面几个Block一样，在使用之前还是先说一下配置方法，首先用配置工具代开我们程序的App.Config/Web.Config,然后选中Application右键,New-->Logging Application Block,如下图：


这时你会发现，在新建的Logging Application Block节点下自动出现了Filters,Category Source,Special Source,Trace Listeners,Formatters这样的几个节点，如下：

      我下面按照我配置的顺序来说一下每个节点的作用，首先是Formatters，它用于指定日志信息的格式，如下图，我们在Formatters节点下创建一个Text Formatter,如下：


然后我们可以编辑它的模板，编辑我们要显示的信息，如下：



我们还可以配置Binary Formatter和自定义的Formatter ，这里不在多说了。

       Formatter配置好了以后，我们就可以来配置Trace Listeners了，Enterprise Library 2.0 提供了七种Trace Listeners，分别用于将日志信息记录到特定的目的地中，下面我们就来配置一个Flat File Trace Listener ，如下：



        使用Flat File Trace Listener后，记录的日志信息就输出到指定的文本文件中，所以我们要指定输出的文本文件的路径，默认在Bin/Debug目录下；同时我们需指定该Listener的Formatter，Name等属性。如果我们配置的是一个DataBase Listener，我们则要在数据库中建立相应的表，并创建一个用于插入日志信息的存储过程。


Trace Listeners 配置好之后就可以开始配置Category Source，我们新建一个Category Source，命名为General,指定其SourceLevel为All，如下：



之后，我们可以对刚添加的Category Source添加一个或多个Trace Listener，本文中，我们将上面配置的SHY52O Formatter加进来，


         如上图，在RefrenceTraceListener中选择SHY520 Listeners就可以了。
         最后我们来看一下如何配置过滤器(Filters),Enterprise Library 2.0 中提供了三种默认的Filters，分别是：Category Filter ，Log Enable Filter和Priority Filter，我们以Category Filter为例来配置：


然后可以修改过滤器名称和过滤规则：



这里面我们可以选择过滤的模式，过滤模式有两种：
1、Allow All Categories Except those explicitly denied below
2、Deny All Categories Except those explicitly allowed below

根据我们需要选择好过滤模式，然后添加需要过滤的类别，点击OK按钮即可完成Category Filter的配置。

        关于Logging Application Block 的介绍和配置部分就说到这里，下一篇我们在来介绍Logging Application Block的使用方法以及自定义Formatter和Listener的方法。

如有疏忽错误的地方，欢迎指正！希望能对初学者有所帮助，并希望能和大家一起交流！

Email:pwei013@163.com