接口规范
尽管不同语言的 SDK 实现有所不同,但其接口都遵循 Request-Response 原则,即对 API 的调用按照如下方式进行:
- 利用请求参数构建相应的 Request 实例。
- 调用 SDK 中的相应接口并传入上一步的 Request 实例。
- SDK 接口的返回结果以相应的 Response 实例返回给用户。
如下代码片段解释该原则。
Java
标准用法:
ListProjectsRequest req = new ListProjectsRequest();
ListProjectsResponse res = client.getResponse(req);
第二种用法:
ListProjectsRequest req = new ListProjectsRequest();
String resultJson = client.getResponseString(req);
富客户端 Web 系统中推荐用法:
Map<String, String> map = new HashMap<String,String>();
map.put("Action","ListProjects");
String resultJson = client.getResponseString(map);
各种 Action 的应用,请参看API文档。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论