【TARS】TARS-CPP客户端学习一

最新推荐文章于 2023-07-17 22:52:19 发布

原创最新推荐文章于 2023-07-17 22:52:19 发布 · 1.2k 阅读

4 ·

CC 4.0 BY-SA版权

tars 专栏收录该内容

36 篇文章

订阅专栏

TARS客户端的核心是Communicator类，它管理网络线程和对象代理，通过ServantProxyFactory生成服务代理ServantProxy进行RPC调用。CommunicatorEpoll处理网络I/O，ObjectProxyFactory生成服务实体ObjectProxy，协同AdapterProxy管理服务连接。异步回调由AsyncProcThread处理，而TC_CasQueue和ReqMessage则涉及请求队列管理。

部署运行你感兴趣的模型镜像

TARS的客户端最重要的类是Communicator，一个客户端只能声明出一个Communicator类实例，用户可以通过
CommunicatorPtr& Application::getCommunicator()获取线程安全的Communicator类单例。Communicator
类聚合了两个比较重要的类，一个是CommunicatorEpoll，负责网络线程的建立与通过ObjectProxyFactory生
成ObjectProxy；另一个是ServantProxyFactory，生成不同的RPC服务句柄，即ServantProxy，用户通过
ServantProxy调用RPC服务。下面简单介绍几个类的作用。

2.2 Communicator

一个Communicator实例就是一个客户端，负责与服务端建立连接，生成RPC服务句柄，可以通过
CommunicatorPtr& Application::getCommunicator()获取Communicator实例，用户最后不
要自己声明定义新的Communicator实例.

2.3 ServantProxy与ServantProxyFactory

ServantProxy就是一个服务代理，ServantProxy可以通过ServantProxyFactory工厂类生成，用户往往通过
Communicator的template void stringToProxy()接口间接调用ServantProxyFactory的
ServantPrx::element_type* getServantProxy()接口以获取服务代理，通过服务代理ServantProxy，用户
就可以进行RPC调用了. ServantProxy内含多个服务实体ObjectProxy（详见下文第4小点）, 能够帮助用户在
同一个服务代理内进行负载均衡.

2.4 CommunicatorEpoll

CommunicatorEpoll类代表客户端的网络模块，内含TC_Epoller作为IO复用，能够同时处理不同主调线程
（caller线程）的多个请求。CommunicatorEpoll内含服务实体工厂类ObjectProxyFactory（详见下文），
意味着在同一网络线程中，能够产生不同服务的实体，能够完成不同的RPC服务调用。CommunicatorEpoll还聚
合了异步调用处理线程AsyncProcThread，负责接收到异步的响应包之后，将响应包交给该线程处理.

2.5 ObjectProxy与ObjectProxyFactory

ObjectProxy类是一个服务实体，注意与ServantProxy类是一个服务代理相区别，前者表示一个网络线程上的某
个服务实体A，后者表示对所有网络线程上的某服务实体A的总代理，更详细的介绍可见下文。ObjectProxy通过
ObjectProxyFactory生成，而ObjectProxyFactory类的实例是CommunicatorEpoll的成员变量，意味着一个
网络线程CommunicatorEpoll能够产生各种各样的服务实体ObjectProxy，发起不同的RPC服务. ObjectProxy
通过AdapterProxy来管理对服务端的连接。