FFrpc python客戶端lib使用的示例分析

這篇文章給大家分享的是有關FFrpc python客戶端lib使用的示例分析的內容。小編覺得挺實用的，因此分享給大家做個參考，一起跟隨小編過來看看吧。

摘要:

Ffrpc可以很方便的構建c++ server， 在網游服務器程序開發中，進程間通訊非常的重要，比如gateserver和gameserver或dbserver之間的通信。而ffrpc可以使得進程間通信非常簡單，是由于ffrpc的broker模式封裝了位置無關性，使得如gate調用gameserver的接口只需要知道對方的服務名，從而使得程序中各個節點的關系與系統的拓撲關系是完美吻合的。這也使得系統的架構更加清晰，系統的實現更健壯和易維護。

之前ffrpc只提供了c++ server/client的實現，在網游服務器程序開發中經常有些需求是需要其他語言和C++server通信的，比如一些工具程序，一些web配置、管理后臺登通常用腳本語言實現更加敏捷。比如開發一個gm后臺，就可以使用python開發一個web頁面實現，而gm后臺指令需要發給c++ server去執行。所以，腳本語言對于C++ server的的接口調用的需求是確實存在的。所以ffrpc中提供python的客戶端禮庫ffrpc-py。

特性

• C++ server 通常是使用二進制協議傳輸數據的，但是如果手動用python組二進制包則非常的困難，好在有google protobuf和thrift兩大神器，而google protobuf在服務器程序開發領域已經被廣泛接受。所以由于C++ server定義接口時使用了protobuf（或者像我一樣偏愛thrift），那么與腳本通訊就變得小輕松了。

• 對于C++ server 來講，通信時異步的，這是由于C++ server一般是邏輯層單線程，為了保持高并發能力，io操作異步化是必然選擇。但是對于腳本如python這種，一般而言還是使用同步調用模型，而剛好ffrpc的通信模式要求所有的接口都是req<->ret一一對應的，ffrpc-py調用c++ server的接口，只需要制定輸入消息，然后調用接口，接收返回消息，像調用本地函數一樣直接，這也是rpc lib的存在意義。

• Ffrpc-py 支持protobuf和thrift，當然必須和c++ server采用的通信協議一致。

示例

本例采用c++ sever thrift作為示例。由于ffrpc example目錄的tutorial已經實現了一個c++ echo server，本例就利用ffrpc-py調用echo接口。

其中thrift的定義文件為:

struct echo_thrift_in_t {   
 1: string data
}

struct echo_thrift_out_t {   
 1: string data
}

使用ffrpc-py調用echo接口:

HOST = '127.0.0.1'
  PORT = 10246
  ffc = ffclient_t(HOST, PORT, 1.5) # 1.5 sec為調用超時時間
  req = ttypes.echo_thrift_in_t('ohNice')
  ret = ttypes.echo_thrift_out_t()
  ffc.call('echo', req, ret, 'ff')
  print('error_info = %s' %(ffc.error_msg()), ret)

ffrpc接口的參數的解釋：

• ffclient_t(HOST, PORT, 1.5) 構造函數的參數為broker的監聽地址和端口。Ffrpc-py只需要知道broker的位置，至于調用的是哪個服務器的接口，這個由broker確定，至于目標服務器是跟broker在同一個進程，還是通過網絡連接，ffrpc-py無需知道細節。

• call 接口調用遠程的服務器接口，參數一為c++server接口注冊的服務名，ffrpc-py只需要知道服務名就可以定位目標服務器的位置

• call第二個參數為請求參數

• call第三個參數為c++ server返回的消息類型，如果call返回true，那么該消息會被自動賦上值

• 第四個參數為消息的命名空間，比如定義thrift的文件的時候定義了命名空間，那么需要第四個參數填入命名空間，這里跟C++ server的注冊的消息一致即可，如果C++ server也沒有消息的命名空間，那么省略這個參數即可

• Call接口成功返回True，失敗為false，同時error_msg接口可以輸出錯誤原因

感謝各位的閱讀！關于“FFrpc python客戶端lib使用的示例分析”這篇文章就分享到這里了，希望以上內容可以對大家有一定的幫助，讓大家可以學到更多知識，如果覺得文章不錯，可以把它分享出去讓更多的人看到吧！