ASP.NET Core扩展库之Http通用扩展库的使用详解

 更新时间:2021年04月20日 11:33:52   作者:xfrog  
这篇文章主要介绍了ASP.NET Core扩展库之Http通用扩展库的使用详解,帮助大家更好的理解和学习使用.net技术,感兴趣的朋友可以了解下

    本文将介绍Xfrogcn.AspNetCore.Extensions扩展库对于Http相关的其他功能扩展,这些功能旨在处理一些常见需求, 包括请求缓冲、请求头传递、请求头日志范围、针对HttpClient与HttpRequestMessage、HttpResponseMessage的扩展方法。

一、开启服务端请求缓冲

    ASP.NET Core 中请求体是不能多次读取的,由于在MVC中,框架已经读取过请求体,如果你在控制器中再次读取,将会引发异常,如下示例:

    [ApiController]
    [Route("[controller]")]
    public class TestController : ControllerBase
    {
 
        public TestController()
        {

        }

        [HttpPost]
        public async Task<WeatherForecast> Save([FromBody]WeatherForecast enttiy)
        {
            using (StreamReader reader = new StreamReader(Request.Body))
            {
                Request.Body.Position = 0;
                string response = await reader.ReadToEndAsync();
            }
            return enttiy;
        }
    }

    当通过Post请求/test接口时,语句 Request.Body.Position 将触发异常:

System.NotSupportedException: Specified method is not supported.
   at Microsoft.AspNetCore.Server.Kestrel.Core.Internal.Http.HttpRequestStream.set_Position(Int64 value)

    当然,实际中可能不会像示例这样处理请求,但在业务需求中,的确可能会有多次读取请求体的情况出现。

    通过开启请求缓冲可以解决多次读取请求体的问题,Xfrogcn.AspNetCore.Extensions扩展库提供了EnableBufferingAttribute特性用于开启请求缓冲,你可以将此特性用于控制器或者Action方法。

    以上示例,只需在Save方法上添加EnableBuffering特性:

    [HttpPost]
    [EnableBuffering]
    public async Task<WeatherForecast> Save([FromBody]WeatherForecast enttiy)
    {
        ....
    }

二、请求头传递

    微服务架构下,通常我们使用请求头来实现请求的链路跟踪以及日志与请求的关联,例如,通过x-request-id,在日志系统中可以直接查看某一个请求在所有服务中的相关日志。

    扩展库通过拦截HttpClient请求管道,可实现对指定请求头的自动传递。默认配置下,扩展库会自动传递以"x-"开始的请求头,如果你需要传递其他的请求头,可通过配置中的TrackingHeaders来添加。

    IServiceCollection services = new ServiceCollection()
        .AddExtensions(null, config =>
        {
            // 自动传递以my-为前缀的请求头
            config.TrackingHeaders.Add("my-*");
        });

三、请求头日志的记录

    .NET Core日志框架中,实现了日志范围的概念,通过日志范围,可以让日志系统记录当前上下文的信息,例如,ASP.NET Core MVC中,日志范围包含ActionContext相关信息,故可以在一个请求的所有日志中都可自动记录Action的相关信息。

    扩展库可以将配置的请求头加入请求的日志范围,例如,默认配置下,扩展库会将x-request-id加入到请求的日志范围,所以在单一请求中的所有日志,都可自动携带x-request-id信息,以此实现跨服务的日志关联。要包含其他的请求头,可以通过配置中的HttpHeaders来设置:

    IServiceCollection services = new ServiceCollection()
        .AddExtensions(null, config =>
        {
            // 将my-id请求头包含到日志范围
            config.HttpHeaders.Add("my-id");
        });

    注意: 默认的控制台日志、文件日志不会保存日志范围的相关信息,你可以使用json格式的控制台日志或文件日志,在此格式下将保存日志范围中的数据。

    IServiceCollection services = new ServiceCollection()
        .AddExtensions(null, config =>
        {
            config.ConsoleJsonLog = true;
        });

四、Http消息上的扩展方法

    扩展库在HttpRequestMessage上提供了GetObjectAsync、WriteObjectAsync扩展方法,以便于对请求消息的读写。 在HttpResponseMessage上提供了GetObjectAsync、WriteObjectAsync扩展方法,以便于对应答消息的读写。这些方法都采用json格式。

