一个简单RPC框架是怎么炼成的(II)——制定RPC消息

一个简单RPC框架是如何炼成的(II)——制定RPC消息

开局篇我们说了，RPC框架的四个核心内容

RPC数据的传输。
RPC消息协议
RPC服务注册
RPC消息处理

下面，我们先看一个普通的过程调用

class Client(object):
    
    def __init__(self):
        self.remote = None
    
    ##
    # 内部是委托给远程remote对象来获取结果。
    def sayHello(self):
        if self.remote: return self.remote.sayHello()
        else : return None
    
class Server(object):
    
    def __init__(self):
        pass
    
    def sayHello(self):
        return 'Hello World'    


if __name__ == '__main__':
    server = Server()
    client = Client()
    client.remote = server
    print(client.sayHello())

这是一个常见的过程调用的例子，client调用sayHello，实际委托给Server的sayHello方法来实现。但他不是RPC调用，因为起码不是远程的，另外，也没有我们提到的四个核心内容。于是我们的任务就是通过一点点的代码修改，为其引入RPC框架。

第一步，订协议。俗话说得好，没有规矩不成方圆。

还是继续能多简单就多简单。

RPC请求：Request，包含一个请求id 和一个请求命令，如‘sayHello'

class Request(object):
    '''
    @RPC请求，包含命令id和请求内容两部分。这个实现，与具体的RPC协议相关。
    @这里是简化起见，采用python自身的字典作为其协议的数据结构
    '''


    def __init__(self):
        '''
        Constructor
        '''
        self.id = 0 #id的作用在于将Request和Response建立绑定关系.在异步调用时就有用
        self.command = None #sayHello
        
    def __str__(self):
        return ''.join(('id: ', str(self.id),  '   command: ', str(self.command)))

同样的，对RPC Response，也定义如下

class Response(object):
    '''
    @RPC回复。 包含答复id和执行结果两部分内容。其中答复id与对应的请求id一致。
    @简单起见，协议的实现使用python自家的字典
    '''


    def __init__(self):
        '''
        Constructor
        '''
        self.id = 0
        self.result = None
    
    def __str__(self):
        return ''.join(('id: ', str(self.id),  '   result: ', str(self.result)))

定义好协议之后，我就对Client稍作修改，将原来直接的接口调用 self.remote.sayHello更改为 send Request （command='sayHello'）

    def sayHello(self):
        req = Request() // 构建一个RPC请求消息
        req.id = 1
        req.command = 'sayHello'
        return self.request(req)
  
    def request(self, req):
        rsp = self.remote.procRequest(req) // 将请求消息发送给远程服务端。但因为传输层这里还没实现，所以先暂时还是直接调用远端接口
        return rsp.result

然后，服务端也要相应修改，需要根据request请求中的command命令，调用具体的方法，并将执行结果封装到Response中，返回给客户端。

def procRequest(self,req):
        rsp = Response()
        rsp.id = req.id   
        if req.command == 'sayHello':
            rsp.result = self.sayHello()
        else:
            raise Exception("unknown command")
        
        return rsp

到这里，RPC框架中的RPC消息已经初具雏形，不过

我们并没有实现相应的encode和decode方法，没有基于可以跨设备的字符串传输，而是直接的内存变量传递。
现在的RPC request不支持带参数的请求命令。如add(a, b), 如何在RPC消息中描述参数a,b 。

这些问题我们在后面还会继续展开处理

一个简单RPC框架是怎么炼成的(II)——制定RPC消息

相关推荐