ASP.NET MVC自定义操作过滤器

2022-04-17 14:19:05
目录
一、操作过滤器1、定义2、案例2.1、创建自定义操作过滤器2.2、新建控制器二、结果过滤器1、定义2、案例三、案例1、记录操作1.1、创建实体类1.2、创建日志类1.3、修改操作过滤器类2、实现权限控制功能

一、操作过滤器

1、定义

操作过滤器用于实现IActionFilter接口以及包装操作方法执行。IActionFilter接口声明两个方法:OnActionExecuting和OnActionExecuted。OnActionExecuting在操作方法之前运行。OnActionExecuted在操作方法之后运行,可以执行其他处理,如向操作方法提供额外数据、检查返回值或取消执行操作方法。

查看ActionFilterAttribute类的定义:

#region 程序集 System.Web.Mvc, Version=5.2.7.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35// D:PracticeMVC自定义操作过滤器MVCCustomerActionFilterDemopackagesMicrosoft.AspNet.Mvc.5.2.7libnet45System.Web.Mvc.dll#endregionnamespace System.Web.Mvc{    //    // 摘要:    //     表示筛选器特性的基类。    [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = false)]    public abstract class ActionFilterAttribute : FilterAttribute, IActionFilter, IResultFilter    {        //        // 摘要:        //     初始化 System.Web.Mvc.ActionFilterAttribute 类的新实例。        protected ActionFilterAttribute();        //        // 摘要:        //     在执行操作方法后由 ASP.NET MVC 框架调用。        //        // 参数:        //   filterContext:        //     筛选器上下文。        public virtual void OnActionExecuted(ActionExecutedContext filterContext);        //        // 摘要:        //     在执行操作方法之前由 ASP.NET MVC 框架调用。        //        // 参数:        //   filterContext:        //     筛选器上下文。        public virtual void OnActionExecuting(ActionExecutingContext filterContext);        //        // 摘要:        //     在执行操作结果后由 ASP.NET MVC 框架调用。        //        // 参数:        //   filterContext:        //     筛选器上下文。        public v易采站长站irtual void OnResultExecuted(ResultExecutedContext filterContext);        //        // 摘要:        //     在执行操作结果之前由 ASP.NET MVC 框架调用。        //        // 参数:        //   filterContext:        //     筛选器上下文。        public virtual void OnResultExecuting(ResultExecutingContext filterContext);    }}

根据方法的名字就知道4个方法执行的顺序了:

