WebApiClient与Asp.net core DI的结合

1 WebApiClient

一款基于HttpClient封装，只需要定义c#接口并修饰相关特性，即可异步调用远程http接口的客户端库

• WebApiClient
• WebApiClient.Extensions
• WebApiClient.Tools

2 Http接口的注册与提供

2.1 声明远程端http接口

public interface IBaiduApi : IHttpApi
{
    [HttpGet("/s")]
    ITask GetAsync(string word);
}

2.2 远程端http的注册

使用HttpClientFactory管理HttpClient的创建，利用AddTypedClient创建远程http接口的WebApiClient调用代理，同时给HttpApiConfig配置ServiceProvider实例。

// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
    services.AddHttpApiTypedClient().ConfigureHttpApiConfig((c, p) =>
    {
        c.HttpHost = new Uri("http://www.baidu.com/");
    });
}

/// 

/// 添加HttpApiClient的别名HttpClient
/// 
/// 接口类型
/// 
/// 配置选项
/// 
/// 
public static IHttpClientBuilder AddHttpApiTypedClient(this IServiceCollection services, Action configOptions)
    where TInterface : class, IHttpApi
{
    if (configOptions == null)
    {
        throw new ArgumentNullException(nameof(configOptions));
    }

    return services
        .AddHttpClient()
        .AddTypedClient((httpClient, provider) =>
        {
            var httpApiConfig = new HttpApiConfig(httpClient)
            {
                ServiceProvider = provider
            };
            configOptions.Invoke(httpApiConfig, provider);
            return HttpApiClient.Create(httpApiConfig);
        });
}

2.3 远程端http接口的提供

可以使用构造器注入IBaiduApi或[FromServices]特性得到远程接口代理实例。

public class HomeController : Controller
{   
    // GET: //
    public async Task Index([FromServices] IBaiduApi baiduApi)
    {
        var html = await baiduApi.GetAsync("WebApiClient");
        return Content(html);
    }
}

3 WebApiClient过滤器的服务提供

3.1 在接口上使用自定义LogFilter

[LogFilter]
public interface IBaiduApi : IHttpApi
{
    [HttpGet("/s")]
    ITask GetAsync(string word);
}

3.2 使用context.GetService获取服务实例

class LogFilter : ApiActionFilterAttribute
{
    public override Task OnBeginRequestAsync(ApiActionContext context)
    {
        var logger = context.GetService().CreateLogger("Baidu");
        logger.LogWarning($"request {context.ApiActionDescriptor.Name} {context.RequestMessage.RequestUri}");

        return base.OnBeginRequestAsync(context);
    }
}

3.3 日志服务输出日志样例

warn: Baidu[0]
      request GetAsync http://www.baidu.com/s?word=WebApiClient