全部產品
Search
文件中心

Alibaba Cloud SDK:泛化調用與特化調用

更新時間:Oct 12, 2025

本文詳細介紹了阿里雲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

整合SDK

泛化調用

整合SDK

泛化調用

Python

整合SDK

泛化調用

整合SDK

泛化調用

Node.js

整合SDK

泛化調用

/

泛化調用

Go

整合SDK

泛化調用

整合SDK

泛化調用

PHP

整合SDK

泛化調用

整合SDK

泛化調用

.NET

整合SDK

泛化調用

整合SDK

泛化調用