supegong  
转mvc3

摘要
      本文将从完成“输入数据验证”这个功能出发，逐渐展开ASP.NET MVC与Ajax结合的方法。首先，本文将使用ASP.NET MVC提供的同步方式完成数据验证。而后，将分别结合ASP.NET AJAX和JQuery将这个功能重构成异步形式。

数据验证
      在上一篇文章中，我们完成了发布公告的功能。但是从健壮性角度看，这个功能并不完善，因为一般情况下，我们输入的数据要符合一定的约束条件，例如，在我们的例子中，我们至少不能将空字符串作为标题或内容吧。下面，我们来为程序加入数据验证功能，
      ASP.NET MVC中提供了良好的数据验证实现支持，下面我们来看实现过程。首先，我们要修改一下Release.aspx视图，修改后的视图如下。
Release.aspx:

 1<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Release.aspx.cs" Inherits="MVCDemo.Views.Announce.Release" %>
 2<%@ Import Namespace="MVCDemo.Models.Entities" %>
 3
 4<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 5
 6<html xmlns="http://www.w3.org/1999/xhtml" >
 7<head runat="server">
 8    <title></title>
 9</head>
10<body>
11    <% SelectList categories = ViewData["Categories"] as SelectList; %>
12    <div>
13        <h1>MVC公告发布系统——发布公告</h1>
14        <% Html.BeginForm("DoRelease","Announce",FormMethod.Post); %>
15        <dl>
16            <dt>标题：</dt>
17            <dd><%= Html.TextBox("Title") %></dd>
18            <dd><%= Html.ValidationMessage("TitleValidator") %></dd>
19            <dt>分类：</dt>
20            <dd><%= Html.DropDownList("Category",categories) %></dd>
21            <dd></dd>
22            <dt>内容：</dt>
23            <dd><%= Html.TextArea("Content") %></dd>
24            <dd><%= Html.ValidationMessage("ContentValidator") %></dd>
25        </dl>
26        <input type="submit" value="发布" />
27        <% Html.EndForm(); %>
28    </div>
29</body>
30</html>


      可以看到，并没有什么大的变动，只是多了两个Html.ValidationMessage方法。可以这样理解，这个方法相当于产生一个span标签，而这个span就是要显示错误信息的地方。这个方法接收一个参数，用来指明其在Controller中的名字。如果你对这个迷惑，不要紧，接下来看完Controller的代码，你就什么都清楚了。
AnnounceController.cs:

 1using System;
 2using System.Collections.Generic;
 3using System.Linq;
 4using System.Web;
 5using System.Web.Mvc;
 6using System.Web.Mvc.Ajax;
 7using MVCDemo.Models;
 8using MVCDemo.Models.Interfaces;
 9using MVCDemo.Models.Entities;
