.NetCore Web Api 利用ActionFilterAttribute统一接口返回值格式及问题解析
.Net Core 同 Asp.Net MVC一样有几种过滤器,这里不再赘述每个过滤器的执行顺序与作用。
在实际项目开发过程中,统一API返回值格式对前端或第三方调用将是非常必要的,在.NetCore中我们可以通过ActionFilterAttribute来进行统一返回值的封装。
在封装之前我们需要考虑下面几个问题:
1,需要对哪些结果进行封装
我目前的做法是,只对ObjectResult进行封装,其他的类型:FileResult,ContentResult,EmptyResult,RedirectResult不予处理
2,对异常错误的封装
既然是统一返回值,当然也要考虑接口异常的问题了
但是不是所有的异常我们都需要返回给前端的,我们可能需要自定义一个业务异常,业务异常可以在前端进行友好提示,系统异常完全没必要抛出给前端或第三方,且需要对系统异常进行日志记录
项目结构:
Exceptions:自定义业务异常
Filters:自定义过滤器(统一结果封装,全局异常)
Models:统一结果实体
部分代码:
using System; namespace NetCoreCommonResult.Exceptions { /// <summary> /// 自定义业务异常,可以由前端抛出友好的提示 /// </summary> public class BizException:Exception { public BizException() { } public BizException(string message):base(message) public BizException(string message, Exception ex) : base(message, ex) } }
using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.Mvc.Filters; namespace NetCoreCommonResult.Filters { public class CommonResultFilterAttribute : ActionFilterAttribute { public override void OnResultExecuting(ResultExecutingContext context) { if (context.Result is ObjectResult objRst) { if (objRst.Value is Models.ApiResult) return; context.Result = new ObjectResult(new Models.ApiResult { Success = true, Message = string.Empty, Data = objRst.Value }); } } } }
using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.Mvc.Filters; using Microsoft.Extensions.Logging; namespace NetCoreCommonResult.Filters { public class GlobalExceptionFilterAttribute : ExceptionFilterAttribute { private readonly ILogger<GlobalExceptionFilterAttribute> _logger; public GlobalExceptionFilterAttribute(ILogger<GlobalExceptionFilterAttribute> logger) { _logger = logger; } public override void OnException(ExceptionContext context) { context.ExceptionHandled = true; var isBizExp = context.Exception is Exceptions.BizException; context.Result = new ObjectResult(new Models.ApiResult { Success = false, Message = context.Exception.Message }); //非业务异常记录errorLog,返回500状态码,前端通过捕获500状态码进行友好提示 if (isBizExp == false) { _logger.LogError(context.Exception, context.Exception.Message); context.HttpContext.Response.StatusCode = 500; } base.OnException(context); } } }
Startup.cs
using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; using Microsoft.Extensions.Configuration; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; namespace NetCoreCommonResult { public class Startup { public Startup(IConfiguration configuration) { Configuration = configuration; } public IConfiguration Configuration { get; } // This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) services.AddLogging(); services.AddControllers(ops => { //添加过滤器 ops.Filters.Add(new Filters.CommonResultFilterAttribute()); //GlobalExceptionFilterAttribute构造中注入其他服务,需要通过ServiceFilter添加 ops.Filters.Add(new Microsoft.AspNetCore.Mvc.ServiceFilterAttribute(typeof(Filters.GlobalExceptionFilterAttribute))); }); //注册GlobalExceptionFilterAttribute services.AddScoped<Filters.GlobalExceptionFilterAttribute>(); // This method gets called by the runtime. Use this method to configure the HTTP request pipeline. public void Configure(IApplicationBuilder app, IWebHostEnvironment env) if (env.IsDevelopment()) app.UseDeveloperExceptionPage(); } else app.UseExceptionHandler("/Error"); app.UseStaticFiles(); app.UseRouting(); app.UseAuthorization(); app.UseEndpoints(endpoints => endpoints.MapControllers(); } }
最后新建一个Controller然后写上几个不同返回值的的Action
using Microsoft.AspNetCore.Mvc; using System; using System.Collections.Generic; using System.Text; using System.Threading.Tasks; namespace NetCoreCommonResult.Controllers { [Route("api/[controller]")] [ApiController] public class HomeController : ControllerBase { /// <summary> /// string /// </summary> /// <returns></returns> [HttpGet] public string Index() => "Welecome to .NetCore"; /// 跳转,不处理 [HttpGet("redirect")] public ActionResult Redirect() => RedirectToAction("Index"); /// [HttpGet("num")] public int Num() => 10; /// 异步 [HttpGet("async")] public Task<IEnumerable<string>> TaskString() =>Task.FromResult<IEnumerable<string>>(new[] { "A","B","C"}); /// 文件输出,不处理 [HttpGet("file")] public ActionResult GetFile() => File(Encoding.UTF8.GetBytes("File String"), "text/plain"); /// 空返回值,不处理 [HttpGet("empty")] public ActionResult Empty() => Empty(); /// contentResult 不处理 [HttpGet("content")] public ActionResult Content() => Content("this is content"); /// 异常,返回500错误 [HttpGet("exception")] public ActionResult GetException() => throw new InvalidOperationException("invalid"); /// 自定义异常,返回200 [HttpGet("bizException")] public ActionResult GetBizException() => throw new Exceptions.BizException("bizException"); } }
下面是返回结果截图:
上图:访问/api/home和/api/home/redirect的结果
上图:Action返回数字的结果
上图:返回string集合的结果
上图:输出文本文件的结果
上图:返回ContentResult的结果
上图:系统异常的结果,输出状态码为500
上图:抛出业务异常的结果,输出状态码200
不知道如何上传ZIP包,实例代码项目已经放到Gitee上了,后面有时间也会写点简单的例子
地址:https://gitee.com/tang3402/net-core-samples.git
到此这篇关于.NetCore Web Api 利用ActionFilterAttribute统一接口返回值格式的文章就介绍到这了,更多相关.NetCore Web Api 统一接口返回值格式内容请搜索猪先飞以前的文章或继续浏览下面的相关文章希望大家以后多多支持猪先飞!
原文出处:https://www.cnblogs.com/263613093/p/15988515.html
相关文章
Springboot如何实现Web系统License授权认证
这篇文章主要介绍了Springboot如何实现Web系统License授权认证,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-05-28C#使用Http Post方式传递Json数据字符串调用Web Service
这篇文章主要为大家详细介绍了C#使用Http Post方式传递Json数据字符串调用Web Service,具有一定的参考价值,感兴趣的小伙伴们可以参考一下...2020-06-25- 这篇文章主要介绍了WebStorm无法正确识别Vue3组合式API的解决方案,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下...2021-02-18
InterlliJ IDEA2020新建java web项目找不到Static Web的解决
这篇文章主要介绍了InterlliJ IDEA2020新建java web项目找不到Static Web的解决,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2020-09-02- 这篇文章主要介绍了浅谈vue2的$refs在vue3组合式API中的替代方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧...2021-04-18
- 这篇文章主要介绍了Java List集合返回值去掉中括号('[ ]')的操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-08-29
详解在IDEA中将Echarts引入web两种方式(使用js文件和maven的依赖导入)
这篇文章主要介绍了在IDEA中将Echarts引入web两种方式(使用js文件和maven的依赖导入),本文通过图文并茂的形式给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2020-07-11- 这篇文章主要介绍了jQuery mobile 移动web(6)的相关资料,需要的朋友可以参考下...2015-12-21
- 这篇文章主要介绍了如何使用 JavaScript 操作浏览器历史记录 API,帮助大家更好的理解和使用JavaScript,感兴趣的朋友可以了解下...2020-11-24
- 这篇文章主要介绍了Feign接口方法返回值设置方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教...2021-07-08
- 这篇文章主要帮助大家理解JavaScript中worker事件api,对worker事件api有一个深刻了解,感兴趣的小伙伴们可以参考一下...2015-12-27
- 这篇文章主要介绍了vue设置全局访问接口API地址操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧...2020-08-14
- 在日常开发中,总会接触到各种接口,前后端数据传输接口,第三方业务平台接口,下面这篇文章主要给大家介绍了关于如何设计一个安全的API接口的相关资料,需要的朋友可以参考下...2021-08-12
C# Windows API应用之基于GetDesktopWindow获得桌面所有窗口句柄的方法
这篇文章主要介绍了C# Windows API应用之基于GetDesktopWindow获得桌面所有窗口句柄的方法,结合实例形式分析了GetDesktopWindow函数用于获取窗口句柄的具体使用方法与相关注意事项,需要的朋友可以参考下...2020-06-25- 这篇文章主要介绍了Vue常用API、高级API的相关总结,帮助大家更好的理解和学习使用vue框架,感兴趣的朋友可以了解下...2021-02-04
- 这篇文章主要为大家详细介绍了jQuery UI结合Ajax创建可定制的Web界面,如何利用Ajax和jQuery UI创建具有各种定制功能的高度可定制的UI,感兴趣的小伙伴们可以参考一下...2016-06-24
- 这篇文章主要介绍了uni-app 常用API,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下...2021-10-20
Swift 中如何使用 Option Pattern 改善可选项的 API 设计
这篇文章主要介绍了Swift 中如何使用 Option Pattern 改善可选项的 API 设计,帮助大家更好的进行ios开发,感兴趣的朋友可以了解下...2020-10-23- 这篇文章主要介绍了Tomcat首次部署web项目流程图解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下...2020-12-11
微信小程序 wx.request(object) API详解及实例代码
这篇文章主要介绍了微信小程序 wx.request(object) API详解及实例代码的相关资料,需要的朋友可以参考下...2016-10-02