01net進(jìn)階開發(fā)版7個專題08課程代碼課件mvc57filter

er（篩選器）是基于AOP（面向方面編程）的設(shè)計，它的作用是對MVC框架處理客戶端請求注入額外的邏輯，以非常簡單優(yōu)美的方式實現(xiàn)橫切關(guān)注點(s-cuttingoncerns)。橫切關(guān)注點是指橫越應(yīng)該程序的多個甚至所有模塊的功能，經(jīng)典的橫切關(guān)注點有日志記錄、緩存處理、異常處理和權(quán)限驗證等。本文將分別介紹MVC框架所支持的不同種類的er的創(chuàng)建和使用，以及如何控制它們的執(zhí)行。四種基本四種基本FilterMVCFilter理。這四類Filter如下表：MVCacionMVC框架為這些種類的Filter接口實現(xiàn)了默認(rèn)的特性類。如上表，ActionFil ttribute類實現(xiàn)了IActionFilter和IResultFilter兩個接口，這個類是一個抽象類，必須對它提供實現(xiàn)。另外兩個特性類，AuthorizeAttribute和HandleErrorAttribute，已經(jīng)提供了一些有用的方法，可以直接既能應(yīng)用在單個的[Authorize(Roles="trader")]actionpublicclassExampleController:Controller{[ShowMessage]//ation[OutputCache(Duration=60ation publicActionResultIndex() // }AuthorizationcontrollerFilterAuthorizationAuthorizationFilteractionFilter策略，保證action方法只能被的用戶調(diào)用。AuthorizationFilter實現(xiàn)的接口如下：namespaceSystem.Web.MvcpublicinterfaceIAuthorizationFilter voidOnAuthorization(AuthorizationContext}Authorization你可以自己實現(xiàn)IAuthorizationFilter接口來創(chuàng)建自己的安全認(rèn)證邏輯，但一般沒有這個必要也不推薦這樣做。如果要自定義安全認(rèn)證策略，更安全的方式是繼承默認(rèn)的AuthorizeAttribute類。類來演示自定義應(yīng)用程序，和往常的示例一樣添加一個Infrastructure文件夾，然后添加一個CustomAuthAttribute.cs類文件，代碼如下：namespaceMvcApplication1.InfrastructurepublicclassCustomAuthAttribute:AuthorizeAttribute privatebool publicCustomAuthAttribute(boolallowedParam) localAllowed= protectedoverrideboolAuthorizeCore(HttpContextBasehttpContext) if(httpContext.Request.IsLocal) return else return }這個簡單的Filter，通過重寫AuthorizeCore方法，允許我們本地的請求，在應(yīng)用該Filter時，可以通過構(gòu)造函數(shù)來指定是否允許本地請求。AuthorizeAttribte類幫我們內(nèi)實現(xiàn)了很多東西，我們只需把重點放在AuthorizeCore方法上，在該方法中實現(xiàn)權(quán)限認(rèn)證的邏輯。FilterHome的controller，然后在Indexaction上應(yīng)用這個Filter。參數(shù)設(shè)置為false以保護(hù)這個action不被本地，如下：publicclassHomeController:ControllerpublicstringIndex() return"ThisistheIndexactionontheHome}運行程序，根據(jù)系統(tǒng)生成的默認(rèn)路由值，將請求那么AuthorizationAuthorizeAttribute類作為FilterRoles屬性，string類型，用逗號分隔的角色名，action方法的用戶必須屬于這些角色publicclassHomeController:Controller[Authorize(Users="jim,steve,jack",Roles=publicstringIndex() return"ThisistheIndexactionontheHome}這里我們?yōu)镮ndex方法應(yīng)用了Authorize特性，并同時指定了能該方法的用戶和角色。要Indexaction，必須兩者都滿足條件，即用戶名必須是jim,steve,jack中的一個，而且必須屬性admin角色。另外，如果不指定任何用戶名和角色名（即[Authorize]），那么只要是登錄用戶都能Exception對于大部分應(yīng)用程序，AuthorizeAttribute特性類提供的權(quán)限策略是足夠用的。如果你有特殊的需求，則可以通過繼承AuthorizeAttributeExceptionExceptionFilterIExceptionFilternamespaceSystem.Web.MvcpublicinterfaceIExceptionFilter voidOnException(ExceptionContext}ExceptionContext常用屬性說明在IExceptionFilter的接口定義中，唯一的OnException方法在未處理的異常時執(zhí)行，其中參數(shù)的類型：ExceptionContext，ControllerContext類，ControllerContext ControllerContext，ExceptionContext類還提供了以下對處理異常的常用屬ResultActionResultFilterExceptionFilterExceptionHandled屬性設(shè)置為true過，這個屬性一般在某個action方法上應(yīng)用了多個ExceptionFilter時會用到。屬性設(shè)置為InfrastructureRangeExceptionAttribute.cspublicclassRangeExceptionAttribute: ttribute,IExceptionFilterpublicvoidOnException(ExceptionContextfilterContext) if(!filterContext.ExceptionHandled&&filterContext.ExceptionisArgumentOutOfRangeException){ filterContext.Result=new filterContext.ExceptionHandled= }這個ExceptionFilter通過重定向到Content 下的一個靜態(tài)html文件來顯示友好的ArgumentOutOfRangeException異常信息。我們定義的RangeExceptionAttribute類繼承了 ttribute類，并且實現(xiàn)了IException接口。作為一個MVCFilter，它的類必須實現(xiàn)IMvcFilter接口，你可以直接實現(xiàn)這個接口，但更簡單的方法是繼承Fil ttribute基類，該基類實現(xiàn)了一些必要的接口并提供了一些有用的基本特性，比如按照默認(rèn)的順序來處理Filter。ContentRangeErrorPage.html<!DOCTYPE<!DOCTYPEhtml><html"> <title>RangeError</title></head> <span>Oneoftheargumentswasoutoftheexpected</body> publicclassHomeController:Controller publicstringRangeTest(intid) if(id>100) returnString.Format("Theidvalueis:{0}", }else thrownewArgumentOutOfRangeException("id",id, 為/由于靜態(tài)的html文件是和脫離的，所以實際項目中的是用一個View來呈現(xiàn)友好的錯誤信息，以便很好的對它進(jìn)行一些動態(tài)的控制。如下面把示例改動一下，RangeExceptionAttribute類 publicclassRangeExceptionAttribute: ttribute,{ publicvoidOnException(ExceptionContextfilterContext) if(!filterContext.ExceptionHandled&&filterContext.ExceptionisArgumentOutOfRangeException){ intval= filterContext.Result=newViewResult ViewName= ViewData=new filterContext.ExceptionHandled= ViewResultViewmodel然后我們在Views/Shared文件夾下添加一個RangeError.cshtml文件，代碼如下：@model<!DOCTYPEhtml><html> <metaname="viewport"content="width=device-width" <title>RangeError</title></head> <span>Thevalue@Modelwasoutoftheexpected @Html.ActionLink("Changevalueandtryagain",</div></body>很多時候異常是不可預(yù)料的，在每個Action方法或Controller上應(yīng)用ExceptionFilter是不現(xiàn)實ViewFilterRangeError.cshtmlView@modelvarcount=varnumber=Model/}Web.config何時何地了異常都可以顯示統(tǒng)一的友好錯誤信息。在Web.config文件中的<system.web>節(jié)<customErrorsmode="On"使用內(nèi)置的Exceptin通過上面的演示，我們理解了ExceptinFilter在MVC背后是如何運行的。但我們并不會經(jīng)常去創(chuàng)建自己的ExceptinFilter，因為微軟在MVC框架中內(nèi)置的HandleErrorAttribute(實現(xiàn)了IExceptionFilter接口)已經(jīng)足夠我們平時使用。它包含ExceptionType、View和Master三個屬性。當(dāng)ExceptionType屬性指定類型的異常被時，這個Filter將用View屬性指定的View（使用默認(rèn)的Layout或Mast屬性指定的Layout）來呈現(xiàn)一個頁面。如下面代碼所示：[HandleError(ExceptionType=typeof(ArgumentOutOfRangeException),View"RangeError")]publicstringRangeTest(intid)if(id>100) returnString.Format("Theidvalueis:{0}",}else thrownewArgumentOutOfRangeException("id",id,}使用內(nèi)置的HandleErrorAttribute，將異常信息呈現(xiàn)到View時，這個特性同時會傳遞一個HandleErrorInfo對象作為View的model。HandleErrorInfo類包含ActionName、ControllerNameException屬性，如下面的RangeError.cshtml使用這個model@modelViewBag.Title="Sorry,therewasa}<!DOCTYPEhtml><html> <metaname="viewport"content="width=device-width" <title>RangeError</title></head> <span>Thevalue wasoutoftheexpected @Html.ActionLink("Changevalueandtryagain", <div y: </div></body>ActionAction顧名思義，ActionFilteraction現(xiàn)IActionFilter接口，該接口定義如下：namespaceSystem.Web.MvcpublicinterfaceIActionFilter voidOnActionExecuting(ActionExecutingContext voidOnActionExecuted(ActionExecutedContext}usingSystem.Diagnostics;usingnamespaceMvcApplication1.InfrastructurepublicclassProfileActionAttribute: ttribute,IActionFilter privateStopwatch publicvoidOnActionExecuting(ActionExecutingContextfilterContext) timer= publicvoidOnActionExecuted(ActionExecutedContextfilterContext) if(filterContext.Exception==null) string.Format("<div>Actionmethodelapsedtime:{0}</div>", }[ProfileAction]publicstringFilterTest()return"ThisistheActionFilterTest}定位到我們看到，ProfileActionOnActionExecuted方法是在FilterTest方法返回結(jié)果之前執(zhí)行的。確切的說，OnActionExecuted方法是在actionactionResultOnActionExecutingOnActionExecutedActionExecutingContextResultResultFilteractionActionFilter現(xiàn)IResultFilter接口，定義如下：namespaceSystem.Web.MvcpublicinterfaceIResultFilter voidOnResultExecuting(ResultExecutingContext voidOnResultExecuted(ResultExecutedContext}IResultFilterIActionFilterResultFilterAction類文件，代碼如下：publicclassProfileResultAttribute: ttribute,IResultFilterprivateStopwatchpublicvoidOnResultExecuting(ResultExecutingContextfilterContext) timer=publicvoidOnResultExecuted(ResultExecutedContextfilterContext) string.Format("<div>Resultelapsedtime:{0}</div>",}[ProfileAction][ProfileResult]publicstringFilterTest()return"ThisistheActionFilterTest}內(nèi)置的內(nèi)置的Action和ResultMVC框架內(nèi)置了一個 ttribute類用來創(chuàng)建action和result篩選器，即可以控classttribute:IActionFilter, publicvirtualvoidOnActionExecuting(ActionExecutingContextfilterContext){ publicvirtualvoidOnActionExecuted(ActionExecutedContextfilterContext){ publicvirtualvoidOnResultExecuting(ResultExecutingContextfilterContext){ publicvirtualvoidOnResultExecuted(ResultExecutedContextfilterContext){ }和類文件，代碼如下：publicclassProfileAllAttribute: ttributeprivateStopwatchpublicoverridevoidOnActionExecuting(ActionExecutingContextfilterContext){ timer=publicoverridevoidOnResultExecuted(ResultExecutedContextfilterContext){ string.Format("<div>Totalelapsedtime:{0}</div>",}[ProfileResult][ProfileAll]publicstringFilterTest()return"ThisistheFilterTest}運行程序，URL/Home/FilterTestAction publicclassHomeController:ControllerprivateStopwatchpublicstringFilterTest() return"ThisistheFilterTestprotectedoverridevoidOnActionExecuting(ActionExecutingContextfilterContext){ timer=protectedoverridevoidOnResultExecuted(ResultExecutedContextfilterContext){ string.Format("<div>Totalelapsedtime: }為全局為全局全局Filter對整個應(yīng)用程序的所有controller下的所有action方法有效。在App_Start/FilterConfig.cs文件中的RegisterGlobalFilters方法，可以把一個Filter類為全usingSystem.Web;usingSystem.Web.Mvc;usingnamespaceMvcApplication1publicclassFilterConfig publicstaticvoidRegisterGlobalF