文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

.NET Core API格式化输出对象OutputFormatter怎么用

2023-06-30 09:33

关注

这篇“.NET Core API格式化输出对象OutputFormatter怎么用”文章的知识点大部分人都不太理解,所以小编给大家总结了以下内容,内容详细,步骤清晰,具有一定的借鉴价值,希望大家阅读完这篇文章能有所收获,下面我们一起来看看这篇“.NET Core API格式化输出对象OutputFormatter怎么用”文章吧。

相信大家在项目中都用过统一响应参数模板。

先声明一个响应模板类:

public class ResponseDto{    public int code { get; set; }    public string msg { get; set; }    public object data { get; set; }}

再定义返回成功和失败的方法:

public IActionResult Success(object data){return ......}public IActionResult Fail(string msg){return ......}

在接口返回时统一调用:

[HttpGet]public IActionResult Get(){var data = new WeatherForecast() { Date = DateTime.Now };return Success(data);}

.NET Core API格式化输出对象OutputFormatter怎么用

当然了,这篇文章所讲的OutputFormatter和上面的统一模板不冲突哈,存在共通之处,都是格式化响应参数嘛,拿来做个引子。

OutputFormatter

OutputFormatter是所有格式化输出的基类,有唯一的子类:TextOutputFormatter,同时TextOutputFormatter又有一大堆子类:

如果不配置任何响应参数输出格式,asp.net core api响应参数默认的输出格式就是json

猴:这个接口给我返回xml,我不要json

我:你是不是脑子有毛病?好好的json不用用xml

得,前端大佬得要求还是得满足不是,这时候有些同学是不是已经去百度:.Net怎么将对象转换成xml?

No No No,这时候就轮到OutputFormatter的孙子 XmlDataContractSerializerOutputFormatter 出场了。

只需要简单给接口配置一个属性就搞定啦。

[Produces("application/xml")][HttpGet]public WeatherForecast Get(){return new WeatherForecast() { Date = DateTime.Now };}

我们来运行看一看:

.NET Core API格式化输出对象OutputFormatter怎么用

wtf,怎么会406

406:表示客户端无法解析服务端返回的内容。说白了就是后台的返回结果前台无法解析就报406错误。

哦,原来是忘了在Startup中配置我们的孙子XmlDataContractSerializerOutputFormatter

services.AddControllers((c) =>{c.OutputFormatters.Add(new XmlDataContractSerializerOutputFormatter());});

.NET Core API格式化输出对象OutputFormatter怎么用

注意:不只是没有在Startup中会出现406哦,以下情况也会出现:

OutputFormatter扩展

上面介绍了内置OutputFormatter的使用,那如果我们想自定义呢?当然也是可以的。

下面我们就用自定义的OutputFormatter实现顶部响应模板的效果:

public class ObjectOutputFormatter : TextOutputFormatter{public ObjectOutputFormatter(){SupportedEncodings.Add(Encoding.UTF8);SupportedEncodings.Add(Encoding.Unicode);// 这就是我们自定义contentType的名称SupportedMediaTypes.Add("text/object");}public override async Task WriteResponseBodyAsync(OutputFormatterWriteContext context, Encoding selectedEncoding){if (context == null){throw new ArgumentNullException(nameof(context));}if (selectedEncoding == null){throw new ArgumentNullException(nameof(selectedEncoding));}string text = JsonConvert.SerializeObject(new ResponseDto(){msg = "成功,自定义的哦",code = 200,data = context.Object});var response = context.HttpContext.Response;await response.WriteAsync(text, selectedEncoding);}}[Produces("text/object")][HttpGet]public WeatherForecast Get(){return new WeatherForecast() { Date = DateTime.Now };}public void ConfigureServices(IServiceCollection services){services.AddControllers((c) =>{c.OutputFormatters.Add(new XmlDataContractSerializerOutputFormatter());// 我们自定义的输出格式c.OutputFormatters.Add(new ObjectOutputFormatter());});}

搞定,我们来看看效果:

.NET Core API格式化输出对象OutputFormatter怎么用

ActionFilterAttribute

有些同学可能会想到过滤器,是的,上面的效果过滤器也能实现:

public class ResultFilter : ActionFilterAttribute{    public override void OnResultExecuting(ResultExecutingContext context)    {        ResponseDto result = new ResponseDto();        result.code = 200;        result.msg = "成功,ResultFilter";        var properties = context.Result.GetType().GetProperties(BindingFlags.Instance | BindingFlags.Public);        result.data = properties.FirstOrDefault(c => c.Name == "Value").GetValue(context.Result);        context.Result = new JsonResult(result);        base.OnResultExecuting(context);    }}[TypeFilter(typeof(ResultFilter))][HttpGet]public WeatherForecast Get(){return new WeatherForecast() { Date = DateTime.Now };}

.NET Core API格式化输出对象OutputFormatter怎么用

猴:有了过滤器为什么还搞个OutputFormatter呢?

我:不能因为过滤器可以实现同样的功能就认为OutputFormatter多余了,很显然过滤器的操作对象是请求/响应上下文,而OutputFormatter的操作对象则是响应参数。再说了,ActionFilterAttribute过滤器只是众多过滤器的一种。

猴:那过滤器和自定义OutputFormatter一起用会是什么效果呢?是不是像下面这样?

.NET Core API格式化输出对象OutputFormatter怎么用

我:不是,过滤器和自定义OutputFormatter同时使用,生效的只有过滤器,不信可以打断点试一下哦。

[Produces("text/object")][TypeFilter(typeof(ResultFilter))][HttpGet]public WeatherForecast Get(){return new WeatherForecast() { Date = DateTime.Now };}

.NET Core API格式化输出对象OutputFormatter怎么用

以上就是关于“.NET Core API格式化输出对象OutputFormatter怎么用”这篇文章的内容,相信大家都有了一定的了解,希望小编分享的内容对大家有帮助,若想了解更多相关的知识内容,请关注编程网行业资讯频道。

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