对比 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 特性。

参考：

• https://docs.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.http.features?view=aspnetcore-6.0