10
11namespace MVCDemo.Controllers
12{
13    public class AnnounceController : Controller
14    {
15        public ActionResult Release()
16        {
17            ICategoryService cServ = ServiceBuilder.BuildCategoryService();
18            List<CategoryInfo> categories = cServ.GetAll();
19            ViewData["Categories"] = new SelectList(categories, "ID", "Name");
20            return View("Release");
21        }
22
23        public ActionResult DoRelease()
24        {
25            if (String.IsNullOrEmpty(Request.Form["Title"]) || String.IsNullOrEmpty(Request.Form["Content"]))
26            {
27                if (String.IsNullOrEmpty(Request.Form["Title"]))
28                {
29                    ViewData.ModelState.AddModelError("TitleValidator","公告标题不能为空！");
30                }
31                if (String.IsNullOrEmpty(Request.Form["Content"]))
32                {
33                    ViewData.ModelState.AddModelError("ContentValidator", "公告内容不能为空！");
34                }
35
36                return Release();
37            }
38
39            AnnounceInfo announce = new AnnounceInfo()
40            {
41                ID = 1,
42                Title = Request.Form["Title"],
43                Category = Int32.Parse(Request.Form["Category"]),
44                Content = Request.Form["Content"],
45            };
46
47            IAnnounceService aServ = ServiceBuilder.BuildAnnounceService();
48            aServ.Release(announce);
49
50            ViewData["Announce"] = announce;
51            return View("ReleaseSucceed");
52        }
53    }
54}


      可以看到，我们的DoRelease这个Action方法多了不少东西。我们看多了什么：当从表单传递过来的标题或内容为空时，我们做了一定处理。注意，这个ViewData.ModelState.AddModelError方法，它就是往我们刚才说的由Html.ValidationMessage生成的span里加入错误信息的方法，它可以有两个参数，第一个指明哪个span，这个参数Html.ValidationMessage中的参数是对应的。第二个参数就是要显示的信息。
      相信结合视图和控制器，已经很好理解了。最后，如果标题或内容有空值的话，我们不再调用业务逻辑组件处理了，而是调用了Release这个Action。为什么我们不用Redirect呢？因为我们要保持ViewData中的数据，刚才我们的错误信息可都放在里面的，而使用了Redirect，ViewData的信息就传不过去了。
      现在，我们再来发布公告。我们故意什么都不填，提交，看结果：

 
      没有问题，我们的程序成功对标题和内容进行了完整性检测（这里就是均不能为空），在验证不通过时，返回了发布公告视图并正确显示了错误提示信息。
      也许你有一个疑问，为什么第一次请求Release视图时没有显示任何错误信息呢？因为那时ViewData中的ModelError是空的。而Html.ValidationMessage生成的标签会自动寻找ModelError中同名的错误信息，找不到，当然是空的了。而在提交空信息时，DoRelease这个Action为ViewData的ModelError添加了内容，于是当再次返回Release视图时，相应信息就显示在我们指定的位置了。

使用ASP.NET AJAX实现客户端数据验证
      上面的代码运行起来没问题，也达到了我们的要求。但是验证标题内容是否为空这种行为在客户端应该就可以完成。当然，为了放置恶意攻击或浏览器将JavaScript屏蔽的情况，我们应该在后台进行验证，但是我们不能每次都将这种请求发到后台去验证，这太费资源了，毕竟恶意攻击者和JavaScript被屏蔽的浏览器只是少数。所以，在数据被送到后台前，我们应该先进行一遍验证，这样可以节约很多资源。
      下面，我们使用ASP.NET AJAX框架完成客户端的数据验证。
      说实话，在ASP.NET MVC中使用ASP.NET AJAX或JQuery实在太方便了，不信你展开Scripts文件夹，看到没，微软已经把这些库放到里面了，所以，我们要做的只是直接引用。看我们修改后的Release.aspx。
Release.aspx:
 1<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Release.aspx.cs" Inherits="MVCDemo.Views.Announce.Release" %>
 2<%@ Import Namespace="MVCDemo.Models.Entities" %>
 3
 4<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 5
 6<html xmlns="http://www.w3.org/1999/xhtml" >
 7<head runat="server">
 8    <title></title>
 9    <script type="text/javascript" src="<%= Url.Content("~/Scripts/MicrosoftAjax.debug.js") %>"></script>
10    <script type="text/javascript" src="<%= Url.Content("~/Scripts/MicrosoftAjaxValidate.js") %>"></script>
11</head>
12<body>
13    <% SelectList categories = ViewData["Categories"] as SelectList; %>
14    <div>
15        <h1>MVC公告发布系统——发布公告</h1>
16        <% Html.BeginForm("DoRelease","Announce",FormMethod.Post); %>
17        <dl>
18            <dt>标题：</dt>
19            <dd><%= Html.TextBox("Title") %></dd>
20            <dd><span id="TitleValidator"></span></dd>
21            <dt>分类：</dt>
22            <dd><%= Html.DropDownList("Category",categories) %></dd>
23            <dd></dd>
24            <dt>内容：</dt>
25            <dd><%= Html.TextArea("Content") %></dd>
26            <dd><span id="ContentValidator"></span></dd>
27        </dl>
28        <input id="Submit" type="submit" value="发布" />
29        <% Html.EndForm(); %>
30    </div>
31</body>
32</html>

      改动有两处，首先我们在页头引用了两个js文件，第一个是ASP.NET AJAX的库文件，第二个就是我们一会要实现的包含验证代码的js文件了。你可能注意到那个Url.Content了，Url是ViewPage的一个对象，它最常用的一个方法就是Content，它的功能是返回某个文件的路径。一般情况下，在使用了ASP.NET MVC后，目录结构变得有点诡异，像js、css、图片等与路径（即使是相对路径）引用相关的地方可能会出现问题，但是，只要你在这些地方用Url.Content生成路径，而不是直接将路径写在页面里，一般就没什么问题了。所以，凡是引用js、css、图片等除，请一定使用Url.Content生成路径，其参数只有一个，就是文件原始的相对路径。
      下一个改动就是显示错误信息的span不再是Html.ValidationMessage生成的了，而是普通的span。
      下面我们在Scripts目录下新建MicrosoftAjaxValidate.js文件。
