首页 > 编程语言 >ASP.NET Core 中的 Request Feature

ASP.NET Core 中的 Request Feature

时间:2022-10-04 16:31:48浏览次数:82  
标签:Core ASP HTTP 请求 接口 特性 NET HttpContext

ASP.NET Core 中的 Request Feature

​https://docs.microsoft.com/en-us/aspnet/core/fundamentals/request-features?view=aspnetcore-6.0​

在应用程序对象和中间件中所用来处理请求的 ​​HttpContext​​​ API 有一个被称为 ​​feature 接口​​​ 的底层抽象。每个 feature 提供器提供一个通过 ​​HttpContext​​​ 暴露出来的小粒度功能子集。这样在不需要重新整个实现 ​​HttpContext​​ 的情况下处理入站请求,而这些接口可以被服务器或者中间件添加、修改、封装、替换,或者甚至被删除掉。当测试的时候,它们还可以被用来 mock 功能。

Feature 集合

​HttpContext​​​ 的 ​​Features​​ 属性提供了针对当前请求访问这些 feature 接口的入口。由于该特性集是可变的,甚至是在请求处理过程中,中间件可以用来修改该特性集,并添加其它的特性。有些高级的 feature 只能通过特性集的接口来访问。

集合的类型是 ​​IFeatureCollection​​​,它的实现类型是 ​​FeatureCollection​​。通过定义可以看到,该集合实际上是 一个字典集合,字典的 key 为类型 Type,在这里并没有统一的 IFeature 接口。

Feature 接口

在 ​​Microsoft.AspNetCore.Http.Features​​ 中,ASP.NET Core 定义了一系列的常用 HTTP 特性接口,它们被各种中间件和服务器所共享,用于它们所支持的特性。服务器和中间件也可以提供它们自己的接口来支持附加的功能。

大多数的特性接口提供可选的亮点功能,它们所关联的 ​​HttpContext​​ API 则提供当没有提供特性时的默认功能。下面所列出的一些特性接口被标记为必须的,因为它们提供核心的请求和响应功能,它们必须被实现以支持对请求的处理。

下面的接口来自 ​​Microsoft.AspNetCore.Http.Features​

  1. ​IHttpRequestFeature​​: 定义 HTTP 请求结构,包括协议、路径、查询参数、请求头以及请求体。该特性是处理请求所必须的。
  2. ​IHttpResponseFeature​​: 定义 HTTP 响应结构,包括状态码、响应头以及响应体。该特性是处理请求所必须的。
  3. ​IHttpResponseBodyFeature​​​: 定义通过各种方式输出响应体,使用 ​​Stream​​ 或者 ​​PipeWriter​​ 或者文件。该特性是处理请求所必须的。它替换了 ​​IHttpResponseFeature.Body​​ 和 ​​IHttpSendFileFeature​
  4. ​IHttpAuthenticationFeature​​​: 持有当前请求相关的 ​​ClaimsPrincipal​
  5. ​IFormFeature​​: 用于解析和缓存入站的 HTTP 请求和提交的 multipart 表单。
  6. ​IHttpBodyControlFeature​​: 用来控制对于请求或者响应是否允许同步 IO 操作。
  7. ​IHttpActivityFeature​​: 用来为 diagnostic 监听器添加 Activity 信息。注意它出现在 .NET 6 中。
  8. ​IHttpConnectionFeature​​: 定义网络连接的 id 属性,本地与远程地址和端口。
  9. ​IHttpMaxRequestBodySizeFeature​​: 控制对于当前请求来说,最大可支持的请求体大小。
  10. ​IHttpRequestBodyDetectionFeature​​: 识别当前请求是否含有请求体。从 .NET 5 开始支持。
  11. ​IHttpRequestIdentifierFeature​​: 添加可以用来唯一标识请求的属性。
  12. ​IHttpRequestLifetimeFeature​​: 定义支持中断网络连接,以及检测当前请求是否已经被提前终止。例如由于客户端断开连接。
  13. ​IHttpRequestTrailersFeature​​​: 提供访问请求的 trailer 头,如果存在的话。例如 HTTP/1.1 中的块化请求体,或者 HTTP/2 中的 ​​Trailer​​ 请求头。
  14. ​IHttpResetFeature​​: 用来对于支持它们的协议,比如 HTTP/2 或者 HTTP/3 发送重置消息。
  15. ​IHttpResponseTrailersFeature​​: 如果支持的话,为应用程序启用响应 trailer 头支持。
  16. ​IHttpUpgradeFeature​​​: 定义对于 ​​HTTP Upgrade​​ 的支持。如果服务器支持切换协议的话,它支持客户端指定其希望使用的协议。
  17. ​IHttpWebSocketFeature​​: 定义支持 Web socket 的 API
  18. ​IHttpsCompressionFeature​​: 控制在 HTTPS 连接上响应是否被压缩。
  19. ​IItemsFeature​​: 为请求应用程序状态存储 Items 集合
  20. ​IQueryFeature​​: 解析和缓存查询串
  21. ​IRequestBodyPipeFeature​​​: 将请求体表示为 ​​PipeReader​​ 形式
  22. ​IRequestCookiesFeature​​​: 解析和缓存请求中的 ​​Cookie​​ 请求头中的值
  23. ​IResponseCookiesFeature​​​: 控制如何应用到响应头的 ​​Set-Cookie​​ 来控制响应 ​​Cookie​
  24. ​IServerVariablesFeature​​: 该特性提供访问服务器变量的功能,例如通过 IIS 服务器提供的变量。
  25. ​IServiceProvidersFeature​​​: 提供访问使用作用域服务的 ​​IServiceProvider​​。与依赖注入相关
  26. ​ISessionFeature​​​: 对于支持的用户会话,定义了 ​​ISessionFactory​​ 和 ​​ISession​​ 抽象。​​ISessionFeature​​ 是通过 ​​SessionMiddleware 中间件​​ 所实现的 ( 见:​​ASP.NET Core 中的会话​​ )
  27. ​ITlsConnectionFeature​​: 定义提取客户端证书的 API
  28. ​ITlsTokenBindingFeature​​: 定义操作 TLS 令牌绑定参数的 API
  29. ​ITrackingConsentFeature​​: 用于查询、授予和撤销有关存储与网站活动和功能相关的用户信息的用户同意。

参考资料

标签:Core,ASP,HTTP,请求,接口,特性,NET,HttpContext
From: https://blog.51cto.com/u_8130830/5731350

相关文章