-
Notifications
You must be signed in to change notification settings - Fork 450
WebApiClient进阶
老九 edited this page Mar 25, 2020
·
13 revisions
本章节将向读者讲解如何在不同的项目环境下,选择适合的方式来创建http声明接口的代理类。
接口声明
public interface IMyWebApi : IHttpApi { [HttpGet("user/{id}")] ITask<UserInfo> GetUserAsync(string id); }
初始化代码(只能调用一次)
HttpApi.Register<IMyWebApi>().ConfigureHttpApiConfig(c => { // 可以替换的序列化工具 c.JsonFormatter = null; c.XmlFormatter = null; c.KeyValueFormatter = null; // 参数验证和返回值验证,使用System.ComponentModel.DataAnnotations验证特性 c.UseParameterPropertyValidate = false; c.UseReturnValuePropertyValidate = false; // 请求主机和HttpClient相关配置 c.HttpHost = new Uri("http://localhost:9999/"); c.HttpClient.Timeout = TimeSpan.FromMinutes(2d); // 格式相关配置 c.FormatOptions.UseCamelCase = true; c.FormatOptions.DateTimeFormat = DateTimeFormats.ISO8601_WithMillisecond; // 响应缓存提供者配置,配合[CacheAttribute]来使用 c.ResponseCacheProvider = null; // 服务提供者,实例一般由DI创建得到 // 对于Asp.net core,此ServiceProvider应该为请求时创建的ServiceProvider,而不是ConfigureServices()创建的根ServiceProvider c.ServiceProvider = null; // 日志工厂,可以自主创建并赋值,如果保留为null,获取其实例时则从ServiceProvider获取 c.LoggerFactory = null; });
调用http请求代码
var myWebApi = HttpApi.Resolve<IMyWebApi>(); var user = await myWebApi.GetUserAsync("id001");
使用Register/Resolve的好处是在入口处只Register一次IMyWebApi,由HttpApiFactory自动接理IMyWebApi的生命周期管理。在使用中,不用处理myWebApi实例的释放(手动Dispose也不会释放),在一定的时间内都是获取到同一个myWebApi实例,当实例生命超过配置的周期时,自动被跟踪释放,并提供返回下一个一样配置的myWebApi实例。
接口声明
public interface IMyWebApi : IHttpApi { [HttpGet("user/{id}")] ITask<UserInfo> GetUserAsync(string id); }
Startup.cs配置依赖注入
public void ConfigureServices(IServiceCollection services) { services.AddHttpApi<IMyWebApi>(); services.ConfigureHttpApi<IMyWebApi>(o=> { o.HttpHost = new Uri("http://localhost:9999/"); ... }); }
Controller代码
public class HomeController : Controller { public async Task<UserInfo> Index([FromServices]IMyWebApi myWebApi) { return await myWebApi.GetUserAsync("id001"); } }
接口声明
public interface IMyWebApi : IHttpApi
{
[HttpGet("user/{id}")]
ITask<UserInfo> GetUserAsync(string id);
}
Global.asax.cs Application_Start
var builder = new ContainerBuilder(); builder.RegisterControllers(Assembly.GetExecutingAssembly()).PropertiesAutowired(); builder.Register(_ => new HttpApiFactory<IMyWebApi>() .ConfigureHttpApiConfig(c => { c.HttpHost = new Uri("http://localhost:9999/"); c.FormatOptions.DateTimeFormat = DateTimeFormats.ISO8601_WithMillisecond; })) .As<IHttpApiFactory<IMyWebApi>>() .SingleInstance(); builder.Register(c => c.Resolve<IHttpApiFactory<IMyWebApi>>().CreateHttpApi()) .As<IMyWebApi>() .InstancePerHttpRequest(); DependencyResolver.SetResolver(new AutofacDependencyResolver(builder.Build()));
Controller
public class HomeController : Controller { public IMyWebApi MyWebApi { get; set; } public async Task<ActionResult> Index() { var user = await this.MyWebApi.GetUserAsync("id001"); return View(user); } }