3.82HttpRequestBuilder 统一配置器

创建于 2026 年 8 月 17 日约 1 分钟读完

在通过 HttpRequestBuilder 类构建 HttpRequestMessage 对象时,若需对所有请求进行全局配置,框架提供了统一的配置机制。

开发者可通过实现 IHttpRequestBuilderConfigurator 接口,对 HttpRequestBuilder 实例进行统一设置。例如,以下 RequestBuilderConfigurator 类在 Configure 方法中为所有请求添加了一个公共请求头:

cs
public class HttpRequestBuilderConfigurator : IHttpRequestBuilderConfigurator{    /// <inheritdoc />    public void Configure(HttpRequestBuilder httpRequestBuilder)    {        httpRequestBuilder.WithHeader("global", "form_furion");    }}

实现自定义配置器后,需在配置 HttpRemoteOptions 时将其赋值给 RequestBuilderConfigurator 属性:

cs
services.AddHttpRemote(builder => {})    .ConfigureOptions(options =>    {        options.RequestBuilderConfigurator = new HttpRequestBuilderConfigurator();    });

配置生效后,所有 HttpRequestBuilder 实例在调用 Build() 方法构建 HttpRequestMessage 之前,均会执行此统一配置逻辑。