閱讀513 返回首頁    go windows


調用服務__使用說明_用戶手冊_雲服務總線 CSB-阿裏雲

API消費方應用調用API有多種方式,例如HTTP API、HSF API、Web Service API等。其中HSF API的消費調用沿用HSF原有的服務調用方式,無需任何專用SDK,如有必要可以指定CSB的服務IP進行HSF服務調用。而調用HTTP API則需要使用CSB Client SDK,目前提供了Java版本的HTTP Client SDK。

HTTP Client SDK 方法概要(Java)

服務調用-HTTP Client SDK概要

注意,阿裏雲公共雲上不建議使用不包含版本信息參數的調用方法(doGet/doPost)。

HTTP Client SDK 示例代碼(Java)

  1. import com.alibaba.csb.sdk.HttpCaller;
  2. import com.alibaba.csb.sdk.HttpCallerException;
  3. ...
  4. Map<String,String> params = new HashMap<String,String>();
  5. Object smd = ... // 一個具體的複雜對象
  6. if (smd != null) {
  7. String data = JSON.toJSONString(smd); // 轉換為JSON String
  8. params.put("data", data);
  9. }
  10. params.put("name", "abcd"); // 普通的串對象
  11. params.put("password", "abcd"); // 普通的串對象
  12. String requestURL = "https://gateway.abc.com:8081/test";
  13. String API_NAME = "login_system";
  14. String ak = "xxxxxx";
  15. String sk = "xxxxxx"; // 用戶安全校驗的簽名密鑰對
  16. try {
  17. String result = HttpCaller.doPost(requestURL, API_NAME, params, ak, sk);
  18. if (result != null) {
  19. // 返回結果處理, 如轉換為JSON對象
  20. ...
  21. }
  22. } catch (HttpCallerException ie) {
  23. // 調用異常處理
  24. ...
  25. }

返回值約定

返回值為JSON格式字符串,CSB正常處理返回形式如下:

  1. {
  2. "RequestId": "4F165030-1380-045E-830C-BDF411779423",
  3. /* 以下為服務API的返回結果數據 */
  4. ...
  5. }

CSB處理異常時返回形式如下所示,除了唯一請求ID外,還有所訪問的CSB實例名,CSB錯誤編碼及錯誤信息。

  1. {
  2. "RequestId": "4F165030-1380-045E-830C-BDF411779423",
  3. "CSBId": "9306vpc07",
  4. "Code": "AccessUnauthorized",
  5. "Message": "Access to the specified API is not authorized."
  6. }

最後更新:2016-11-23 17:41:57

  上一篇:go 訂閱管理__使用說明_用戶手冊_雲服務總線 CSB-阿裏雲
  下一篇:go 錯誤代碼__產品使用問題_雲服務總線 CSB-阿裏雲