この Topic では、Alibaba Cloud SDK を使用して実行できるジェネリック呼び出しと特殊呼び出しの違いについて説明します。また、この Topic では、パッケージサイズと開発エクスペリエンスの観点から、ジェネリック呼び出しと特殊呼び出しの利点と制限について説明し、適切な呼び出しメソッドを選択するのに役立ちます。プロジェクト開発を容易にするために、サンプルコードが提供されています。
ジェネリック呼び出し
ジェネリック呼び出し (CommonRequest) は、コア SDK の Client クラスと共通パラメーター構成クラスのみを使用して OpenAPI 操作を呼び出します。
利点
統合後のコードパッケージサイズを削減します。複数のプロダクトを使用する場合でも、コア SDK にのみ依存する必要があります。
Alibaba Cloud ヘルプセンターまたは OpenAPI Portal に公開されているがリストされていない API を呼び出すことができます。
欠点
コードヒントが利用できないため、開発にはドキュメントを参照する必要があります。
特殊呼び出し
特殊呼び出しは、プロダクト固有の SDK の Client、OpenAPI リクエスト、およびレスポンスクラスを使用して OpenAPI 操作を呼び出します。
利点
Client クラスは、特殊な OpenAPI リクエストロジックと共通のプロダクトパラメーターを処理するため、入力する必要があるパラメーターの数が削減されます。Request クラスと Response クラスは、OpenAPI リクエストパラメーターとレスポンスパラメーターをカプセル化します。これにより、コードヒントを使用してパラメーターを渡し、戻り値を取得できるため、開発者エクスペリエンスが向上します。
欠点
プロダクトに対応する Alibaba Cloud SDK がない場合、このメソッドは使用できません。
複数のプロダクトを使用するには、プロダクトごとに個別の SDK をインストールする必要があり、コードパッケージサイズが大きくなります。
V1.0 Node.js/TypeScript SDK は、ジェネリック呼び出しのみをサポートし、特殊呼び出しはサポートしていません。
使用ガイド
言語 | V2.0 SDK | V1.0 SDK | ||
特殊呼び出し | ジェネリック呼び出し | 特殊呼び出し | ジェネリック呼び出し | |
Java | ||||
Python | ||||
Node.js | / | |||
Go | ||||
PHP | ||||
.NET | ||||