本文詳細介紹了阿里雲SDK的泛化調用與特化調用的區別,通過整合後程式碼封裝大小、開發體驗等方面為您闡述了泛化調用和特化調用的優缺點,為您提供了詳盡的技術分析,協助您做出更合適的技術選擇,並通過範例程式碼加速您的專案開發流程。
泛化調用
泛化調用(CommonRequest)是指僅通過核心SDK中的Client類及通用參數配置類來實現對OpenAPI的調用。
優點
整合後程式碼封裝體積小,適配產品範圍大,無論使用多少產品,僅需依賴核心SDK。
可以調用發行但未在阿里雲協助中心及OpenAPI門戶中公開的API。
缺點
在開發過程中由於無對應代碼提示,因此需要查看相關文檔擷取指導。
特化調用
特化調用是指通過雲產品SDK中的Client類、OpenAPI請求類和響應類來實現對OpenAPI的調用。
優點
Client類中包含了OpenAPI請求參數的特殊處理邏輯及產品公用參數,從而減少使用者所需填寫的參數數量。Request類和Response類則分別封裝了OpenAPI請求參數和返回參數,使用者可以根據代碼提示進行參數傳遞或擷取返回參數,從而提升開發體驗。
缺點
如果產品沒有發布對應的阿里雲SDK,則無法使用。
若使用的產品數量較多,則需要為每個產品安裝相應的SDK,因此代碼體積可能會有所增加。
重要
V1.0 Node.js/TypeScript SDK只支援泛化調用,不支援特化調用。
使用指南
語言 | V2.0 SDK | V1.0 SDK | ||
特化調用 | 泛化調用 | 特化調用 | 泛化調用 | |
Java | ||||
Python | ||||
Node.js | / | |||
Go | ||||
PHP | ||||
.NET | ||||