冠军

导航

对比 ASP.NET Core 中的 HttpContext.Features 与 HttpContext.Items

对比 ASP.NET Core 中的 HttpContext.Features 与 HttpContext.Items

https://newbedev.com/httpcontext-features-vs-httpcontext-items-in-asp-net-core

最大的区别是 HttpContext.Items 是设计用来存储 键-值 对的,而 HttpContext.Features 是设计用来存储 类型-实例 对的。

说的更清楚一点,HttpContext.Items 用来存储在当前请求上下文中共享的数据,而 HttpContext.Features 中是一个 IFeatureCollection 的实例,与 Items 完全不同。

该 IFeatureCollection 实例表示一组 HTTP 特性的集合,例如:

  1. IAuthenticationFeature 存储原始的 PathBase 和 原始的 Path.
  2. ISessionFeature 存储当前的 Session.
  3. IHttpConnectionFeature 存储了当前的底层连接
  4. 其它

为了便于存储和提取 类型-实例 对,IFeatureCollection 接口定义了如下 3 个重要方法:

public interface IFeatureCollection : IEnumerable<KeyValuePair<Type, object>>{
    // ...
    object this[Type key] { get; set; }
    TFeature Get<TFeature>();
    void Set<TFeature>(TFeature instance);
}

在 IFeatureCollection 的实现 FeatureCollection 中,将获取的值简单地转型为要求的类型:

public class FeatureCollection : IFeatureCollection
{
    // ... get the required type of feature
    public TFeature Get<TFeature>()
    {
        return (TFeature)this[typeof(TFeature)];    // note: cast here!
    }

    public void Set<TFeature>(TFeature instance)
    {
        this[typeof(TFeature)] = instance;          // note!
    }
}

就是这样设计的。因为在当前请求中不需要存储 2 个 IHttpConnectionFeature 实例,或者 2 个 ISession

尽管从技术上来说,你可以使用 FeatureColliection 来存储其它的 类型-值 对,最好不要这样做。如你所见,Set<TFeature>(TFeature instance) 方法在类型已经存储集合中的时候,会简单地替换掉原来的实例,这就意味着如果你希望存储同一类型的两个实例,是做不到的。

HttpContext.Items 是设计用来存储在单个请求中短期存在的数据。

HttpContext.Features 是设计用来共享不同的 HTTP 特性的,这使得中间件可以创建或者修改应用程序的主机处理管线。通过 .NET 本身已经创建了一系列的特性,例如 IHttpSendFileFeature。

应该只使用 HttpContext.Items 来存储数据,使用 HttpContext.Features 来添加新的其它中间件可能会使用的 HTTP 特性。

参考:

posted on 2022-04-06 10:28  冠军  阅读(541)  评论(0编辑  收藏  举报