OnActionExecuting是Action执行前的操作、OnActionExecuted则是Action执行后的操作、OnResultExecuting是解析ActionResult前执行、OnResultExecuted是解析ActionResult后执行。em.Web;using System.Web.Mvc;namespace MVCCustomerActionFilterDemo.Controllers{ public class ActionFiltersController : Controller { // GET: ActionFilters [CustomerActionFilter] public ActionResult Index() { Response.Write("<h2>执行Index...</h2>"); return View(); } }}

Index方法对应的视图代码如下:

@{    Layout = null;}<!DOCTYPE html><html><head>    <meta name="viewport" content="width=device-width" />    <title>Index</title></head><body>    <div>         <h1>操作过滤器测试页面</h1>    </div></body></html>

运行结果;

ng(); LogEntity entity = new LogEntity() { OperationTime = DateTime.Now, ControllerName = strControllerName, ActionName = strActionName, // 为了方便测试写admin,真实案例需要获取当前登录的用户 OperationUserId = "admin" }; // 记录操作记录 LogHelper.WriteOperRecore(entity); base.OnActionExecuting(filterContext); } public override void OnActionExecuted(ActionExecutedContext filterContext) { filterContext.HttpContext.Response.Write("Action方法执行结束"); base.OnActionExecuted(filterContext); } public override void OnResultExecuting(ResultExecutingContext filterContext) { filterContext.HttpContext.Response.Write("Action方法执行结束,准备呈现视图"); base.OnResultExecuting(filterContext); } public override void OnResultExecuted(ResultExecutedContext filterContext) { filterContext.HttpContext.Response.Write("视图呈现结束"); base.OnResultExecuted(filterContext); } }}

运行程序,查看生成的日志:

ASP.NETMVC自定义操作过滤器

2、实现权限控制功能

可以重写OnActionExecuting方法实现授权过滤器一样的功能,因为OnActionExecuting方法是在Action方法执行前执行的,自定义一个实现ActionFilterAttribute类的CustomerActionPremisFilters类,代码如下:

using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.Web.Mvc;using MVCCustomerActionFilterDemo.DataBase;using MVCCustomerActionFilterDemo.Models;namespace MVCCustomerActionFilterDemo.Extension{    public class CustomerActionPremisFilters :ActionFilterAttribute    {        public string ActionName { get; set; } //用于保存Action配置的别名        public string AreaName { get; set; }        public string Roles { get; set; }        public override void OnActionExecuting(ActionExecutingContext filterContext)        {            // 如果未登录,则跳转到登录界面            if (!filterContext.HttpContext.User.Identity.IsAuthenticated)            {                filterContext.HttpContext.Response.Redirect("/Account/LogOn");                return;            }            //当前登录用户的用户名            string userName = filterContext.HttpContext.User.Identity.Name;            //当前登录用户对象            User user = SampleData.users.Find(u => u.UserName == userName);              if (user != null)            {                //当前登录用户的角色                Role role = SampleData.roles.Find(r => r.Id == user.RoleId);                 //获得controller:                string controllerName = filterContext.RouteData.Values["controller"].ToString().ToLower();                if (ActionName == null)                {                    ActionName = filterContext.RouteData.Values["action"].ToString();                }                                  //查询角色id                RoleWithControllerAction roleWithControllerAction = SampleData.roleWithControllerAndAction.Find(r => r.ControllerName.ToLower() == controllerName && ActionName.ToLower() == ActionName.ToLower());                if (roleWithControllerAction != null)                {                    //有权限操作当前控制器和Action的角色id                    this.Roles = roleWithControllerAction.RoleIds;                    }                if (!string.IsNullOrEmpty(Roles))                {                    foreach (string roleid in Roles.Split(','))                    {                        if (role.Id.ToString() == roleid)                        {                            //return就说明有权限了,后面的代码就不跑了,直接返回视图给浏览器就好                            return;                        }                                      }                }                filterContext.Result = new ViewResult { ViewName = "Error", };                return;            }            else            {                filterContext.Result = new EmptyResult();                filterContext.HttpContext.Response.Redirect("/Account/Logon", true);                return;            }        }    }}

新建ActionPremisFilters控制器,代码如下:

using MVCCustomerActionFilterDemo.Extension;using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.Web.Mvc;namespace MVCCustomerActionFilterDemo.Controllers{    public class ActionPremisFiltersController : Controller    {        // GET: ActionPremisFilters        [CustomerActionPremisFilters]        public ActionResult Index()        {            return View();        }    }}

修改SampleData数据,使角色id为2、3的可以访问ActionPremisFilters的Index方法:

using MVCCustomerActionFilterDemo.Models;using System;using System.Collections.Generic;using System.Linq;using System.Web;namespace MVCCustomerActionFilterDemo.DataBase{    /// <summary>    /// 测试数据(实际项目中,这些数据应该从数据库拿)    /// </summary>    public class SampleData    {        public static List<User> users;        public static List<Role> roles;        public static List<RoleWithControllerAction> roleWithControllerAndAction;        static SampleData()        {            // 初始化用户            users = new List<User>()            {                new User(){ Id=1, UserName="jxl", RoleId=1},                new User(){ Id=2, UserName ="senior1", RoleId=2},                new User(){ Id=3, UserName ="senior2", RoleId=2},                new User(){ Id=5, UserName="junior1", RoleId=3},                new User(){ Id=6, UserName="junior2", RoleId=3},                new User(){ Id=6, UserName="junior3", RoleId=3}            };            // 初始化角色            roles = new List<Role>()            {                new Role() { Id=1, RoleName="管理员", Description="管理员角色"},                new Role() { Id=2, RoleName="高级会员", Description="高级会员角色"},                new Role() { Id=3, RoleName="初级会员", Description="初级会员角色"}            };            // 初始化角色控制器和Action对应类            roleWithControllerAndAction = new List<RoleWithControllerAction>()            {                new RoleWithControllerAction(){ Id=1, ControllerName="AuthFilters", ActionName="AdminUser", RoleIds="1"},                new RoleWithControllerAction(){ Id=2, ControllerName="AuthFilters", ActionName="SeniorUser",RoleIds="1,2"},                new RoleWithControllerAction(){ Id=3, ControllerName="AuthFilters", ActionName="JuniorUser",RoleIds="1,2,3"},                new RoleWithControllerAction(){ Id=3, ControllerName="AuthFilters", ActionName="Welcome",RoleIds="1,2"},                new RoleWithControllerAction(){ Id=4, ControllerName="ActionFilters", ActionName="Index", RoleIds="2,3"},                // 角色2、3可以访问ActionPremisFilters控制器的Index方法                new RoleWithControllerAction(){ Id=4, ControllerName="ActionPremisFilters", ActionName="Index", RoleIds="2,3"}            };        }    }}

修改配置文件

<authentication mode="Forms">   <forms loginUrl="~/Account/LogOn" timeout="2880" /></authentication>

测试,访问ActionPremisFilters的Index方法,由于系统还没有登录,所以会跳转到登录页面,这时候用jxl用户登录:

ASP.NETMVC自定义操作过滤器

由于jxl用户没有访问ActionPremisFilters控制器中Index方法的权限,所以会跳转到Error页面:

ASP.NETMVC自定义操作过滤器

这时在用senior1用户登录,由于senior1用户有权限访问,所以会显示Index视图内容:

ASP.NETMVC自定义操作过滤器

github代码地址:https://github.com/jxl1024/MVCCustomerActionFilterDemo

到此这篇关于ASP.NET MVC自定义操作过滤器的文章就介绍到这了。希望对大家的学习有所帮助,也希望大家多多支持我们。