使用ASP.NET MVC操作过滤器记录日志

摘要:日志记录是一种常见的交错关注点(Cross-Cutting Concern),很多ASP.NET开发者会在Global.asax文件中处理它。由于MVC是构建在ASP.NET之上的,所以你可以使用同样的解 决方式,但还有更好的方法。这篇文章向你展示了使用ASP.NET MVC的操作过滤器来向Web应用程序中添加日志是多么简单。

 

Logging is a common Cross-Cutting Concern that many ASP.NET developers solve in the Global.asax file. Because MVC is built on top of ASP.NET you could tap into the same solution, but there is a better way. This article will show how easy it is to add logging to your web app using ASP.NET MVC Action Filters.

日志记录是一种常见的交错关注点,很多ASP.NET开发者会在Global.asax文件中处理它。由于MVC是构建在ASP.NET之上的,所以你可以使用同样的解决方式,但还有更好的方法。这篇文章向你展示了使用ASP.NET MVC的操作过滤器来向Web应用程序中添加日志是多么简单。

Action Filters give you the ability to run custom code before or after an action (or page) is hit. Applying action filters to your MVC app is simple because they are implemented as attributes that can be placed on a method (an individual Action), or a class (the entire Controller).

操作过滤器使得你可以在操作(或页面)执行之前和之后运行自定义代码。在MVC应用程序中使用操作过滤器很简单,因为它们是通过特性实现的,可以放置在方法(一个单独的操作)或类(整个控制器)前面。

To show how easy this is, we're going to take the out-of-the-box ASP.NET MVC template, and very slightly tweak it to begin logging. We'll add one class (our custom Action Filter), and salt the existing pages with our new "LogRequest" attribute.

为了看到这有多简单,我们使用了开箱即用的ASP.NET MVC模板,对其进行少许调整就可以开始记录日志了。我们将会添加一个类(自定义的操作过滤器),并用这个新的"LogRequest"特性来“调制”现有的页面。

Creating a Custom Action Filter
创建自定义操作过滤器

To create your own action filter, you simply have to
inherit from the base "ActionFilterAttribute" class that's already a
part of the MVC framework. To make this easier on myself, I've also
implemented the IActionFilter interface so that Visual Studio can
auto-generate my two methods for me.

要创建自己的操作过滤器,只需要简单地继承ActionFilterAttribute基类,该类是MVC框架的一部分。我为了更方便一些,还实现了IActionFilter接口,这样Visual Studio就会自动为我生成两个方法。

At this point, my custom action filter looks like this:

这时,我的自定义操作过滤器看起来是这样的:

  1. public class LogsRequestsAttribute : ActionFilterAttribute, IActionFilter
  2. {
  3. void IActionFilter.OnActionExecuted(ActionExecutedContext filterContext)
  4. {
  5. // I need to do something here...
  6. }
  7. void IActionFilter.OnActionExecuting(ActionExecutingContext filterContext)
  8. {
  9. // I need to do something here...
  10. }
  11. }

The ActionFilterAttribute and IActionFilter interface comes from the System.Web.Mvc namespace.

ActionFilterAttribute和IActionFilter接口来自System.Web.Mvc命名空间。

It's important to remember that this article was
written (and the sample app was compiled) for ASP.NET MVC Preview 4.
When the beta and release is eventually out, specifics of the article
may not be 100% relevant. However, this capability should remain the
same.

要记得本文(和文中的示例程序)是针对ASP.NET MVC Preview 4编写的。当beta和release版发布后,文章的细节可能不是100%有效的。不过,这一功能还是相同的。

Applying Our Custom Action Filter
应用自定义操作过滤器

Now that we have created our action filter, we need to
apply it to our Controllers or optionally, to our Actions. Because
logging is something that you would likely want on all of your "pages",
we'll simply add it at the controller level. Here is what we've added to
the two existing controllers that were supplied in the ASP.NET MVC
template.

