.NET Core 2.1中HttpClientFactory的最佳实践记录
前言
asp.net core 2.1中出现一个新的httpclientfactory功能,
它有助于解决开发人员在使用httpclient实例从其应用程序发出外部web请求时可能遇到的一些常见问题。
介绍
在.netcore平台的2.1新增了httpclientfactory,虽然httpclient这个类实现了disposable,但使用它的时候用声明using包装块的方式通常不是最好的选择。处理httpclient,底层socket套接字不会立即释放。该httpclient类是专为多个请求重复使用而创建的。需要不同的基地址,不同的http标头和其他对请求个性化操作的场景时,需要手动管理多个httpclient实例,为了简化httpclient实例管理,.net core 2.1提供了一个新的httpclientfactory - 它可以创建,缓存和处理httpclient实例。
什么是httpclientfactory?
用asp.net团队的话说:“an opinionated factory for creating httpclient instances”(一个用于创建httpclient实例的最佳实践的工厂),并且是asp.net core 2.1发布的新功能。根据大家以前使用httpclient的经验,您可能遇到一些困扰的问题,有时甚至没有意识到您有问题(只是在并发并不大的场景没触发而已)。
第一个问题是当你在代码中创建太多的httpclients时,这反过来会产生两个问题......
- 这是低效的,因为每个请求都有自己的远程服务器连接池。这意味着您需要为每个创建的客户端支付重新连接到该远程服务器的成本。
- 更大的问题是如果你创建了很多httpclient并使用到他们,你可以遇到socket耗尽,而你基本上已经太快地使用了过多的socket。您可以同时打开多个socket是有限制的。当您dispose销毁httpclient时,它打开的连接在time_wait状态下保持打开状态最长240秒(如果来自远程服务器的任何数据包仍然通过)。
httpclient实现了idisposable,这通常会导致开发人员在使用idisposable对象时遵循正常模式,在using块中创建它。这样可以确保一旦完成对象并且它已经超出范围,就可以正确销毁对象。
因此,最优的方法是重用httpclient实例,以便也可以重用连接。httpclient是一个可变对象,但只要你没有运行期改变它,它实际上是线程安全的并且可以共享。因此,一种常见的方法是将其注册为具有di框架的单例模式,或者创建包含static静态实例的对象。
但是,这会产生新问题。以这种方式使用单个httpclient将保持连接打开并且不遵守dns生存时间(ttl)设置(总之就是同一个httpclient实例只能有一个请求头,在被请求方发生更改时,由于是单例不能做个性化改变,否则导致其他请求失败)。现在连接将永远不会获得dns更新,因此您正在与之通信的服务器将永远不会更新其地址。在某些情况下,这是完全有可能的,在以上这种情况下,您可以平衡许多主机,这些主机可能随着时间的推移而改变,或者可能使用blue/green 部署推出新服务。如果服务器消改变,则您的连接使用的ip可能不再响应您通过单个httpclient发出的请求。
所以需要我们手动去管理每类服务器的httpclient的实例来进行个性化请求头的构造和发起请求!
httpclientfactory旨在帮助您开始解决这些问题,并提供了一种新的机制来创建在幕后为我们正确管理的httpclient实例。它将为我们“做管理httpclient的事”,我们可以专注于业务!虽然在参考httpclient时提到了上述问题,但事实上问题的根源实际上发生在httpclient上,httpclient使用了httpclienthandler。httpclientfactory管理处理程序的生命周期,以便我们有一个可以重用的池,同时还可以(rotating)轮换它们以使dns不会过时。
使用httpclient的昂贵部分实际上是创建httpclienthandler和连接。以这种httpclientfacotry方式汇集这些内容意味着我们可以更高效利用资源最节省地使用我们系统上的socket。当您使用httpclientfactory请求httpclient时,实际上每次都会获得一个新实例,这意味着我们不必担心会改变它的状态。此httpclient可能(或可能不)使用池中的现有httpclienthandler,从而使用现有打开的连接。
默认情况下,每个新创建的httpclienthandler(派生自httpmessagehandler)生命周期只有2分钟。通过services.addhttpclient()创建httpclientfactory实例时,可以根据每一个命名的client客户机进行控制。达到生命周期后,处理程序将不会立即被释放掉,而是放入过期的池中。任何依赖于httpclientfactory的处理程序链的客户端都可以继续使用它而没有任何问题。有一个后台作业检查过期的池,以查看处理程序的所有引用是否已在scope之外,此时可以将其释放掉。处理程序链过期后对新客户端的任何新请求都将获得新的处理程序链。
这种方法运行得相当不错,但.net core方面还有其他一些事情可能会进一步改善这种情况。.net core团队开发了一个新的managedhandler,它可以更正确地管理dns,原则上可以保持更长时间,这意味着可以更有效地共享连接。这个新的处理程序还被设计为在不同的操作系统中更加一致地运行。在该工作完成之前,上面的处理程序池是一个合理的解决方法。
如何使用httpclientfactory
我们将首先创建一个简单的webapi项目
接下来,我们需要转到我们的startup.cs文件并注册一个服务。
services.addhttpclient(); services.addscoped(typeof(classinservice));//此处无关httpclient,请暂时忽视他
在幕后,这将注册一些必需的服务,其中一个是ihttpclientfactory的实现。接下来,我们在业务中使用他
public class classinservice { /// <summary> /// 构建器 /// </summary> /// <param name="clientfactory"></param> public classinservice(ihttpclientfactory clientfactory) { _clientfactory = clientfactory; } }
private void httpclientfactorytest() { var client = _clientfactory.createclient("这是专门用来连接博客园的");//必须和services.addhttpclient()中指定的名称对应 var content = new stringcontent($"sid={sid}&safekey={111}"); content.headers.contenttype = new mediatypeheadervalue("application/x-www-form-urlencoded"); var response = client.postasync("myblogurl", content); }
这里我们首先添加对ihttpclientfactory的依赖,它将由di系统注入classinservice。ihttpclientfactory允许我们请求和接收httpclient实例。
我们使用httpclientfactory创建客户端。在幕后,httpclientfactory将为我们创建一个新的httpclient。但是等等,之前说过为每个请求使用新的httpclient是很糟糕。但此处的创建的httpclient是在他所管理的池子中,并不每个请求都会是新的socket。
httpclientfactory收集这些httpclienthandler实例并管理它们的生命周期,以解决之前提到的一些问题。每次我们要求httpclient时,我们都会得到一个新实例,它可能(或可能不)使用现有的httpclienthandler。httpclient本身并没有问题。
一旦创建,由此创建的所有httpclienthandler将被默认保持约2分钟。这意味着针对同一个createclient的任何新请求都可以共享处理程序,因此也可以共享连接。当httpclient存在时,它的处理程序将保持可用状态,并且它将再次共享连接。
两分钟后,每个httpclienthandler都标记为已过期。过期状态只是标记它们,以便在创建任何新的httpclient实例时不再使用它们。但是,它们不会立即销毁,因为其他httpclient实例可能正在使用它们。httpclientfactory使用后台服务监视过期的处理程序,一旦它们不再被引用,就可以正确释放它们,也允许它们的连接被关闭。
概要
通过使用httpclientfactory我们不需要考虑如何管理httpclient的生命周期或担心遇到dns问题。以上只是httpclient小小的最佳使用推荐,还有其他高级用法,例如和polly的结合使用。
参考:https://www.stevejgordon.co.uk/introduction-to-httpclientfactory-aspnetcore
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对的支持。