MicrosoftAjaxValidate.js:
 1Sys.Application.add_init(onPageInit);
 2
 3function onPageInit() {
 4    $addHandler($get("Submit"), "click", validate);
 5}
 6
 7function validate() {
 8    if ($get("Title").value == "" || $get("Content").value == "") {
 9        if ($get("Title").value == "") {
10            $get("TitleValidator").innerHTML = "标题不能为空！";
11        }
12        if ($get("Content").value == "") {
13            $get("ContentValidator").innerHTML = "内容不能为空！";
14        }
15
16        return false;
17    }
18
19    return true;
20}

      关于这段代码我不多说了，对ASP.NET AJAX有兴趣的可以参看《ASP.NET AJAX客户端编程之旅》系列文章。
      现在运行，将标题和内容留空，提交。OK！效果和刚才很像，只不过这次是在客户端验证了，并没有提交到服务器端。

整合JQuery
      下面我们再使用JQuery实现这个功能。
      其实看懂上面的实现后，我想你已经想到怎么整合JQuery了，无非也是引入相应库和js文件，然后使用JQuery编写验证代码。修改后的Release.aspx就没必要看了，无非是引入Scripts目录下的JQuery库，然后再引入一个自定义验证js文件，我们姑且叫JQueryValidate.js吧。
      下面在Scripts目录下新建JQueryValidate.js，代码如下。
JQueryValidate.js:
 1$(document).ready(function(){
 2    $("#Submit").click(function() {
 3        if ($("#Title").attr("value") == "" || $("#Content").attr("value") == "") {
 4            if ($("#Title").attr("value") == "") {
 5                $("#TitleValidator").attr("innerHTML", "标题不能为空！");
 6            }
 7            if ($("#Content").attr("value") == "") {
 8                $("#ContentValidator").attr("innerHTML", "内容不能为空！");
 9            }
10
11            return false;
12        }
13
14        return true;
15    }
16    );
17}
18);


小结
      从本文可以看出，在MVC框架中整合Ajax和普通应用差别不大，唯一就是注意在引用外部js时使用Url.Content方法处理一下相对路径。其实在本文中我们并没有使用到Ajax，而仅仅是整合了JavaScirpt，但是这已经足够了，因为Ajax无非就是在这些JavaScript里包含了异步后台调用。
      其实，ASP.NET MVC有专门针对ASP.NET AJAX的扩展，放在MicrosoftMvcAjax.js里。而在ViewPage里有个叫Ajax的AjaxHelper对象，可以实现一些简单的异步调用。但是这个扩展的功能很有限，有兴趣的可以自己研究一下。我个人还是建议大家自己写JS代码，当然可以使用ASP.NET AJAX或JQeury这样优秀的框架。
      这篇文章先到这里，下一篇中我们讨论一下拦截器的使用。^_^

 

摘要
      本文将对“MVC公告发布系统”的发布公告功能添加日志功能和异常处理功能，借此来讨论ASP.NET MVC中拦截器的使用方法。

