5.37启用 ETag 响应缓存

ETag（实体标签）是 HTTP 协议中用于标识资源版本的一种机制。服务器在响应头中返回资源的 ETag 值（例如 "abc123"），客户端在后续请求中可通过 If-None-Match 头携带该值。若资源未发生变化，服务器返回 304 Not Modified，无需重新传输内容；否则返回新内容及新的 ETag。

启用 ETag 缓存后，框架会自动处理这一过程：首次请求缓存响应及 ETag，后续请求自动附加 If-None-Match；收到 304 状态码时直接复用缓存内容，减少数据传输并提升请求效率。在弱网环境或移动端流量计费场景下，这一机制能显著降低带宽消耗，同时加快响应速度。

HTTP 声明式请求通过 UseETagAttribute 特性来启用 ETag 响应缓存。相应的 HTTP 声明式提取器实现为 UseETagDeclarativeExtractor 类型，该类型负责解析 UseETagAttribute 特性并构建 HttpRequestBuilder 实例所需的启用 ETag 响应缓存配置。

12345678910111213

// 在接口定义上应用，影响所有方法[UseETag]public interface IHttpService : IHttpDeclarative{    // 在方法上应用    [UseETag]    [Get("https://furion.net/")]    Task<string> GetStringAsync();    [UseETag(false)]   // 禁用该功能    [Get("https://furion.net/")]    Task<string> GetStringAsync();}

UseETagAttribute 包含以下构造函数和属性：

• 构造函数：

  • new()：作用于方法或接口，启用 ETag 响应缓存。
  • new(enabled)：作用于方法或接口，设置是否启用 ETag 响应缓存。

• 属性：

  • Enabled：是否启用（bool 类型），默认值为 true（启用）。