本文简要介绍了Java SDK的安装方法，并提供了示例代码。

背景信息

  • Java SDK包含阿里云Java SDK核心库（aliyun-java-sdk-core）和标签SDK（aliyun-java-sdk-tag），两者都需要安装。
  • JDK必须是1.6或以上版本。
  • OpenAPI Explorer提供在线调试API和动态生成SDK示例代码的功能，能显著降低API的使用难度，推荐您使用。
  • 关于标签API的详情，请参见标签API。

Java SDK的安装方法

您可以通过添加Maven依赖或手动下载并导入SDK的JAR文件的方式安装Java SDK。

  • 添加Maven依赖 （推荐）
    1. 使用Maven创建项目。 
      mvn archetype:generate -DgroupId=com.aliyun.tag.sample \
-DartifactId=tag-sdk-sample \
-Dpackage=com.aliyun.tag.sample \
-Dversion=1.0-SNAPSHOT
    2. 在项目的pom.xml文件中加入如下依赖项 。
      <dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.3.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-tag</artifactId>
    <version>1.0.1</version>
</dependency>
      说明 请访问Maven仓库获取aliyun-java-sdk-core的最新版本。
  • 手动下载并导入SDK的JAR文件

    无论您使用Eclipse还是IntelliJ作为集成开发环境，都可以通过手动下载并导入JAR文件的方式安装Java SDK。JAR文件下载地址如下：

Java SDK示例

如下仅列举部分API的示例代码，更多API的Java SDK示例代码，您可以在OpenAPI Explorer中找到对应API，调试并获取。

  • 创建并绑定标签
    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 java.util.*;
import com.aliyuncs.tag.model.v20180828.*;

public class TagResources {

    public static void main(String[] args) {
        //构建一个阿里云client, 用于发起请求。
        //构建阿里云client时需要设置地域ID、AccessKey ID和AccessKey Secret。
        DefaultProfile profile = DefaultProfile.getProfile("cn-qingdao", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);
        
        //构建请求对象。
        TagResourcesRequest request = new TagResourcesRequest();
        
        //设置参数。
        request.setRegionId("cn-qingdao");
        request.setTags("{<tagKey>:<tagValue>}");
        List<String> resourceARNList = new ArrayList<String>();
        resourceARNList.add("<resourceARN>");
        request.setResourceARNs(resourceARNList);

        //发起请求，并得到响应。
        try {
            TagResourcesResponse 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());
        }

    }
}
  • 查询标签列表
    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 java.util.*;
import com.aliyuncs.tag.model.v20180828.*;

public class ListTagResources {

    public static void main(String[] args) {
        //构建一个阿里云client, 用于发起请求。
        //构建阿里云client时需要设置地域ID、AccessKey ID和AccessKey Secret。
        DefaultProfile profile = DefaultProfile.getProfile("cn-qingdao", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);
        
        //构建请求对象。
        ListTagResourcesRequest request = new ListTagResourcesRequest();
        
        //设置参数，可设置多个不同类型的资源ARN。        
        request.setRegionId("cn-qingdao");
        List<String> resourceARNList = new ArrayList<String>();
        resourceARNList.add("arn:acs:ecs:cn-qingdao:<AccountId>:instance/<ResourceId>");
        resourceARNList.add("arn:acs:vpc:cn-qingdao:<AccountId>:vpc/<ResourceId>");
        request.setResourceARNs(resourceARNList);
        
        //发起请求，并得到响应。
        try {
            ListTagResourcesResponse 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());
        }

    }
}