## 6.6.1 使用說明 將框架目錄下的 ./SDK/Ruby/PhalApiClient 目錄中的全部代碼拷貝到項目里面即可使用。 ## 6.6.2 代碼示例 如下是使用的代碼場景片段。 首先，我們需要導入SDK包： ```javascript #demo.rb require_relative './PhalApiClient/phalapi_client' a_client = PhalApi::Client.create.withHost('http://demo.phalapi.net') a_response = a_client.withService('Default.Index').withParams('username', 'dogstar').withTimeout(3000).request() puts a_response.ret, a_response.data, a_response.msg ``` ## 6.6.3 運行效果 運行后，可以看到： ```javascript 200 {"title"=>"Hello World!", "content"=>"dogstar您好，歡迎使用PhalApi！", "version"=>"1.2.1", "time"=>1445741092} ``` ## 6.5.4 更多調用 當需要重復調用時，需要先進行 **重置操作** ，如： ```javascript #one more time a_response = a_client.reset \ .withService("User.GetBaseInfo") \ .withParams("user_id", "1") \ .request puts a_response.ret, a_response.data, a_response.msg ``` 當請求有異常時，返回的 ret!= 200，如： ```javascript #illegal request a_response = a_client.reset.withService('XXXX.noThisMethod').request puts a_response.ret, a_response.data, a_response.msg ``` 以上的輸出為： ```javascript -------------------- 400 非法請求：接口服務XXXX.noThisMethod不存在 ``` ## 6.6.5 擴展你的過濾器和結果解析器 ### (1)擴展過濾器 當服務端接口需要接口簽名驗證，或者接口參數加密傳送，或者壓縮傳送時，可以實現此過濾器，以便和服務端操持一致。 當需要擴展時，分兩步。首先，需要實現過濾器接口： ```javascript class MyFilter < PhalApi::ClientFilter def filter(service, *params) #TODO ... end } ``` 然后設置過濾器： ```javascript a_response = PhalApi::Client.create.withHost('http://demo.phalapi.net') \ .withFilter(MyFilter.new) \ # ... \ .request ``` ### (2)擴展結果解析器 當返回的接口結果不是JSON格式時，可以重新實現此接口。 當需要擴展時，同樣分兩步。類似過濾器擴展，這里不再贅述。 ## 6.6.6 一如既往的單元測試 最后，附一張單元測試運行的效果圖：