一个小难题
      我们继续完善“MVC公告发布系统”，这次，我们的需求是对公告发布功能添加日志记录能力，即在发布公告前，记录一次，在公告发布成功后，再记录一次。然后还要使得其具备异常处理，即当业务组件出现问题时，跳转到相应的错误页面并显示相应提示。
      有人可能笑了，这有什么难的，在DoRelease这个Action的开始和结束处各加入相应日志功能不久结了。异常处理更不在话下，直接try...catch搞定。
      没错，以上方法确实行得通，但是存在以下两点问题:
      1.代码重复问题。很多日志处理代码和异常处理代码是很相似的，这样就导致了各个Action中存在大量重复代码。
      2.职责被破坏。不要忘了，我们的Controller仅仅是控制器，它应该只负责表示逻辑，而不应该被一大堆日志处理代码和try...catch块包围。我们要的Action，应该是干净的、工整的、仅包含表示逻辑的Action。
      以上两点，造成了我们系统中的坏味代码。那么，怎么解决这个问题呢？

从厨师到AOP
      先来想象一个场景：饭店里的高级厨师怎么工作？我们知道，他不用洗菜切菜、不用端着盘子送菜、如果发现手里牛肉变质了他更不用拿着牛肉去找肉店老板理论，他的工作很单一：炒菜。
      当原料送来后，有专门的顺菜切菜工进行洗菜、切菜，然后把处理好的菜送给厨师，厨师只管下锅炒，炒完了送菜自然也不必关心，因为有专门的服务员负责这事。如果发现牛肉变质了，它只管说一声，自然有相应的人处理这事。
      这个场景就是典型的AOP（面向切面编程）。厨师可以看成是业务组件，它有个方法就是“炒菜”，但是炒菜前要切菜，炒完了要有人送菜，可这不是厨师该关心的事啊！于是我们的切菜工和服务员就相当于拦截器，其中切菜工在炒菜前拦截，进行切菜，服务员在炒菜后拦截，负责送菜。当然，我们还有个异常拦截器：处理问题的人，就是那个当厨师发现肉变质了喊一声，就来处理的人。
      基于这个场景，我们看看这样有什么好处。首先是厨师职责单一了，他可以专注于自己的工作：炒菜，而不必理会不该自己关心的问题。而且“拦截器们”可以复用的，例如一个抠门的老板完全可以找3个厨师但是只招一名服务员，反正一名服务员就可以给三名厨师端菜，这样，拦截器的复用使得代码重复不见了！

回来
      好的，现在回到我们的“MVC公告发布系统”。相信看了上面的场景，你的灵感一定来了：对啊，Action不就是厨师吗，如果我们可以将日志功能做成拦截器，在DoRelease执行前先拦截一次完成记录日志功能，DoRelease执行后再拦截一次记录一次日志。最好还有个拦截器，在Action发生异常的时候可以拦截处理（就像上文处理变质牛肉的人），不就搞定了吗。
      可是要怎么实现拦截Action呢？真是幸运之极，ASP.NET MVC框架中内置了这种机制！哈哈，我们赶快来做吧！

实现拦截器
      在ASP.NET MVC中，有三种拦截器：Action拦截器、Result拦截器和Exception拦截器。我要用到第一种和第三种。其实所谓的ASP.NET MVC拦截器，也没什么神秘的，就是一个普通的类而已。只不过需要继承FilterAttribute基类，Action拦截器还要实现IActionFilter接口，而Exception拦截器需要实现IExceptionFilter接口。
      我们先来看实现：让我们在Controllers目录下新建一个Filters目录，然后在Filters下新建两个类，一个叫LoggerFilter一个叫ExceptionFilter。首先是LoggerFilter的代码。
LoggerFilter.cs:

      另外，我们还要实现一个Error.aspx视图，这是在异常拦截器中定义的错误视图。我们将它新建在Views/Shared下就可以了。顺便说一下，共用的视图一般放在Shared下，因为ASP.NET MVC的视图寻找机理是当与Controller同名目录下不存在时，就到Shared下看看有没有此视图。
Error.aspx:

 

 1<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Error.aspx.cs" Inherits="MVCDemo.Views.Shared.Error" %>
 2
 3<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 4
 5<html xmlns="http://www.w3.org/1999/xhtml" >
 6<head runat="server">
 7    <title></title>
 8</head>
 9<body>
