泛化调用与特化调用

更新时间:

本文详细介绍了阿里云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

泛化调用