您现在的位置：程式碼之家 >> 編程語言 > >> C語言 >> C++ >> C++ 入門

FFRPC Python 客戶端庫：實現 Python 與 C++ 服務器的高效通信

編輯：C++ 入門

項目背景

FFRPC 是一款高性能 C++ 異步 RPC 框架，廣泛應用於遊戲服務器開發中。在微服務架構下，Gate Server、Game Server、DB Server 等進程間通信至關重要。FFRPC 通過 Broker 模式封裝位置透明性，使得調用方僅需知道服務名即可發起調用，無需關心目標服務的具體部署拓撲，極大簡化了系統架構。

早期 FFRPC 僅提供 C++ 客戶端/服務端實現。但在實際項目中，常需由腳本語言（Python、PHP 等）調用 C++ 服務接口——例如 GM 後台、運營工具、Web 管理界面等。為滿足這類跨語言調用需求，FFRPC 推出了 Python 客戶端庫 ffrpc-py。

核心特性

協議兼容：支持 Protocol Buffers 和 Thrift 兩大主流序列化協議，與 C++ 服務端協議保持一致
同步調用模型：C++ 服務端採用異步非阻塞 IO，但 Python 客戶端提供同步阻塞式調用介面（req → ret 一一對應），使用體驗如同調用本地函數
Broker 透明路由：客戶端僅需連接 Broker，由 Broker 負責服務發現與路由，無需感知後端服務拓撲變化
異常安全：調用失敗返回 False，可通過 error_msg() 獲取詳細錯誤信息

快速開始：Thrift Echo 服務調用示例

1. Thrift 服務定義

namespace cpp ff
namespace py ff

service EchoService {
    string echo(1: string msg)
}

2. Python 客戶端代碼

from ffrpc import ffclient_t
from ff.ttypes import echo_thrift_in_t

# Broker 地址
HOST = "127.0.0.1"
PORT = 10246

# 創建客戶端，第三個參數為超時時間（秒）
client = ffclient_t(HOST, PORT, 1.5)

# 構造請求參數
req = echo_thrift_in_t()
req.msg = "Hello FFRPC!"

# 調用遠程服務
ret = echo_thrift_in_t()  # 返回值對象
success = client.call("echo_service", req, ret, "ff")

if success:
    print(f"調用成功: {ret.msg}")
else:
    print(f"調用失敗: {client.error_msg()}")

3. 關鍵參數解析

參數	說明
`ffclient_t(host, port, timeout)`	構造函數，連接 Broker 監聽地址與端口，設置調用超時
`call(service_name, req, ret, namespace)`	發起 RPC 調用：服務名、請求對象、返回值對象、命名空間（需與 C++ 服務端註冊一致）
返回值	`True` 表示成功，`False` 表示失敗，失敗時可調用 `error_msg()` 獲取原因