10    <div>
11        <h1>系统发生异常</h1>
12        <%= ViewData["ErrorMessage"] %>
13    </div>
14</body>
15</html>


      好了，现在我们再提交新公告，会返回如下结果：

 
      很明显，业务组件抛出了异常，但是我们的Action方法中并没有用try...catch处理，但是异常拦截器成功拦截了异常，并做了相应处理。
      我们再回过头看看，使用了拦截器后，代码是不是很清晰呢。

 1using System;
 2using System.Collections.Generic;
 3using System.Linq;
 4using System.Web;
 5using System.Web.Mvc;
 6using System.Web.Mvc.Ajax;
 7
 8namespace MVCDemo.Controllers.Filters
 9{
10    public class LoggerFilter : FilterAttribute, IActionFilter
11    {
12        void IActionFilter.OnActionExecuting(ActionExecutingContext filterContext)
13        {
14            filterContext.Controller.ViewData["ExecutingLogger"] = "正要添加公告，已以写入日志！时间：" + DateTime.Now; 
15        }
16
17        void IActionFilter.OnActionExecuted(ActionExecutedContext filterContext)
18        {
19            filterContext.Controller.ViewData["ExecutedLogger"] = "公告添加完成，已以写入日志！时间：" + DateTime.Now;
20        }
21    }
22}


      可以看到，这个类继承了FilterAttribute并实现了IActionFilter。其中关键是IActionFilter，它有两个方法，OnActionExecuting在被拦截Action前执行，OnActionExecuted在被拦截Action后执行。两个方法都有一个参数，虽然类型不同，但其实都是一个作用：被拦截Action的上下文。
      这个地方我得解释一下，你拦截器拦截了Action，在做处理时难免要用到被拦截Action相关的东西，例如在我们的例子中，就需要想被拦截Action所在Controller的ViewData中添加内容，所以，拦截器方法有一个参数表示被拦截Action的上下文是顺理成章的事。
      下面再看ExceptionFilter这个拦截器，它是在Action出现异常时发挥作用的。
ExceptionFilter.cs:

 1using System;
 2using System.Collections.Generic;
 3using System.Linq;
 4using System.Web;
 5using System.Web.Mvc;
 6using System.Web.Mvc.Ajax;
 7
 8namespace MVCDemo.Controllers.Filters
 9{
10    public class ExceptionFilter : FilterAttribute,IExceptionFilter
11    {
12        void IExceptionFilter.OnException(ExceptionContext filterContext)
13        {
14            filterContext.Controller.ViewData["ErrorMessage"] = filterContext.Exception.Message;
15            filterContext.Result = new ViewResult()
16            {
17                ViewName = "Error",
18                ViewData = filterContext.Controller.ViewData,
19            };
20            filterContext.ExceptionHandled = true;
21        }
22    }
23}


      异常拦截器一样需要继承FilterAttribute，但是不要实现IActionFilter，而是要实现IExceptionFilter接口，这个接口只有一个方法：OnException，顾名思义，当然是发生异常时被调用了。我们看看我让它做了什么：首先将异常信息（ExceptionContext一样也是上下文，而其成员的Exception就是一个Exception类型的实例，就是被抛出的异常）记录到ViewData相应的键值里，然后我们要呈现Error这个视图。
      注意！这里已经不是Controller里了，而是另一个类，所以当然不能调用View方法返回ViewResult实例了。我们只好新建一个ViewResult实例，并将其视图名设为Error，将上下文中的DataView传过去。
      最后那行filterContext.ExcepitonHandled = true;很重要，这行的意思是告诉系统，异常已经处理，不要再次处理了。

应用拦截器
      好了，拦截器建立完了，要怎么应用到相应的Action上呢？如果你使用过Spring，你一定对其AOP是实现之麻烦深有感触，如果你和我一样讨厌写各种XML的话，你真是太幸福了。因为在ASP.NET MVC中，应用拦截器简直是轻松加愉快。只要将拦截器当做Attribute写在要应用此拦截器的Action上就行了。看代码。
AnnounceController.cs:

 1using System;
 2using System.Collections.Generic;
 3using System.Linq;
 4using System.Web;
 5using System.Web.Mvc;
 6using System.Web.Mvc.Ajax;
 7using MVCDemo.Models;
 8using MVCDemo.Models.Interfaces;
 9using MVCDemo.Models.Entities;