示例:

    public class WeatherForecast
    {
        public DateTime Date { get; set; }

        public int TemperatureC { get; set; }

        public int TemperatureF => 32 + (int)(TemperatureC / 0.5556);

        public string Summary { get; set; }
    }
    static async Task Main(string[] args)
    {
        IServiceCollection services = new ServiceCollection()
            .AddExtensions(null, config =>
            {
            });

        IServiceProvider serviceProvider = services.BuildServiceProvider();

        IHttpClientFactory factory = serviceProvider.GetRequiredService<IHttpClientFactory>();
        HttpClient client = factory.CreateClient();

        HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Post, "http://localhost:5000/test");
        
        // 写入请求对象
        await request.WriteObjectAsync(new WeatherForecast()
        {
            Date = DateTime.Now
        });
        request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

        // 读取请求对象
        var entity = await request.GetObjectAsync<WeatherForecast>();

        HttpResponseMessage response = await client.SendAsync(request);

        // 读取应答对象
        entity = await response.GetObjectAsync<WeatherForecast>();

        Console.ReadLine();
    }

五、HttpClient上的扩展方法

    为了更方便快捷地使用HttpClient,扩展库在HttpClient上增加了多个扩展方法:

  • PostAsync<TResponse>: 发送对象到服务端,并获取指定类型的应答
  • PostAsync: 发送对象到服务端,并获取应答字符串
  • GetAsync<TResponse>: 发送Get请求,并获取TResponse类型的应答
  • GetAsync: 发送Get请求,并获取String类型的应答
  • SubmitFormAsync<TResponse>: 向服务器提交表单数据,并获取TResponse类型的应答
  • SubmitFormAsync: 向服务器提交表单数据,并获取String类型的应答
  • UploadFileAsync<TResponse>: 上次本地文件
  • UploadStreamAsync<TResponse>: 上传流数据到服务器

    有关这些扩展方法的详细说明,可参考文档 GitHub Gitee

    Xfrogcn.AspNetCore.Extensions地址:GitHub Gitee

以上就是ASP.NET Core扩展库之Http通用扩展库的使用详解的详细内容,更多关于ASP.NET Core扩展库之Http通用扩展库的资料请关注脚本之家其它相关文章!

相关文章

  • asp.net为网页动态添加关键词的方法

    asp.net为网页动态添加关键词的方法

    这篇文章主要介绍了asp.net为网页动态添加关键词的方法,可实现动态添加keyword meta的功能,非常具有实用价值,需要的朋友可以参考下
    2015-04-04
  • System.Timers.Timer定时执行程序示例代码

    System.Timers.Timer定时执行程序示例代码

    如果是某个逻辑功能的定时,可以将code放到逻辑功能的类的静态构造函数中,在该逻辑类第一次执行时,静态构造函数会被调用,则定时自然启动
    2013-06-06
  • asp.net core调用wps实现word转pdf的过程

    asp.net core调用wps实现word转pdf的过程

    这篇文章主要介绍了asp.net core调用wps实现word转pdf的过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
    2024-08-08
  • .NET中的枚举用法浅析

    .NET中的枚举用法浅析

    这篇文章主要介绍了.NET中的枚举用法,分析了枚举的定义、转换、判定等常见用法,需要的朋友可以参考下
    2015-01-01
  • VS2015下简单使用EF框架的方法

    VS2015下简单使用EF框架的方法

    这篇文章主要为大家详细介绍了VS2015下简单使用EF框架的方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2017-08-08
  • ASP.NET Core应用错误处理之三种呈现错误页面的方式

    ASP.NET Core应用错误处理之三种呈现错误页面的方式

    这篇文章主要给大家介绍了关于ASP.NET Core应用错误处理之三种呈现错误页面的方式的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-01-01
  • 用存储过程向数据库存值的具体实现

    用存储过程向数据库存值的具体实现

    本文为大家介绍下使用存储过程向数据库存值的具体实现过程,感兴趣的朋友不要错过
    2014-01-01
  • 详解ASP.NET Core 中间件之压缩、缓存

    详解ASP.NET Core 中间件之压缩、缓存

    本篇文章主要介绍了ASP.NET Core 中间件之压缩、缓存,具有一定的参考价值,感兴趣的小伙伴们可以参考一下。
    2016-12-12
  • C#中使用SQLite数据库的方法介绍

    C#中使用SQLite数据库的方法介绍

    SQLite是一个开源的轻量级的桌面型数据库,它将几乎所有数据库要素(包括定义、表、索引和数据本身)都保存在一个单一的文件中。SQLite用C编写实现,它在内存消耗、文件体积、操作性能、简单性方面都有不错的表现
    2012-01-01
  • ASP.NET Core中的对象池化技术详解

    ASP.NET Core中的对象池化技术详解

    这篇文章主要为大家详细介绍了ASP.NET Core中的对象池化技术的相关知识,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2024-01-01

最新评论