WebApiClient與Asp.net core DI的結合
阿新 • • 發佈:2019-02-26
過濾器 tel pap col ask 相關 ilo 結合 客戶端
1 WebApiClient
一款基於HttpClient封裝,只需要定義c#接口並修飾相關特性,即可異步調用遠程http接口的客戶端庫
- WebApiClient
- WebApiClient.Extensions
- WebApiClient.Tools
2 Http接口的註冊與提供
2.1 聲明遠程端http接口
public interface IBaiduApi : IHttpApi
{
[HttpGet("/s")]
ITask<string> 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<IBaiduApi>().ConfigureHttpApiConfig((c, p) => { c.HttpHost = new Uri("http://www.baidu.com/"); }); }
/// <summary> /// 添加HttpApiClient的別名HttpClient /// </summary> /// <typeparam name="TInterface">接口類型</typeparam> /// <param name="services"></param> /// <param name="configOptions">配置選項</param> /// <exception cref="ArgumentNullException"></exception> /// <returns></returns> public static IHttpClientBuilder AddHttpApiTypedClient<TInterface>(this IServiceCollection services, Action<HttpApiConfig, IServiceProvider> configOptions) where TInterface : class, IHttpApi { if (configOptions == null) { throw new ArgumentNullException(nameof(configOptions)); } return services .AddHttpClient<TInterface>() .AddTypedClient((httpClient, provider) => { var httpApiConfig = new HttpApiConfig(httpClient) { ServiceProvider = provider }; configOptions.Invoke(httpApiConfig, provider); return HttpApiClient.Create<TInterface>(httpApiConfig); }); }
2.3 遠程端http接口的提供
可以使用構造器註入IBaiduApi或[FromServices]特性得到遠程接口代理實例。
public class HomeController : Controller
{
// GET: /<controller>/
public async Task<IActionResult> 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<string> GetAsync(string word);
}
3.2 使用context.GetService獲取服務實例
class LogFilter : ApiActionFilterAttribute
{
public override Task OnBeginRequestAsync(ApiActionContext context)
{
var logger = context.GetService<ILoggerFactory>().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
WebApiClient與Asp.net core DI的結合