推荐使用Gem

推荐使用:PhalApi SDK for Ruby

6.6.1 使用说明

将框架目录下的 ./SDK/Ruby/PhalApiClient 目录中的全部代码拷贝到项目里面即可使用。

6.6.2 代码示例

如下是使用的代码场景片段。

首先,我们需要导入SDK包:

  1. #demo.rb
  2. require_relative './PhalApiClient/phalapi_client'
  3. a_client = PhalApi::Client.create.withHost('http://demo.phalapi.net')
  4. a_response = a_client.withService('Default.Index').withParams('username', 'dogstar').withTimeout(3000).request()
  5. puts a_response.ret, a_response.data, a_response.msg

6.6.3 运行效果

运行后,可以看到:

  1. 200
  2. {"title"=>"Hello World!", "content"=>"dogstar您好,欢迎使用PhalApi!", "version"=>"1.2.1", "time"=>1445741092}

6.5.4 更多调用

当需要重复调用时,需要先进行 重置操作 ,如:

  1. #one more time
  2. a_response = a_client.reset \
  3. .withService("User.GetBaseInfo") \
  4. .withParams("user_id", "1") \
  5. .request
  6. puts a_response.ret, a_response.data, a_response.msg

当请求有异常时,返回的 ret!= 200,如:

  1. #illegal request
  2. a_response = a_client.reset.withService('XXXX.noThisMethod').request
  3. puts a_response.ret, a_response.data, a_response.msg

以上的输出为:

  1. --------------------
  2. 400
  3. 非法请求:接口服务XXXX.noThisMethod不存在

6.6.5 扩展你的过滤器和结果解析器

(1)扩展过滤器

当服务端接口需要接口签名验证,或者接口参数加密传送,或者压缩传送时,可以实现此过滤器,以便和服务端操持一致。

当需要扩展时,分两步。首先,需要实现过滤器接口:

  1. class MyFilter < PhalApi::ClientFilter
  2. def filter(service, *params)
  3. #TODO ...
  4. end
  5. }

然后设置过滤器:

  1. a_response = PhalApi::Client.create.withHost('http://demo.phalapi.net') \
  2. .withFilter(MyFilter.new) \
  3. # ... \
  4. .request

(2)扩展结果解析器

当返回的接口结果不是JSON格式时,可以重新实现此接口。

当需要扩展时,同样分两步。类似过滤器扩展,这里不再赘述。

6.6.6 一如既往的单元测试

最后,附一张单元测试运行的效果图:[6.6] SDK包(Ruby版) - 图1

原文: https://www.phalapi.net/wikis/6-6.html