733      小米路由器

設計原則__SDK參考手冊_數據集成-阿裏雲

針對CDP Java SDK，總體上遵循了以下幾個原則:

• Java API是CDP REST API（對下稱RESTAPI）的客戶端代理，通過RESTAPI訪問CDP。

• Java API不是REST API接口的一一映射，要有更高的抽象層次，符合對CDP概念的一般理解。用戶容易推斷各個類的用法，具有較低的學習曲線。例如對於查詢接口，若查詢沒有找到對象而報錯，RESTAPI返回錯誤為404(NotFound)，但是考慮到JavaAPI的設計風格，在Java層麵不再拋出異常，取代的是返回null。

• Java API的設計是麵向對象的，符合麵向對象的設計原則。目前JavaAPI接口設計暫時不提供“語法糖衣”，所有操作是最小功能的。將來根據需求再逐步完善。

• Java API對所有用戶的入參不允許做任何修改，對於需要修改入參情況，CDP做法是拷貝一份入參，並修改後作為方法返回值返回結果。

• Java API體現Session、Pipeline、Job等概念模型的層次結構，例如Pipeline.start(Job)，用戶必須持有Pipeline才能啟動Job。

最後更新：2016-05-06 10:43:35

  上一篇： 啟動作業__作業管理_Console參考手冊_數據集成-阿裏雲

  下一篇： 代碼示例__SDK參考手冊_數據集成-阿裏雲