Taurus.MVC WebAPI 入门开发教程6:全局控制器DefaultController与全局事件。
系列目录
1、Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行。
2、Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World。
3、Taurus.MVC WebAPI 入门开发教程3:路由类型和路由映射。
4、Taurus.MVC WebAPI 入门开发教程4:控制器方法及参数定义、获取及基础校验属性【Require】。
5、Taurus.MVC WebAPI 入门开发教程5:控制器安全校验属性【HttpGet、HttpPost】【Ack】【Token】【MicroService】。
6、Taurus.MVC WebAPI 入门开发教程6:全局控制器DefaultController与全局事件。
7、Taurus.MVC WebAPI 入门开发教程7:业务逻辑基类LogicBase的使用。
8、Taurus.MVC WebAPI 入门开发教程8:WebAPI文档与自动化测试。
后续还有两个系列:
1、Taurus.MVC 微服务 入门开发教程系列。 2、Taurus.MVC Web应用 入门开发教程系列。
前言:
全局控制器的作用:
1、可接收所有的404请求,做统一处理。 2、可以实现一些公共的全局的事件。
接收404的过程详细的描述:
对于Taurus.MVC中运行的请求,如果没有对应的控制器接收,默认产生404; 如果项目中存在DefaultController全局控制器,则转交给DefaultController。 如果DefaultController没有对应的方法接收,仍产生404。
如果需要对所有的404请求,做统一的处理输出,则可以重载Default方法, 该方法为最终方法,它可以接收所有的404请求。
下面介绍:全局控制器中的全局事件,文件有点类似以前的Global.cs的味道。
全局控制器的完整方法与注释说明:
/// <summary>
/// 全局控制器(适全全局事件处理)
/// </summary>
public class DefaultController : Taurus.Core.Controller
{
/// <summary>
/// 所有寻址不到的请求都集中执行到此方法(不想接收404则删除此重载方法即可)。
/// </summary>
public override void Default()
{
Write("DefaultController : Hello world");
}
/// <summary>
/// 用于所有的请求合法性验证,配合[Ack]属性
/// 启用时:局部的先执行(若存在),无局部才执行全局。
/// </summary>
public static bool CheckAck(IController controller, string methodName)
{
//需要自己实现Ack验证
return !string.IsNullOrEmpty(controller.Query<string>("ack")); } /// <summary>
/// 用于需要登陆后的身份验证,配合[Token]属性
/// 启用时:局部的先执行(若存在),无局部才执行全局。
/// </summary>
public static bool CheckToken(IController controller, string methodName)
{
//需要自己实现,或者通过配置Taurus.Auth启动自带的验证(自带的注释掉此方法即可)。
return !string.IsNullOrEmpty(controller.Query<string>("token"));
} /// <summary>
/// 用于校验微服务的内部身份验证,配合[MicroService]属性
/// 启用时:全局仅此一个生效,局部的失效。
/// </summary>
public static bool CheckMicroService(IController controller, string methodName)
{
return MicroService.Config.ServerKey == controller.Query<string>(MicroService.Const.HeaderKey);
} /// <summary>
/// 全局【路由映射】
/// 启用时:所有请求都进入此地做映射(需要映射时,返回映射的地址;不需要映射的返回空即可)。
/// </summary>
public static string RouteMapInvoke(HttpRequest request)
{
//if (request.Url.LocalPath.StartsWith("/api/") && RouteConfig.RouteMode == 2)
//{
// return "/test" + request.RawUrl;
//}
return string.Empty;
}
/// <summary>
/// 全局【方法执行前拦截】
/// 启用时:先全局,再执行局部(若存在)。
/// </summary>
public static bool BeforeInvoke(IController controller, string methodName)
{
return true;
}
/// <summary>
/// 全局【方法执行后业务】
/// 启用时:先执行局部(若存在),再执行全局。
/// </summary>
public static void EndInvoke(IController controller, string methodName)
{ }
}
全局方法都是静态方法,手写不太方便,对于有全局控制需要的,可以从此处Copy过去要用到的方法,不需要的忽略或注释掉。
下面补充其它说明:
其它1、全局拦截404的方法补充说明:
通过全局拦截后,默认会变成自定义方式:
1、正常处理流程,输出的状态码为200,如果需要返回404状态码,设置输出的状态码即可,如:
public override void Default()
{
Response.StatusCode = 404;
Write("DefaultController : Hello world");
}
2、如果想返回自定义页面,有两种方式:
1、直接读取文件路径,然后Write出去即可。 2、利用小技巧,让它直接触发MVC的页面加载机制即可,按路径存放页面即可:/Views/Default/Default.html。
其它2、全局方法的效用补充说明:
在一个系统中,后续会有一些边缘需求,比如:
1、加强安全校验; 2、方法调用次数的统计; 3、请求日志的记录 4、......
都可以在全局方法中自由发挥,比如在方法结束后:
收集请求参数或处理结果,放置到全局队列中,开个线程在全局定时扫描处理等。
总结:
DefaultController的名字是约定好的,用处也比较实在,一般项目都会用到它。
具体各方法的执行顺序,可以看该方法上的注释。
下一篇介绍:业务逻辑基类LogicBase的使用,还有两篇,将转入微服务系列教程。
Taurus.MVC WebAPI 入门开发教程6:全局控制器DefaultController与全局事件。的更多相关文章
- Taurus.MVC WebAPI 入门开发教程4:控制器方法及参数定义、获取及基础校验属性【Require】。
系列目录 1.Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行. 2.Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World. 3.Tau ...
- Taurus.MVC WebAPI 入门开发教程5:控制器安全校验属性【HttpGet、HttpPost】【Ack】【Token】【MicroService】。
系列目录 1.Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行. 2.Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World. 3.Tau ...
- Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行(含系列目录)。
前言: Taurus.MVC 微服务版本已经发布了:Taurus.MVC V3.0.3 微服务开源框架发布:让.NET 架构在大并发的演进过程更简单. 以前都是框架发布时写点相关功能点的文章,没有形成 ...
- Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World。
系列目录 1.Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行. 2.Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World. 3.Tau ...
- Taurus.MVC WebAPI 入门开发教程3:路由类型和路由映射。
系列目录 1.Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行. 2.Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World. 3.Tau ...
- Taurus.MVC WebAPI 入门开发教程8:WebAPI文档与自动化测试。
系列目录 1.Taurus.MVC WebAPI 入门开发教程1:框架下载环境配置与运行. 2.Taurus.MVC WebAPI 入门开发教程2:添加控制器输出Hello World. 3.Tau ...
- Taurus.MVC 微服务框架 入门开发教程:项目集成:4、默认安全认证与自定义安全认证。
系列目录: 本系列分为项目集成.项目部署.架构演进三个方向,后续会根据情况调整文章目录. 本系列第一篇:Taurus.MVC V3.0.3 微服务开源框架发布:让.NET 架构在大并发的演进过程更简单 ...
- Taurus.MVC 微服务框架 入门开发教程:项目集成:6、微服务间的调用方式:Rpc.StartTaskAsync。
系统目录: 本系列分为项目集成.项目部署.架构演进三个方向,后续会根据情况调整文章目录. 开源地址:https://github.com/cyq1162/Taurus.MVC 本系列第一篇:Tauru ...
- Taurus.MVC 微服务框架 入门开发教程:项目部署:7、微服务节点的监控与告警。
系统目录: 本系列分为项目集成.项目部署.架构演进三个方向,后续会根据情况调整文章目录. 开源地址:https://github.com/cyq1162/Taurus.MVC 本系列第一篇:Tauru ...
随机推荐
- Es图形化软件使用之ElasticSearch-head、Kibana,Elasticsearch之-倒排索引操作、映射管理、文档增删改查
今日内容概要 ElasticSearch之-ElasticSearch-head ElasticSearch之-安装Kibana Elasticsearch之-倒排索引 Elasticsearch之- ...
- cloudwu/coroutine 源码分析
1 与其它协程库使用对比 这个 C 协程库是云风(cloudwu) 写的,其接口风格与 Lua 协程类似,并且都是非对称 stackful 协程.这个是源代码中的示例: #include " ...
- .NET打包应用设置成自包含
设置项目的配置文件 在项目的配置文件(.csproj文件)中加入RuntimeIdentifier节点,节点的内容为要打包进入最终程序的目标运行时.更多平台标识符,请看这里RIDs. <Prop ...
- 【Redis】简单动态字符串SDS
C语言字符串 char *str = "redis"; // 可以不显式的添加\0,由编译器添加 char *str = "redis\0"; // 也可以添加 ...
- iNeuOS工业互联网操作系统,增加搜索应用、多数据源绑定、视图背景设置颜色、多级别文件夹、组合及拆分图元
目 录 1. 概述... 2 2. 搜索应用... 2 3. 多数据源绑定... 3 4. 视图背景设置颜色... 4 5. 多级别文件夹 ...
- Node.js精进(3)——流
在 JavaScript 中,一般只处理字符串层面的数据,但是在 Node.js 中,需要处理网络.文件等二进制数据. 由此,引入了Buffer和Stream的概念,两者都是字节层面的操作. Buff ...
- Vue回炉重造之如何使用props、emit实现自定义双向绑定
下面我将使用Vue自带的属性实现简单的双向绑定. 下面的例子就是利用了父组件传给子组件(在子组件定义props属性,在父组件的子组件上绑定属性),子组件传给父组件(在子组件使用$emit()属性定义一 ...
- CompletableFuture的入门
runAsync 和 supplyAsync runAsync接受一个Runable的实现,无返回值 CompletableFuture.runAsync(()->System.out.prin ...
- docker安装Sentinel
1.拉取镜像 docker pull bladex/sentinel-dashboard:latest 2.运行 docker run --name sentinel --restart=always ...
- C# / VB.NET 将Html转为Word
本文分享以C#程序代码为例,实现将Html文件转换Word文档的方法(附VB.NET代码).在实际转换场景中可参考本文的方法,转换前,请按照如下方法引用Word API的dll文件到Visual St ...