ASP.NET Core 请求功能

作者:Steve Smith
翻译:谢炀(kiler398)
校对:姚阿勇(Dr.Yao)孟帅洋(书缘)

涉及到如何处理 HTTP 请求以及响应的独立 Web 服务器功能已经被分解成独立的接口,这些抽象被独立的服务器实现和中间件用于创建和修改应用程序的托管管道。

章节:

功能接口

ASP.NET Core 定义了许多 HTTP 功能接口,给服务器用来判断支持哪些功能。Web 服务器最基础功能就是处理请求并返回响应,下面是实现这个功能所涉及的接口:

IHttpRequestFeature
定义HTTP请求的结构,包括协议、路径、查询字符串、请求头以及正文。

IHttpResponseFeature
定义HTTP响应的结构,包括状态码、响应头以及响应正文。

IHttpAuthenticationFeature
定义对基于 ClaimsPrincipal 识别用户的支持以及指定验证处理程序。

IHttpUpgradeFeature
定义对 HTTP 升级 的支持, 允许客户端在服务器希望切换协议的时候指定自己想要使用的协议。

IHttpBufferingFeature
定义用于禁用请求和/或响应的缓冲的方法。

IHttpConnectionFeature
定义本地和远程地址以及端口的属性。

IHttpRequestLifetimeFeature
定义支持中止连接,或者对请求提前终止的检测,比如客户断开连接等原因。

IHttpSendFileFeature
定义一个异步发送文件的方法。

IHttpWebSocketFeature
定义一个支持 Web Sockets 的 API。

IHttpRequestIdentifierFeature
添加一个可以实现唯一标识请求的属性。

ISessionFeature
定义 ISessionFactoryISession 抽象接口以支持用户会话。

ITlsConnectionFeature
定义一个检索客户端证书的 API。

ITlsTokenBindingFeature
定义用来处理 TLS token 绑定参数的方法。

注意
ISessionFeature 不是一个服务器功能,而是由 SessionMiddleware 实现的 (见 Managing Application State)。

功能集合

FeaturesHttpContext 属性提供了一个接口用于获取和设置当前请求可用的 HTTP 功能。由于功能集合在请求上下文中都是可变的,那么中间件也可以用来修改集合以及添加对额外的功能支持。

中间件和请求特性

虽然服务器是负责创建功能集合的,但中间件既可以给集合添加功能也可以从中取用功能。例如,静态文件中间件 IHttpSendFileFeature 就会使用文件发送功能 IHttpSendFileFeature 。如果该功能存在,则用它把请求的物理路径中的静态文件发送出去,否则,会采用一个比较慢的发送文件的备用方法。当功能可用的时候,IHttpSendFileFeature 允许操作系统打开文件,并且直接执行内核模式拷贝到网卡。

此外,中间件可以添加到由服务器建立的功能集合里面。中间件甚至可以取代现有的功能,允许中间件增加服务器的功能。添加到集合中的功能对请求管道中靠后面的其他中间件或者基础应用程序本身会立即生效。

通过结合自定义的服务器实现和特定的中间件增强,可以构造出应用程序所需的精炼的功能集合。这使得无需改动服务器就可以添加缺失的功能,并确保只有最小数量的功能被公开,从而减少攻击面并提供性能。

总结

功能接口定义给定请求可能支持的特殊功能。服务器定义功能集合,以及该服务器所支持功能的初始集,而中间件则可用来增强这些功能。