现在我们已经创建好操作过滤器了,我们需要将其应用到控制器上,或者有选择地应用在操作上。因为你可能希望对所有的“页面”进行日志记录,我们简单地将其添加到控制器级别上。在这里我们将其添加到ASP.NET MVC模板提供的两个控制器上。

  1. // HandleError was already there...
  2. [HandleError]
  3. [LogRequest]
  4. public class HomeController : Controller
  5. {
  6. ...
  7. }
  8. // HandleError was already there...
  9. [HandleError]
  10. [LogRequest]
  11. public class AccountController : Controller
  12. {
  13. ...
  14. }

That's it! The ASP.NET MVC framework will
automatically call our methods (OnActionExecuting and then
OnActionExecuted) when a request comes in to any of those two
controllers.

就是这样!当一个请求进入这两个控制器时,ASP.NET MVC框架会自动调用我们的方法(先是OnActionExecuting,然后是OnActionExecuted)。

At this point, all we have to do is actually implement
our logging code. Because I want to be able to easily report against my
site's activity, I'm going to log to a SQL database. Now, it's
important to note that action filters are executed synchronously (for
obvious reasons), but I don't want the user to have to wait for my
logging to happen before he can enjoy my great site. So, I'm going to
use the fire and forget design pattern.

此时,我们必须要真正实现日志记录代码了。由于我希望能简单地报告站点的活动,所以我将日志记录在SQL数据库中。要注意,操作过滤器是同步执行的(原因很明显),但我可不想让用户在访问我的牛逼的站点之前还要等着记录日志。因此,我将使用fire and forget设计模式。

When we're all done, this is what our logger will look like:

搞定所有这些之后,我们的日志记录看起来就是这样了:

  1. // By the way, I'm using the Entity Framework for fun.
  2. public class LogRequestAttribute : ActionFilterAttribute, IActionFilter
  3. {
  4. private static LoggerDataStoreEntities DataStore = new LoggerDataStoreEntities();
  5. void IActionFilter.OnActionExecuting(ActionExecutingContext filterContext)
  6. {
  7. ThreadPool.QueueUserWorkItem(delegate
  8. {
  9. DataStore.AddToSiteLog(new SiteLog
  10. {
  11. Action = filterContext.ActionMethod.Name,
  12. Controller = filterContext.Controller.ToString(),
  13. TimeStamp = filterContext.HttpContext.Timestamp,
  14. IPAddress = filterContext.HttpContext.Request.UserHostAddress,
  15. });
  16. DataStore.SaveChanges();
  17. });
  18. }
  19. }

Conclusion
小结

There are a lot of features in MVC that could each
merrit their own articles, but Action Filters are definately one feature
that shows off the advantages of the MVC design pattern. Action Filters
make perfect sense for cross-cutting concerns like logging, but you can
get creative with how and why you use them.

MVC中有太多的特性,每种都能单独写成文章,但操作过滤器最能炫耀MVC设计模式的特性。操作过滤器对交错关注点有着异同寻常的意义,但如何以及为什么使用它们,就需要你发挥创造力了。

This article isn't here to show you the best way to do
logging, but rather how and why you would use ASP.NET MVC Action
Filters. Here's the source code, play around with it: MVC_CustomActionFilter_Logging.zip

这篇文章并没有介绍记录日志最好的方法,而是给出了如何以及为什么使用ASP.NET MVC操作过滤器。

