oslo RPC Client消息接口简介
admin
2023-07-31 21:20:08
0次

class oslo_messaging.RPCClient(transport, target, timeout=None, version_cap=None, serializer=None, retry=None)


RPCClient是用于在远程RPC服务器上调用方法的类。


transport:RPCClient通过transport向RPC server发送远程调用并接收响应。

支持两种模式:

RPC calls:适用于期望有调用响应的场景,远程调用方法并等待响应

RPC casts:适用于不需要RPC server返回响应的场景


client:用于控制如何将RPC request传递到服务器。如果只有topic(exchange可选)被设置,RPC能够被任何监听该topic(以及exchange)的servers服务,多个servers按照round-robin的方式轮流被选中。在RPC Cast场景下,通过设置target的"fanout"属性为True,可以把request广播到所有监听的servers。


在构造过程中创建默认target后,target属性能够在单独的方法调用中使用prepare方法进行重配置。


方法调用由请求上下文字典,方法名称和参数字典组成。

使用类封装RPC Client的例子:

class TestClient(object):

    def __init__(self, transport):
        target = messaging.Target(topic='test', version='2.0')
        self._client = messaging.RPCClient(transport, target)

    def test(self, ctxt, arg):
        return self._client.call(ctxt, 'test', arg=arg)

使用prepare方式重新设置target属性的例子:

def test(self, ctxt, arg):
    cctxt = self._client.prepare(version='2.5')
    return cctxt.call(ctxt, 'test', arg=arg)

另一个例子,设置超时时间:

def test(self, ctxt, arg):
    cctxt = self._client.prepare(timeout=10)
    return cctxt.call(ctxt, 'test', arg=arg)


如果连接无法完成,client会尝试重新建立连接,默认将无限期继续直到连接完成,可以设置retry次数:

client = messaging.RPCClient(transport, target, retry=None)
client.call(ctxt, 'sync')
try:
    client.prepare(retry=0).cast(ctxt, 'ping')
except messaging.MessageDeliveryFailure:
    LOG.error("Failed to send ping message")


call(ctxt, method, **kwargs)

call方法,触发调用并等待响应。

只允许返回单个响应值,不支持调用一个fanout模式的target。

在单一线程内能够保证多个call方法按顺序处理。

方法参数必须是原始类型或者客户端序列化器支持的类型(如果有)。 类似地,请求上下文必须是字典类型,除非客户端的序列化程序支持序列化另一个类型。


can_send_version(version=)

检查版本是否与版本上限兼容。


cast(ctxt, method, **kwargs)

触发方法并且不会为返回值阻塞。

cast() RPC请求可以广播到所有相匹配的servers。

cast会阻塞直到RPC request方法被messaging transport接受,但不确认方法是否被server调用。

cast保证方法不会在一个目的地被执行两次。

cast不保证执行顺序。

类似的,请求上下文必须是字典类型,除非客户端的序列化程序支持序列化另一个类型。


prepare(exchange=, topic=, namespace=, version=, server=, fanout=, timeout=, version_cap=, retry=)

准备方法调用上下文。

使用此方法覆盖单个方法调用的客户端属性。 例如:

def test(self, ctxt, arg):
    cctxt = self.prepare(version='2.5')
    return cctxt.call(ctxt, 'test', arg=arg)


exception oslo_messaging.RemoteError(exc_type=None, value=None, traceback=None)

表示远程端点方法引发了异常。

相关内容

热门资讯

空调连续工作多久需要停机休息 空调连续工作的时间取决于多个因素,包括空调的型号、功率、使用环境和维护情况等。一般来说,空调可以连续...
空调哪个符号是除湿的 空调除湿功能通常用一个水滴形状的符号表示。不同品牌和型号的空调遥控器可能会有所差异,但一般来说,除湿...
格力空调多长时间加一次氟利昂 1、一般情况下,空调对氟利昂的使用量是非常小的,所以在空调使用了四年左右的时候再考虑加也没问题。2、...
空调用多长时间需要加氟一次 一般情况下是五年。当出现以下这几种情况时,空调才需要加氟。1、空调的室内机和室外机各有两个接口,当接...
格调生活·C标思享荟:卡萨帝在... 9月12日的郑州龙湖金融岛,夜风轻拂,灯光璀璨。“C标时刻共传奇——卡萨帝思享荟暨20周年品牌盛典郑...
品牌价值破千亿、高端份额持续领... 9月12日,“C标时刻共传奇——卡萨帝思享荟暨20周年品牌盛典郑州站”在郑州龙湖金融岛举办。2026...
空调主板坏了修800还是换新的 空调主板坏了是修还是换新,需要考虑多个因素,以下是一些建议:1. 维修成本:如果维修费用较低,比如 ...
空调开多久需要休息多长时间 问题:空调开多久需要休息多长时间回答:1、在使用空调的过程中,一般空调开7~8个小时左右需要休息2~...
中央空调多长时间清洗一次 1、一般空调开机前清洗一次即可,空调开机中间时段再清洗一次,空调关机时清洗一次,这样比较合理。2、空...
中央空调氟利昂多久加一次 看空调制热和制冷程度,很多人的观点认为氟利昂必须一年放一次,其实这个观点是错误的,理解上面有点偏差,...