<四>ASP.NETCORE 控制器(controller) 和过滤器(filter)
控制器(Controller)用于定义和聚合一组操作(Action)。操作(或操作方法)是控制器中处理传入请求的一种方法。控制器提供了一种逻辑方式,将相似的操作组织起来,允许一些通用的规则(例如路由、缓存、授权〉使用共同的应用。
一、控制器的功能
- 定义操作(Action)
控制器上的任何公共方法都是操作。操作方法应包含将传入请求映射到业务关注的逻辑。业务关注通常表示为控制器通过依赖注入访问的服务并返回任何内容,通常会返回产生响应的 IActionResult(或者异步方法返回Task<IActionResult>)的实例。
- 指向试图(View)
返回使用模型呈现HTML的视图,例如,return View(viewname);
- Http状态码
返回HTTP状态代码,例如,return BadRequest();.
- 格式化响应
返回JSON或类似的以特定方式格式化对象。例如,return Json(model);。
- 重定向
返回到另一个操作或目标的重定向(使用Redirect、LocalRedirect、RedirectToAction或RedirectToRoute)。例如,return RedirectToAction("Complete" , new {id = 123});。
二、过滤器
过滤器允许在执行管道中的特定阶段之前或之后运行代码。可以对全局,也可以对每个控制器或每个操作配置过滤器。
1、工作原理: 过滤器管道在.net Core 选择了要执行的操作之后运行。
2、过滤器类型
MVC也提供了5大过滤器供我们用来处理请求前后需要执行的代码。
- 授权过滤器(AuthenticationFilter):授权过滤器最先运行,用于确定是否已针对请求为用户授权。 如果请求未获授权,授权过滤器可以让管道短路。
- 资源过滤器(resource-filters)
- 授权后运行。
- OnResourceExecuting 在过滤器管道的其余阶段之前运行代码。 例如,OnResourceExecuting 在模型绑定之前运行代码。
- OnResourceExecuted 在管道的其余阶段完成之后运行代码。
- 操作过滤器(ActionFilter)
- 在调用操作方法之前和之后立即运行代码。
- 可以更改传递到操作中的参数。
- 可以更改从操作返回的结果。
- 不可在 Razor Pages 中使用。
- 异常过滤器(ExceptionFilter):在向响应正文写入任何内容之前,对未经处理的异常应用全局策略。
- 结果过滤器(ResultFilter):在执行操作结果之前和之后立即运行代码。
3、定义过滤器
public class sampleActionFilter : IActionFilter
{ public void OnActionExecuting (ActionExecutingContext context) { //操作执行之前做一些事情 } public void onActionExecuted (ActionExecutedcontext context) { //操作执行之后做一些事情 }
}
4、全局使用过滤器
services. AddMvc (options => {
options.Filters.Add (typeof(SampleActionFilter)); options.Filters.Add (new SampleGlobalActionFilter())
});
5、控制器使用过滤器
[LogFilter] public IActionResult Demo () { return Content ( "successful access to resource - header should be set. " ); }