使用ASP.NET MVC操作过滤器记录日志(转)的更多相关文章

  1. [翻译] 使用ASP.NET MVC操作过滤器记录日志

    [翻译] 使用ASP.NET MVC操作过滤器记录日志 原文地址:http://www.singingeels.com/Articles/Logging_with_ASPNET_MVC_Action_ ...

  2. ASP.NET MVC : Action过滤器(Filtering)

    http://www.cnblogs.com/QLeelulu/archive/2008/03/21/1117092.html ASP.NET MVC : Action过滤器(Filtering) 相 ...

  3. Asp.net MVC 权限过滤器实现方法的最佳实践

    在项目开发中,为了安全.方便地判断用户是否有访问当前资源(Action)的权限,我们一般通过全局过滤器来实现. Asp.net MVC 页面中常见的权限判断使用过滤器主要在以下几种情况(根据权限判断的 ...

  4. ASP.NET MVC 系统过滤器、自定义过滤器

    一.系统过滤器使用说明 1.OutputCache过滤器 OutputCache过滤器用于缓存你查询结果,这样可以提高用户体验,也可以减少查询次数.它有以下属性: Duration:缓存的时间,以秒为 ...

  5. ASP.NET MVC动作过滤器

    ASP.NET MVC提供了4种不同的动作过滤器(Aciton Filter). 1.Authorization Filter 在执行任何Filter或Action之前被执行,用于身份验证 2.Act ...

  6. Asp.net MVC 之过滤器

    整理一下MVC中的几种过滤器,以及每种过滤器是干什么用的 四种过滤器 1.AuthorizationFilter(授权过滤器) 2.ActionFilter(方法过滤器) 3.ResultFilter ...

  7. ASP.NET MVC 使用 Log4net 记录日志

    Log4net 介绍 Log4net 是 Apache 下一个开放源码的项目,它是Log4j 的一个克隆版.我们可以控制日志信息的输出目的地.Log4net中定义了多种日志信息输出模式.它可以根据需要 ...

  8. Asp.Net MVC在过滤器中使用模型绑定

    废话不多话,直接上代码 1.创建MVC项目,新建一个过滤器类以及使用到的实体类: public class DemoFiltersAttribute : AuthorizeAttribute { pu ...

  9. asp.net mvc 利用过滤器进行网站Meta设置

    过去几年都是用asp.net webform进行开发东西,最近听说过时了,同时webform会产生ViewState(虽然我已经不用ruanat=server的控件好久了 :)),对企业应用无所谓,但 ...

随机推荐

  1. iOS的架构

    根据多年的iOS开发经验,常用的iOS开发架构有:MVC.MVVM.CDD等,在这里我就不一一列举了. 做一个项目一般首先要搭建主流框架界面:常见的有TabBar控制器可以切换子控制器,上面又有Nav ...

  2. selenium--环境搭建步骤

    1.安装Python 2.安装setuptools 3.安装pip(Python3.X自带pip) 4.安装selenium(步骤在另一个博客中已提及)

  3. git 实用操作

    查看某文件的某些行的变化历史: $ git log --pretty=short -u -L 2003,2005:Executor.cpp http://stackoverflow.com/quest ...

  4. eclipse的安装与配置

    eclipse的英文名是日蚀,一直很喜欢这个名字. 1.安装很简单,直接下载eclipse包,免安装的.解压后找到其执行文件,如图所示.

  5. 【转】oracle 监听静态注册举例解析

    网上有很多关于oracle 监听静态注册的文章,但大多都是简单说说,并没有详细的例子,这里,将结合linux as3 下的oracle 10gR2.0.1 举一个具体的例子 1.在 $ORACLE_H ...

  6. Python 9X9乘法口诀表

    #乘法口诀 for i in range(1,10): for j in range(1,i+1): print ( j,'*',i,'=',j*i,'',' ',end='') print(end= ...

  7. 20151208Study

    20151208-----------------------------------------------------* Her main interest now is raising her ...

  8. Ceph剖析:定时器safetimer的实现

    定时器的作用是在指定的时间执行指定的动作.SafeTimer通过multimap数据结构维护定时项,定时项是时间和事件的Pair,定时项在map中按照定时时间从小到大排列.此外,SafeTimer使用 ...

  9. android Activity类中的finish()、onDestory()和System.exit(0) 三者的区别

    android Activity类中的finish().onDestory()和System.exit(0) 三者的区别 Activity.finish() Call this when your a ...

  10. 20145226夏艺华 《Java程序设计》第0周学习总结

    关于师生关系: 学生和老师之间我觉得关系时多元化的,不能拘泥于单独的一种关系:灌输与被灌输,教授与被教授--我认为,在不同的课程阶段,师生之间的关系都可以发生变化.前期的老师更像是一个指路的人,而在入 ...