10using MVCDemo.Controllers.Filters;
11
12namespace MVCDemo.Controllers
13{
14    public class AnnounceController : Controller
15    {
16        public ActionResult Release()
17        {
18            ICategoryService cServ = ServiceBuilder.BuildCategoryService();
19            List<CategoryInfo> categories = cServ.GetAll();
20            ViewData["Categories"] = new SelectList(categories, "ID", "Name");
21            return View("Release");
22        }
23
24        [LoggerFilter()]
25        [ExceptionFilter()]
26        public ActionResult DoRelease()
27        {
28            AnnounceInfo announce = new AnnounceInfo()
29            {
30                ID = 1,
31                Title = Request.Form["Title"],
32                Category = Int32.Parse(Request.Form["Category"]),
33                Content = Request.Form["Content"],
34            };
35
36            IAnnounceService aServ = ServiceBuilder.BuildAnnounceService();
37            aServ.Release(announce);
38
39            ViewData["Announce"] = announce;
40
41            System.Threading.Thread.Sleep(2000);
42            ViewData["Time"] = DateTime.Now;
43            System.Threading.Thread.Sleep(2000);
44
45            return View("ReleaseSucceed");
46        }
47    }
48}


      看到没有，只要在DoRelease上写这么两个Attribute，一切就完成了，至于什么时候该调用什么拦截器，都是框架帮你完成了。注意一点，为了让我们看出拦截器的时序，我们在DoRelease中加了一点东西，就是加了一个ViewData["Time"]，里面记录了执行此Action的时间，因为日志拦截器在前后都会记录时间，我们通过比较时间就可以看出执行顺序了。至于那两个Sleep则是让效果更明显的，这行代码的意思是让程序在这里延迟2秒。

      要执行这个程序，我们还要改一下ReleaseSucceed.aspx视图，其实就是加几个地方显示ViewData里相应的数据。
ReleaseSucceed.aspx:

 1<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="ReleaseSucceed.aspx.cs" Inherits="MVCDemo.Views.Announce.ReleaseSucceed" %>
 2<%@ Import Namespace="MVCDemo.Models.Entities" %>
 3
 4<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 5
 6<html xmlns="http://www.w3.org/1999/xhtml" >
 7<head runat="server">
 8    <title></title>
 9</head>
10<body>
11    <% AnnounceInfo announce = ViewData["Announce"] as AnnounceInfo; %>
12    <div>
13        <h1>MVC公告发布系统——发布公告成功</h1>
14        <dl>
15            <dt>ID：</dt>
16            <dd><%= announce.ID %></dd>
17            <dt>标题：</dt>
18            <dd><%= announce.Title %></dd>
19            <dt>类别ID：</dt>
20            <dd><%= announce.Category %></dd>
21            <dt>内容：</dt>
22            <dd><%= announce.Content %></dd>
23            <dt>发布时间：</dt>
24            <dd><%= ViewData["Time"] %></dd>
25        </dl>
26        <p><%= ViewData["ExecutingLogger"] %></p>
27        <p><%= ViewData["ExecutedLogger"] %></p>
28    </div>
29</body>
30</html>


      现在可以提交一则公告看结果了：

 
      没有问题，拦截器方法顺利执行，而且从时间可以看出，OnActionExecuting先执行，Action执行，然后OnActionExecuted执行。

      下面我们来看看异常拦截器的效果。要触发异常拦截器，首先要抛出一个异常，所以，我们在业务逻辑组件做点手脚。将MockAnnounceServices的Release方法改成如下：
1/// <summary>
2/// 发布公告
3/// </summary>
4/// <param name="announce"></param>
5public void Release(AnnounceInfo announce)
6{
7    throw new Exception("发布公告失败了！原因？没有原因！我是业务组件，我说失败就失败！");
8    return;
9}
posted on 2010-04-20 17:06  supegong  阅读(967)  评论(0)    收藏  举报
 
博客园  ©  2004-2026
浙公网安备 33010602011771号 浙ICP备2021040463号-3