SDK参考Java版
Java SDK的安装方法
一.SDK(IMS)（ identity management service）身份管理服务
二.SDK(RAM) 访问控制
三.SDK(STS) 阿里云临时安全令牌（Security Token Service，STS）
一.SDK(IMS)（ identity management service）身份管理服务
您可以通过下面两种方法安装Java SDK。
方法一：通过Maven管理项目依赖（推荐）
使用Maven创建项目：
mvn archetype:generate -DgroupId=com.aliyun.ims.sample \
-DartifactId=ims-sdk-sample \
-Dpackage=com.aliyun.ims.sample \
-Dversion=1.0-SNAPSHOT
在项目的pom.xml文件中加入相应依赖项：
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>ims20190815</artifactId>
<version>1.0.0</version>
</dependency>
方法二：手动下载并导入SDK的JAR文件
无论您使用Eclipse还是IntelliJ作为集成开发环境，都可以通过手动下载并导入JAR文件的方式安装Java SDK。JAR文件下载地址为Alibaba Cloud IMS SDK for Java。
Java SDK示例
CreateUser API的Java SDK示例代码。
import com.aliyun.ims20190815.Client;
import com.aliyun.ims20190815.models.CreateUserRequest;
import com.aliyun.ims20190815.models.CreateUserResponse;
import com.aliyun.ims20190815.models.GetDefaultDomainRequest;
import com.aliyun.ims20190815.models.GetDefaultDomainResponse;
import com.aliyun.tearpc.models.Config;
import com.google.gson.Gson;
public class CodeSample {
/**
* 初始化公共请求参数
*/
public static Client initialization() throws Exception {
Config config = new Config();
//您的AccessKey ID。
config.accessKeyId = "" ;
//您的AccessKey Secret。
config.accessKeySecret = "" ;
//您的地域ID。
config.regionId = "" ;
return new Client(config);
}
public static void main(String[] args) throws Exception {
try {
Client client = CodeSample.initialization();
//获取阿里云账号（主账号）默认域名.onaliyun.com。
GetDefaultDomainRequest getDefaultDomainRequest = new GetDefaultDomainRequest();
GetDefaultDomainResponse getDefaultDomainResponse = client.getDefaultDomain(getDefaultDomainRequest);
String defaultDomain = getDefaultDomainResponse.getDefaultDomainName();
//创建RAM用户。
CreateUserRequest createUserRequest = new CreateUserRequest();
//设置RAM用户的登录名称。格式为@.onaliyun.com, 其中为RAM用户名称，.onaliyun.com为默认域名。
String userName = "" ;
createUserRequest.userPrincipalName = String.format("%s@%s", userName, defaultDomain);
//设置RAM用户的显示名称。
createUserRequest.displayName = "" ;
CreateUserResponse createUserResponse = client.createUser(createUserRequest);
System.out.println(new Gson().toJson(createUserResponse));
} catch (Exception e) {
System.out.println(e.getMessage());
}
}
}
二.SDK(RAM) 访问控制
Java SDK的安装方法
您可以通过下面两种方法安装Java SDK。具体的安装方法，请参见快速开始。
方法一：通过Maven管理项目依赖（推荐）
使用Maven创建项目：
mvn archetype:generate -DgroupId=com.aliyun.ram.sample \
-DartifactId=ram-sdk-sample \
-Dpackage=com.aliyun.ram.sample \
-Dversion=1.0-SNAPSHOT
在项目的pom.xml文件中加入相应依赖项：
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-ram</artifactId>
<version>2.0.7</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.5.18</version>
</dependency>
说明 请访问Maven仓库获取aliyun-java-sdk-core的最新版本。
方法二：手动下载并导入SDK的JAR文件
无论您使用Eclipse还是IntelliJ作为集成开发环境，都可以通过手动下载并导入JAR文件的方式安装Java SDK。
Java SDK示例
请求访问OpenAPI开发者门户调试并获取示例代码。
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.ram.model.v20150501.*;
public class CreateUser {
public static void main(String[] args) {
//构建一个阿里云客户端, 用于发起请求。
//构建阿里云客户端时需要设置AccessKey ID和AccessKey Secret。
DefaultProfile profile = DefaultProfile.getProfile("" , "" );
IAcsClient client = new DefaultAcsClient(profile);
//构建请求，设置参数。
CreateUserRequest request = new CreateUserRequest();
request.setUserName("" );
//发起请求，并得到响应。
try {
CreateUserResponse 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());
}
}
}
三.SDK(STS) 阿里云临时安全令牌（Security Token Service，STS）
STS是阿里云提供的一种临时访问权限管理服务。
Java SDK的安装方法
方法一：添加Maven依赖（推荐）
使用Maven创建项目：
mvn archetype:generate -DgroupId=com.aliyun.sts.sample \
-DartifactId=sts-sdk-sample \
-Dpackage=com.aliyun.sts.sample \
-Dversion=1.0-SNAPSHOT
在项目的pom.xml文件中加入如下依赖项：
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-sts</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.4.6</version>
</dependency>
方法二：手动下载并导入SDK的JAR文件
无论您使用Eclipse还是IntelliJ作为集成开发环境，都可以通过手动下载并导入JAR文件的方式安装Java SDK。
java示例
下面为您提供AssumeRole API的Java SDK示例代码。关于其他API，请访问OpenAPI开发者门户调试并获取示例代码。
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.sts.model.v20150401.*;
public class AssumeRole {
public static void main(String[] args) {
//构建一个阿里云客户端，用于发起请求。
//构建阿里云客户端时需要设置AccessKey ID和AccessKey Secret。
DefaultProfile profile = DefaultProfile.getProfile("cn-hangzhou", "" , "" );
IAcsClient client = new DefaultAcsClient(profile);
//构造请求，设置参数。关于参数含义和设置方法，请参见API参考。
AssumeRoleRequest request = new AssumeRoleRequest();
request.setRegionId("cn-hangzhou");
request.setRoleArn("" );
request.setRoleSessionName("" );
//发起请求，并得到响应。
try {
AssumeRoleResponse 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());
}
}
}
阿里云官方文档