本文简要介绍了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());
            }
    
        }
    }