请求分析工具

在现代化的浏览器中，通常内置了开发者工具，这些工具能够捕获并直观展示用户访问网站时的所有请求与响应数据。类似地，我们也为 HTTP 远程请求模块提供了一套分析工具。

启用方式#

以下是如何启用请求分析工具的示例：

// 构建器方式await httpRemoteService.SendAsync(HttpRequestBuilder.Get("https://furion.net")    .WithHeader("X-Header", "custom")    .Profiler());   // 启用请求分析工具，或使用 Debugger()// HTTP 请求谓词方式await httpRemoteService.GetAsync("https://furion.net"    , builder => builder.Profiler());   // 启用请求分析工具，或使用 Debugger()// 还可以获取请求分析工具的分析数据await httpRemoteService.GetAsync("https://furion.net"    , builder => builder.Profiler(analyzer =>    {        Console.WriteLine(analyzer.Data);    }));

启用后，当执行 HTTP 远程请求时，控制台将输出如下详细信息：

Request Headers:    User-Agent:      Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/142.0.0.0 Safari/537.36 Edg/142.0.0.0    X-Header:        customGeneral:    Request URL:               https://furion.net/    Request Method:            GET    Status Code:               200 OK    HTTP Version:              1.1    HTTP Content:    Content Type:    HttpClient Name:    Request Duration (ms):     149.00Response Headers:    Server:             nginx/1.22.1    Date:               Thu, 14 Nov 2024 15:35:41 GMT    Connection:         keep-alive    Vary:               Accept-Encoding    ETag:               "67091697-f32f"    Cache-Control:      max-age=315360000    Accept-Ranges:      bytes    Content-Type:       text/html    Content-Length:     62255    Last-Modified:      Fri, 11 Oct 2024 12:14:15 GMT    Expires:            Thu, 31 Dec 2037 23:55:55 GMT

全局启用与高级配置#

此外，除了为单个请求启用分析工具，还可以全局注册以在 HttpClient 中启用：

// 为默认客户端启用services.AddHttpClient(string.Empty)    .AddProfilerDelegatingHandler();// 还可以提供条件禁用，例如生产环境中禁用services.AddHttpClient(string.Empty)    .AddProfilerDelegatingHandler(disableIn: () => builder.Environment.EnvironmentName == "Production");services.AddHttpClient(string.Empty)    .AddProfilerDelegatingHandler(disableInProduction: true);// 为特定客户端启用//services.AddHttpClient("weixin")//    .AddProfilerDelegatingHandler();// 还可以一键为所有客户端配置启用services.ConfigureHttpClientDefaults(clientBuilder =>    clientBuilder.AddProfilerDelegatingHandler());// 或使用 IHttpRemoteBuilder 扩展方法进行一键配置services.AddHttpRemote()    .ConfigureHttpClientDefaults(clientBuilder => clientBuilder.AddProfilerDelegatingHandler());

声明式请求中的使用#

同时，HTTP 声明式请求也支持通过 [Profiler] 特性启用请求分析工具：

[Profiler]  // 为接口内所有方法启用请求分析工具public interface IHttpService : IHttpDeclarative{    [Get("https://furion.net")]    Task<string> ProfilerMethod();    [Profiler(false)]   // 关闭该方法请求分析工具    [Get("https://furion.net")]    Task<string> NonProfilerMethod();}public interface IHttpService : IHttpDeclarative{    [Get("https://furion.net")]    Task<string> NonProfilerMethod();    [Profiler]   // 启用该方法请求分析工具    [Get("https://furion.net")]    Task<string> ProfilerMethod();}

通过启用请求分析工具，开发者能够更直观、便捷地观察和调试 HTTP 请求，从而提升开发效率与调试准确性。

自定义日志输出目标#

默认情况下，请求分析工具的信息会通过 Console.WriteLine 输出到控制台。但在 WinForms、WPF 或 MAUI 等环境中，控制台输出可能不可见或不被支持。此时，您可以通过配置 FallbackLogger 将日志重定向到其他目标，例如调试输出（System.Diagnostics.Debug.WriteLine）：

services.AddHttpRemote(builder => {})    .ConfigureOptions(options =>    {        // 日志服务或控制台输出不可用时的备用日志输出委托        options.FallbackLogger = message => System.Diagnostics.Debug.WriteLine(message);    });

这样，分析信息便会显示在 Visual Studio 的“输出”窗口（调试视图）或其他调试器所支持的位置。