Introduction
If you want to use Alibaba Cloud Classic SDK for .NET, you must make sure that you deploy the following environments. For more information, see .NET SDK and .NET RunTime.
.NET Framework 4.5 or a later version
.NET Standard 2.0 or a later version
C# 4.0 or a later version
Alibaba Cloud Darabonba SDK for .NET is developed based on the Classic SDK. The Darabonba SDK solved multiple issues related to the Classic SDK. The Darabonba SDK introduces various new features. The Darabonba SDK is easy to understand, lowers the usage barriers, and provides improved robustness of the SDK. This user guide describes the new features of the Darabonba SDK in detail. This user guide also describes how to use the Darabonba SDK by comparing the Classic SDK and Darabonba SDK.
New features
The Darabonba SDK is developed based on Darabonba. Darabonba is a domain-specific language (DSL) that is developed by Alibaba Cloud. You can use DSL to compile code in a flexible manner. The system parses the DSL-generated abstract syntax trees (ASTs) to generate an SDK that is suitable for all types of API operations of different Alibaba Cloud services. For more information about Darabonba, visit Darabonba. DSL-based Darabonba SDK resolve the issues related to the Classic SDK. The DSL-based Darabonba SDK provides the following features:
In the Classic SDK, the APIs of different Alibaba Cloud services vary based on the style, such as remote procedure call (RPC) or resource-oriented architecture (ROA). Therefore, the API operations of the services are called by using different methods. In the Darabonba SDK, the API operations of all Alibaba Cloud services are called by using the same method.
The DSL-based Darabonba SDK contains complete business logic. Unlike the Classic SDK, the DSL-based Darabonba SDK is not tightly coupled with the core library. This way, the development costs for SDK upgrades are reduced.
The SDK of each Alibaba Cloud service provides a client object. You can instantiate the client object to call all API operations of the Alibaba cloud service. This implementation of the Darabonba SDK is better than that of the Classic SDK because the Darabonba SDK ensures the security of multiple threads, isolates the identity and authentication information about each Alibaba Cloud service, and does not require multiple Alibaba Cloud services to share one piece of user profile information. In the Classic SDK, one SDK client processes multiple threads, and permission management is less efficient. You can configure different parameters to call the API operations of different Alibaba Cloud services. The parameters that you can configure include the region, timeout period, HTTP proxy, and retry mechanism.
The Darabonba SDK is suitable for more complex scenarios. For example, to use Visual Intelligence API (VIAPI) to process an image, you must upload the image to Object Storage Service (OSS), and OSS generates a URL for the image. Then, you can specify the URL in VIAPI, and VIAPI analyzes and processes the image based on artificial intelligence (AI)-based technologies. If you use the Darabonba SDK, the identity authentication, image upload, and image processing can be complete in a simplified manner.
The Darabonba SDK provides sample code for all API requests. The Darabonba SDK also provides use scenarios in which multiple API requests are sent. The provided information can help you reduce SDK costs and better understand business scenarios in which you can use Alibaba Cloud services. For more information about sample code for API requests, visit Sample code for API requests. For more information about usage scenarios, visit Sample Center.