WebApiClient的SteeltoeOSS.Discovery扩展
1 背景
从园子里看到一些朋友在某些项目开发中,选择的架构是spring cloud搭建底层微服务框架,dotnet core来编写业务逻辑,SteeltoeOSS.Discovery是dotnet和spingcloud的桥梁,为dotnet提供服务注册和服务发现相关功能。在阅读朋友们文章的时候,我发现相关代码里的一些HttpClient相关问题,同时对dotnet寄居于spingcloud下由于没有Feign而产生的那些丑陋的http请求代码进行思考。本文将围绕原生的HttpClient的创建与释放的正确姿势和使用WebApiClient让dotnet也有媲美Feign的服务客户端两个面展开。
2 正确使用HttpClient
2.1 HttpClient的创建和释放
HttpClient有三个构造函数,最终都是调用到public HttpClient(HttpMessageHandler handler, bool disposeHandler)这个函数,HttpClient除了其handler参数之外,本身没有使用到需要Dispose的资源,其实现的IDispose也是为了Dispose掉handler参数而已。
HttpMessageHandler是一个抽象类,目前主要的HttpMessageHandler具体类型有HttpClientHanlder、SocketsHttpHandler和WebRequestHandler,但HttpClientHanlder在dotnet core2.1下是对和SocketsHttpHandler的包装实现。除了这些主要HttpMessageHandler,还有一个抽象的DelegatingHandler类型,用于实现请求管道,影响请求前后的数据逻辑。HttpClient的默认构造器,使用了HttpClientHanlder类型,同时disposeHandler为true,这时如果对HttpClient实例Dispose了,其内部的HttpClientHanlder自然也被Dispose了,
正确的创建和释放HttpClient例子
- 默认构造器
var httpClient = new HttpClient();
...你的代码...
httpClient.Dispose();
- HttpClient控制HttpMessageHandler
var handler = new HttpClientHandler();
var httpClient = new HttpClient(handler, true);
...你的代码...
httpClient.Dispose();
- HttpClient不控制外部HttpMessageHandler
var handler = 从外部来的HttpMessageHandler;
var httpClient = new HttpClient(handler, false);
...你的代码...
// 这里调用httpClient.Dispose()是无效的
// handler的生命周期应该由它的创建者来维护
// 如果这里Dispose掉handler,其它使用了这个handler的HttpClient实例受影响
不正确的创建和释放HttpClient的例子
- HttpMessageHandler被创建了,但没有释放
private readonly DiscoveryHttpClientHandler _handler;
private const string ProductUrl = "http://product/api/values";
public ValuesController(IDiscoveryClient client, ILoggerFactory logFactory)
{
_handler = new DiscoveryHttpClientHandler(client);
}
[HttpGet("product")]
public async Task<string> GoProductAsync()
{
var client = new HttpClient(_handler, false);
return await client.GetStringAsync(ProductUrl);
}
2.2 HttpClient的生命周期
HttpClient在设计之初,是非常适合使用单例模式的,也就是在应用域中,只维护一份HttpClient的实例就够了,因为它天生支持向不同域名同时多个并发请求。但单例的HttpClient没有遵守DNS 生存时间 (TTL) 设置,如果其HttpClientHandler第一次请求到www.baidu.com指向的ip为123.123.123.123,中途这个域名解析到的ip变化了,但HttpClient并不会自动应用这些变化。
在asp.net core
里,微软创建一个HttpClientFactory项目,用于提供HttpClient的创建和生命周期自动管理,完美解决到底选择单例还是每个请求创建和释放HttpClient这个左右难为的问题。所以在asp.net core
项目开发中,请别再写手动new HttpClient了,所有HttpClient的实例,都要由HttpClientFactory来创建,所有的外部HttpMessageHandler,也应该配置到HttpClientFactory,让它与HttpClient关联起来。
HttpClientFactory有三种使用方式:
- Using HttpClientFactory Directly
- Named Clients
- Typed Clients
具体的使用,可以查看3 ways to use HTTPClientFactory in ASP.NET Core 2.1这篇好文。
3 寄居下也有Feign
虽然已经讲解了怎么new一个HttpClient,怎么利用HttpClientFactory,但如果要寄居在spingcloud下,你还是得为请求一个服务接口编写大量的代码,这在java的Feign前面如同马车见到宝马。如果能利用WebApiClient这把利剑,结合HttpClientFactory与DiscoveryHttpClientHandler,你也能变成宝马。将这三者有机结合起来的项目,叫WebApiClient.Extensions.DiscoveryClient,它是WebApiClient的SteeltoeOSS.Discovery扩展项目,使用非常简单。
3.1 Nuget引用
PM> install-package WebApiClient.Extensions.DiscoveryClient
3.2 声明微服务的WebApiClient调用接口
[HttpHost("http://NET-API")]
public interface INetApi : IHttpApi
{
[HttpGet("api/values")]
ITask<string[]> GetValuesAsync();
[HttpGet("api/values/{id}")]
ITask<string> GetValuesAsync(int id);
}
3.3 Startup相关配置
// This method gets called by the runtime. Use this method to add services to the container.
public void ConfigureServices(IServiceCollection services)
{
services.AddDiscoveryClient(Configuration);
services.AddDiscoveryTypedClient<INetApi>();
...
}
// This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
...
app.UseDiscoveryClient();
}
3.4 Controller
public class HomeController : Controller
{
public async Task<string> Index([FromServices]INetApi netApi, int id = 0)
{
var values = await netApi.GetValuesAsync();
var value = await netApi.GetValuesAsync(id);
return "ok";
}
}
4. 结束语
本博主对HttpClient有着比较深入的了解,一直在维护WebApiClient项目,期间走过许许多多的“坑”,如果你有遇到HttpClient的相关问题,欢迎一起讨论解决。
WebApiClient的SteeltoeOSS.Discovery扩展的更多相关文章
- .NET Core微服务之基于Steeltoe使用Eureka实现服务注册与发现
Tip: 此篇已加入.NET Core微服务基础系列文章索引 => Steeltoe目录快速导航: 1. 基于Steeltoe使用Spring Cloud Eureka 2. 基于Steelt ...
- asp.net core microservices 架构之eureka服务发现
一 简介 微服务将需多的功能拆分为许多的轻量级的子应用,这些子应用相互调度.好处就是轻量级,完全符合了敏捷开发的精神.我们知道ut(单元测试),不仅仅提高我们的程序的健壮性,而且可以强制将类和方法的设 ...
- .NET Core HttpClient+Consul实现服务发现
简介 随着.NET Core的不断发展与成熟,基于.NET Core实现微服务的解决方案也越来越多.这其中必然需要注册中心,Consul成为了.NET Core实现服务注册与发现的首选.类似的解决方案 ...
- Elasticsearch是一个分布式可扩展的实时搜索和分析引擎,elasticsearch安装配置及中文分词
http://fuxiaopang.gitbooks.io/learnelasticsearch/content/ (中文) 在Elasticsearch中,文档术语一种类型(type),各种各样的 ...
- Windows Azure 安全最佳实践 - 第 6 部分:Azure 服务如何扩展应用程序安全性
多种Windows Azure服务可以帮助您将应用程序安全性扩展到云. 有三种服务可提供多个提供程序之间的身份标识映射.内部部署数据中心间的连接和相互发送消息的应用程序功能(无论应用程序位于何处). ...
- [认证授权] 5.OIDC(OpenId Connect)身份认证授权(扩展部分)
在上一篇[认证授权] 4.OIDC(OpenId Connect)身份认证授权(核心部分)中解释了OIDC的核心部分的功能,即OIDC如何提供id token来用于认证.由于OIDC是一个协议族,如果 ...
- 使用WebApiClient请求和管理Restful Api
前言 本篇文章的内容是WebApiClient应用说明篇,如果你没有了解过WebApiClient,可以先阅读以下相关文章: WebApi client 的面向切面编程 我来给.Net设计一款Http ...
- 2015 ICL, Finals, Div. 1 Ceizenpok’s formula(组合数取模,扩展lucas定理)
J. Ceizenpok’s formula time limit per test 2 seconds memory limit per test 256 megabytes input stand ...
- [认证授权] 5.OIDC(OpenId Connect)身份认证(扩展部分)
在上一篇[认证授权] 4.OIDC(OpenId Connect)身份认证(核心部分)中解释了OIDC的核心部分的功能,即OIDC如何提供id token来用于认证.由于OIDC是一个协议族,如果只是 ...
随机推荐
- BZOJ_1391_[Ceoi2008]order_最大权闭合子图
BZOJ_1391_[Ceoi2008]order_最大权闭合子图 Description 有N个工作,M种机器,每种机器你可以租或者买过来. 每个工作包括若干道工序,每道工序需要某种机器来完成,你可 ...
- Python 命令行(CLI)基础库
在 CLI 下写 UI 应用 前阵子看了一下自己去年写的 Python-视频转字符动画,感觉好糗..所以几乎把整篇文章重写了一遍.并使用 curses 库实现字符动画的播放. 但是感觉,curses ...
- python 将os.getcwd()获取路径中的\替换成\\
通过os.getcwd()获取的路径为:D:\Auto\test\mobule,实际需要修改为:D://Auto//test//mobule 代码实现如下: import osb = os.getcw ...
- 记录遭遇挖矿程序kthrotlds的失败处理经历
1 发现问题 在腾讯云上购买了一个centos7的服务器,平时用来练手,偶尔也安装一些程序进行测试,上面安装了mysql和redis,前段时间数据库经常掉线,连不上,到腾讯云后台进行查看,通过服务器实 ...
- JAVA基础第三章-类与对象、抽象类、接口
业内经常说的一句话是不要重复造轮子,但是有时候,只有自己造一个轮子了,才会深刻明白什么样的轮子适合山路,什么样的轮子适合平地! 我将会持续更新java基础知识,欢迎关注. 往期章节: JAVA基础第一 ...
- 漏洞经验分享丨Java审计之XXE(下)
上篇内容我们介绍了XXE的基础概念和审计函数的相关内容,今天我们将继续分享Blind XXE与OOB-XXE的知识点以及XXE防御方法,希望对大家的学习有所帮助! 上期回顾 ◀漏洞经验分享丨Java ...
- 腾讯云发布runC容器逃逸漏洞修复公告
尊敬的腾讯云客户,您好: 近日,腾讯云安全中心监测发现轻量级容器运行环境runc被爆存在容器逃逸漏洞,攻击者可以在利用该漏洞覆盖Host上的runc文件,从而在Host上以root权限执行代码. 为 ...
- [转载]学习Javascript闭包(Closure)
学习Javascript闭包(Closure) 源地址: http://www.ruanyifeng.com/blog/2009/08/learning_javascript_closures ...
- java游戏开发杂谈 - java编程怎么学
java语言包含很多的知识点,我们并不需要把java语言的知识点都学全了,才开始编程. 你只需要了解: 1,java的数据类型和变量定义 2,类和对象的初步印象. 3,if-else, wh ...
- vue客户端渲染首屏优化之道
提取第三方库,缓存,减少打包体积 1. dll动态链接库, 使用DllPlugin DllReferencePlugin,将第三方库提取出来另外打包出来,然后动态引入html.可以提高打包速度和缓存第 ...