GRPC學習記錄

RPC是遠程過程調用（Remote Procedure Call）
GRPC是google出的高性能、開源的通用RPC框架

優點： 1、接口有更嚴格的約束 2、更安全 3、性能更好 。
這3個優點來源於gRPC使用的protobuf（一種數據傳輸格式和規範）

ERP系統
SAP系統

構建一個GPRC helloworld項目：

1、項目目錄結構

    grpc_helloworld:
        protos
            helloworld.proto
        rpc_package
            __init__.py
            helloworld_pb2.py
            helloworld_pb2_grpc.py
        hello_server.py
        hello_client.py

2、安裝protobuf依賴
 

   pip install grpcio-tools

3、通過protobuf來定義接口和數據類型
    helloworld.proto如下：    

syntax = "proto3";

    package rpc_package;

    // define a service
    service HelloWorldService {
        // define the interface and data type
        rpc SayHello (HelloRequest) returns (HelloReply) {}
    }

    // define the data type of request
    message HelloRequest {
        string name = 1;
    }

    // define the data type of response
    message HelloReply {
        string message = 1;
    }

4、使用gRPC protobuf生成工具生成對應語言的庫函數
  

  python -m grpc_tools.protoc -I=./protos --python_out=./rpc_package --grpc_python_out=./rpc_package ./protos/helloworld.proto

5、編寫gRPC server端代碼
    hello_server.py如下：    

from concurrent import futures
    import grpc
    import logging
    import time

    from rpc_package.helloworld_pb2_grpc import add_HelloWorldServiceServicer_to_server, \
        HelloWorldServiceServicer
    from rpc_package.helloworld_pb2 import HelloRequest, HelloReply


    class Hello(HelloWorldServiceServicer):

        # 這裏實現我們定義的接口
        def SayHello(self, request, context):
            return HelloReply(message='Hello, %s!' % request.name)


    def serve():
        # 這裏通過thread pool來併發處理server的任務
        server = grpc.server(futures.ThreadPoolExecutor(max_workers=10))

        # 將對應的任務處理函數添加到rpc server中
        add_HelloWorldServiceServicer_to_server(Hello(), server)

        # 這裏使用的非安全接口，世界gRPC支持TLS/SSL安全連接，以及各種鑑權機制
        server.add_insecure_port('[::]:50000')
        server.start()
        try:
            while True:
                time.sleep(60 * 60 * 24)
        except KeyboardInterrupt:
            server.stop(0)


    if __name__ == "__main__":
        logging.basicConfig()
        serve()

6、編寫gRPC client端代碼
    hello_client.py如下：

    from __future__ import print_function
    import logging

    import grpc
    from rpc_package.helloworld_pb2 import HelloRequest, HelloReply
    from rpc_package.helloworld_pb2_grpc import HelloWorldServiceStub


    def run():
        # 使用with語法保證channel自動close
        with grpc.insecure_channel('localhost:50000') as channel:
            # 客戶端通過stub來實現rpc通信
            stub = HelloWorldServiceStub(channel)

            # 客戶端必須使用定義好的類型，這裏是HelloRequest類型
            response = stub.SayHello(HelloRequest(name='eric'))
        print("hello client received: " + response.message)


    if __name__ == "__main__":
        logging.basicConfig()
        run()

7、進入虛擬環境，運行server
 

   python hello_server.py

8、運行client

    python hello_client.py