ADO.NET Entity Framework 如何输出日志到 log4net (EF, Log4net)

 

EF团队推出了一套比较完整的缓存和SQL执行日志的解决方案，EFProviderWrappers。他们的做法是在原来的EF Provider之上，再加一层包装，通过这层包装拦截，进行数据缓存和日志监控。这里缓存的数据是数据库查询后返回的原生数据，并不是Entity实体对象，这样就可以避免Entity实体状态对缓存造成的的极端负面影响。并且这样的缓存对上层的数据查询本身是透明，在同一个封闭区间内，缓存数据所依赖的实体类型在被更新后（对应的表有发生CURD操作），缓存并会被自动清空。对于日志的监控，经过这层包装后就可以非常容易得到处理。大家可以从前面的链接下载到原代码，需要自己编译使用。

简单介绍下使用方法：
1. 下载源码编译，添加引用：
(1) EFProviderWrapperToolkit.dll
(2) EFTracingProvider.dll (用于输出sql)

(3) EFCachingProvider.dll (用于缓存)

2. 从生成的ObjectContext中继承一个扩展的ObjectContext，定义所需的扩展属性，其中重点是重新定义构造器，生成包装后的EntityConnection对象。
注意：
(1) name=NORTHWNDEntities 这里的"NORTHWNDEntities" 是生成EF在app.config 或者 web.config 中对应的connectionstring 的名称。
(2) "EFTracingProvider","EFCachingProvider" 如果哪一个没有使用，可以把对应的那个字符串删除。

[c-sharp] view plaincopyprint?
  1. public ExtendedNorthwindEntities()
  2. : this("name=NorthwindEntities")
  3. {
  4. }
  5. public ExtendedNorthwindEntities(string connectionString)
  6. : base(EntityConnectionWrapperUtils.CreateEntityConnectionWithWrappers(
  7. connectionString,
  8. "EFTracingProvider",
  9. "EFCachingProvider"
  10. ))
  11. {
  12. }


3. 在应用程序中注册Provider：
(1) 如果是Winform应用，可以在应用启动时调用下面两句代码，进行注册。
[c-sharp] view plaincopyprint?
  1. EFTracingProviderConfiguration.RegisterProvider();
  2. EFCachingProviderConfiguration.RegisterProvider();

(2) 如果是Web应用，需要在 web.config 里追加如下配置：(和 system.web 节点平级)
[xhtml] view plaincopyprint?
  1. <system.data>
  2. <DbProviderFactories>
  3. <add name="EF Caching Data Provider" invariant="EFCachingProvider" description="Caching Provider Wrapper" type="EFCachingProvider.EFCachingProviderFactory, EFCachingProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=def642f226e0e59b" />
  4. <add name="EF Tracing Data Provider" invariant="EFTracingProvider" description="Tracing Provider Wrapper" type="EFTracingProvider.EFTracingProviderFactory, EFTracingProvider, Version=1.0.0.0, Culture=neutral, PublicKeyToken=def642f226e0e59b" />
  5. <add name="EF Generic Provider Wrapper" invariant="EFProviderWrapper" description="Generic Provider Wrapper" type="EFProviderWrapperToolkit.EFProviderWrapperFactory, EFProviderWrapperToolkit, Version=1.0.0.0, Culture=neutral, PublicKeyToken=def642f226e0e59b" />
  6. </DbProviderFactories>
  7. </system.data>


