阿里云SDK V1.0和V2.0的区别和升级内容_阿里云SDK(Alibaba Cloud SDK)-阿里云帮助中心

本文通过生成方案、语言支持、语言拓展、SDK场景化示例等多方面为您详细介绍了阿里云SDK升级前后的差异。如果您之前使用过阿里云SDK集成云产品，发现现在文档中的写法与以前不同，可参考本文了解不同版本SDK差异，若您是初次使用阿里云SDK，请直接使用V2.0版本SDK。

V1.0 vs V2.0

对比项	V1.0 SDK（不推荐）	V2.0 SDK（推荐）

对比项	V1.0 SDK（不推荐）	V2.0 SDK（推荐）
生成方案	基于模板生成，各编程语言之间采用不同的模板方案，各个语言之间功能完备程度不一致，使用体验不一。	基于 DSL 语言 Darabonba 方案生成。新方案通过 DSL 语言进行统一的中间表达，并进行了语法校验，使用体验一致。
语言支持	大部分云产品的老版本SDK无法支持超过3门以上的主流语言。	支持主流6门语言的SDK生成。
语言扩展	模板化生成，扩展难度太高，老版本SDK很难扩展新语言。	新语言生成器只需接入DSL语言的AST即可完成扩展，未来还会新增更多的语言。
SDK 示例	各语言间的代码示例不一致，不能保证代码的正确性。	各语言间的代码在逻辑行为上保持一致，通过中间语言来统一生成，具有校验能力，有效保证示例代码的准确性。
SDK 场景化示例	多语言场景化示例编写困难，极少有产品提供，覆盖语言数极少。	通过DSL一次编写就能生成多语言的SDK场景化示例，可以协助开发者极大的简化SDK使用的理解成本，更多示例请参见SDK 示例中心。

V1.0 SDK（不推荐）

说明

由于V1.0 SDK存在体验不一致、身份鉴权信息无法隔离等问题，官方不再推荐您继续使用。

以下是V1.0 SDK的简单模型图。

阿里云 V1.0 SDK 主要分为三层：

产品SDK层，处理OpenAPI业务相关的参数。
核心SDK层，过渡OpenAPI业务参数到HTTP请求参数。
HTTP Client层，真正发起请求的部分。

在使用V1.0 SDK方式集成云产品服务时，我们通常需要引入核心SDK和产品SDK。

代码示例

当我们同时调用多个不同产品的OpenAPI时，通用的Client对象无法按照产品维度进行隔离，且容易产生线程安全问题。

<!-- ECS sdk -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-ecs</artifactId>
    <version>5.11.7</version>
</dependency>
<!-- core sdk -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.6.1</version>
</dependency>

package com.example;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import com.aliyuncs.ecs.model.v20140526.*;

public class DescribeInstanceStatus {

    public static void main(String[] args) {
        // Please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID
        // and ALIBABA_CLOUD_ACCESS_KEY_SECRET are set.
        DefaultProfile profile = DefaultProfile.getProfile(
                "<YOUR-REGION-ID>",
                System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        );

        // use STS Token
        // DefaultProfile profile = DefaultProfile.getProfile(
        //  "<YOUR-REGION-ID>",                                 // The region ID
        //  System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),       // The AccessKey ID of the RAM account
        //  System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),   // The AccessKey Secret of the RAM account
        //  System.getenv("ALIBABA_CLOUD_SECURITY_TOKEN")       // STS Token
        // );

        // init acs client
        IAcsClient client = new DefaultAcsClient(profile);

        // Create the request to query instance status
        DescribeInstanceStatusRequest request = new DescribeInstanceStatusRequest();
        request.setRegionId("<YOUR-REGION-ID>");

        try {
            DescribeInstanceStatusResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }
    }
}

V2.0 SDK（推荐）

阿里云V1.0 SDK是较早使用的版本，不少老用户习惯于V1.0的开发。阿里云V2.0 SDK是通过总结开发者在 V1.0中遇到的一系列问题后重新开发的一版SDK，新增了许多特性，主要以易于用户理解，降低用户接入成本并提升SDK的健壮性为主。

V2.0 SDK是基于阿里云自研的DSL语言Darabonba生成。DSL的灵活性不仅可以进行更多表达，而且通过解析DSL生成的AST也能抹平阿里云不同产品生产的不同风格OpenAPI的差异，轻松实现OpenAPI到SDK的生成。与V1.0相比，阿里云V2.0 SDK具备以下新特性：

使用体验一致：解决V1.0 SDK中产品OpenAPI风格不同（RPC或ROA）造成使用方式不一致的问题。升级版SDK中所有云产品的SDK使用方式相同，使用体验一致。
开发成本降低：通过DSL使SDK具备逻辑表达能力，解决了V1.0 SDK与SDK Core耦合性高的问题，降低了开发者因为SDK的升级带来的开发成本。
身份和鉴权信息隔离：每个云产品的SDK提供一个Client对象，通过实例化Client对象就可以调用云产品的所有API。通过这样的方式，不仅解决了V1.0 SDK单Client容易造成线程安全的问题，同时通过该方式使每个云产品之间身份和鉴权信息隔离，从而解决了用户使用V1.0 SDK造成的profile信息在不同产品之间混用导致的权限管理问题。用户也可以根据不同云产品OpenAPI的情况配置不同参数，例如服务地域、超时时间、HTTP代理、重试配置等。
支持复杂场景：V2.0 SDK支持更复杂的OpenAPI使用场景，例如智能视觉开放平台的人脸人体（FaceBody）功能需要上传图片到OSS以后，通过生成的链接对图片进行人工智能分析处理，就可以通过V2.0 SDK将上传鉴权、上传图片、图片分析三个操作组合，从而简化OpenAPI的使用。
提供场景化示例：V2.0 SDK不仅为SDK中的所有的OpenAPI请求生成相应的示例，同时也通过对SDK中的多个OpenAPI请求进行组合，从而提供SDK的场景化示例，这样的示例不仅可以帮助开发者降低接入 SDK的成本，也可以帮助开发者更好地理解云产品的业务场景。

因此，对于新用户建议直接使用V2.0 SDK，老用户也建议尽早迁移到V2.0 SDK。

代码示例

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>ecs20140526</artifactId>
  <version>5.1.8</version>
</dependency>

package com.example;

import com.aliyun.tea.TeaException;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.ecs20140526.Client;
import com.aliyun.ecs20140526.models.DescribeInstanceStatusRequest;

public class Sample {

    public static void main(String[] args) throws Exception {
        Config config = new Config();
        // 必填，您的 AccessKey ID, 请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID
        config.setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"));
        // 必填，您的 AccessKey Secret, 请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET
        config.setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // ECS 的 Endpoint, 请参考 https://api.aliyun.com/product/Ecs
        config.setEndpoint("<Endpoint>");
        Client client = new Client(config);
        DescribeInstanceStatusRequest request = new DescribeInstanceStatusRequest()
                .setRegionId("<YOUR-REGION-ID>");
        try {
            // 复制代码运行请自行打印 API 的返回值
            client.describeInstanceStatus(request);
        } catch (TeaException error) {
            error.printStackTrace();
        } catch (Exception error) {
            error.printStackTrace();
        }
    }
}

查看SDK的依赖信息

打开阿里云OpenAPI开发者门户，选择产品与服务，以专有网络为示例。

选择SDK 版本。

选择语言，在安装方式中可以查看产品对应语言所需的SDK依赖信息，在概述中查看SDK最新版本。