如何追加 Log4net 的输出：
按照上面的步骤，在ObjectContext的扩展类中，追加了一些代码，详细看代码中的注释：
[c-sharp] view plaincopyprint?
  1. public partial class ExtendedNorthwindEntities : NORTHWNDEntities
  2. {
  3. private static ILog logger;
  4. static ExtendedNorthwindEntities()
  5. {
  6. // 注册TracingProvider
  7. EFTracingProviderConfiguration.RegisterProvider();
  8. // 初始化Log4net,配置在独立的"log4net.config"中配置
  9. log4net.Config.XmlConfigurator.Configure(new FileInfo("log4net.config"));
  10. // 初始化一个logger
  11. logger = log4net.LogManager.GetLogger("EFLog4net");
  12. }
  13. public ExtendedNorthwindEntities()
  14. : this("name=NORTHWNDEntities")
  15. {
  16. // 绑定 EFTracingConnection 的 CommandExecuting 事件，输出log
  17. this.UnwrapConnection<EFTracingConnection>().CommandExecuting += (s, e) =>
  18. {
  19. // 输出 TraceString (SQL文)
  20. logger.Debug(Environment.NewLine + e.ToTraceString().TrimEnd());
  21. };
  22. }
  23. public ExtendedNorthwindEntities(string connectionString)
  24. : base(EntityConnectionWrapperUtils.CreateEntityConnectionWithWrappers(
  25. connectionString,
  26. "EFTracingProvider"
  27. ))
  28. {
  29. }

log4net.config 的配置如下：(关于log4net的其他详细配置说明，参考http://logging.apache.org/log4net/release/config-examples.html)
[c-sharp] view plaincopyprint?
  1. <?xml version="1.0" encoding="utf-8" ?>
  2. <configuration>
  3. <log4net>
  4. <root>
  5. <level value="ALL" />
  6. <appender-ref ref="rollingFileAppender" />
  7. <appender-ref ref="consoleAppender" />
  8. </root>
  9. <appender name="rollingFileAppender" type="log4net.Appender.RollingFileAppender,log4net" >
  10. <param name="File" value="http://www.cnblogs.com/logs/EFLogs.txt" />
  11. <param name="AppendToFile" value="true" />
  12. <param name="RollingStyle" value="Date" />
  13. <param name="DatePattern" value="yyyy.MM.dd" />
  14. <param name="StaticLogFileName" value="true" />
  15. <layout type="log4net.Layout.PatternLayout,log4net">
  16. <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" />
  17. </layout>
  18. </appender>
  19. <appender name="consoleAppender" type="log4net.Appender.ColoredConsoleAppender,log4net">
  20. <mapping>
  21. <level value="DEBUG" />
  22. <!--<foreColor value="White" />-->
  23. <backColor value="Cyan, HighIntensity" />
  24. </mapping>
  25. <layout type="log4net.Layout.PatternLayout,log4net">
  26. <param name="ConversionPattern" value="%d [%t] [%-5p] %c - %m%n" />
  27. </layout>
  28. </appender>
  29. </log4net>
  30. </configuration>


这样在应用程序中，就可以通过log4net的配置文件控制 EF 生成的sql的输出了。上面的log4net里配置了两个Appender一个是输出到Console，一个输出到 EFLogs.txt 里。
下面调用一下 EF, 看看输出的 log：
[c-sharp] view plaincopyprint?
  1. static void Main(string[] args)
  2. {
  3. using (var db = new ExtendedNorthwindEntities())
  4. {
  5. var toyproducts = from p in db.Products
  6. where p.Category.CategoryName.Contains("Seafood")
  7. select new { p.Category.CategoryName, p.ProductName, p.UnitPrice };
  8. Console.WriteLine("-----------------");
  9. foreach (var p in toyproducts)
  10. Console.WriteLine("{0,-10} {1,-35} {2,10}", p.CategoryName, p.ProductName, p.UnitPrice);
  11. }
  12. Console.Read();
  13. }


 

 

上面蓝色背景的输出就是通过log4net配置输出的sql log。另外，这个 EFProviderWrappers 不仅仅提供让我们输出log这些功能，还有很重要的功能就它的缓存，下一篇文章里我将重点介绍如何使用 EFProviderWrappers 实现数据缓存。

 posted on 2012-03-13 14:06  王育东  阅读(1013)  评论(7)  编辑  收藏  举报