Java SDK
下载地址
IMM Service 的 Java SDK 让 Java 开发人员可以非常方便地使用 Java 程序操作服务。开发者可以直接使用 Maven 依赖添加 SDK。目前,SDK 支持 J2SE 6.0 及以上版本,已经开源到 github。
操作步骤
为快速开始使用 IMM Service Java SDK,请按照如下步骤进行。
步骤 1 创建阿里云账号
具体方法请参考 阿里云账号注册流程。
为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。具体实名认证流程,请参考 这里。
步骤 2 获取阿里云访问密钥
为了使用 IMM Service Java SDK,您必须申请阿里云的 访问密钥。
登录阿里云 密钥管理页面。选择一对用于 SDK 的访问密钥对。如果没有,请创建一对新访问密钥,且保证它处于启用状态。有关如何创建访问密钥,参见 创建访问密钥。
该密钥对会在下面的步骤使用,且需要保管好,不能对外泄露。另外,您可以参考 SDK 配置了解更多 SDK 如何使用访问密钥的信息。
步骤 3 创建项目
在使用 IMM 服务 Java SDK 之前,请先在控制台上创建好项目(Project)。有关如何创建 Project ,参见 创建项目 。
步骤 4 安装 Java 开发环境
目前,IMM Java SDK 支持 J2SE 6.0 及以上的 Java 运行环境,您可以从 Java 官方网站 下载并按说明安装 Java 开发环境。
步骤 5 安装 Imm Service Java SDK
安装完 Java 开发环境后,您需要安装 IMM Service Java SDK,将下面的依赖加入 pom.xml 。
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.1.2</version>
</dependency>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.5</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-imm</artifactId>
<version>1.14.0</version>
</dependency>
注意:请关注 github 提供的最新版本,查看相关功能并选择使用。
步骤 6 开始一个新的 Java 项目
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.imm.model.v20170906.*;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
public class Demo {
// 初始化 IMM 客户端
static IAcsClient client = new DefaultAcsClient(DefaultProfile.getProfile("cn-shanghai", "your_access_key_id","your_access_key_secret"));
// 项目名称,请确保该项目已经创建
static String projectName = "myproject1";
public static void main(String[] args) throws ClientException {
// 调用文档转换请求
docConvertDemo();
}
public static void docConvertDemo() throws ClientException{
// 创建文档转换异步请求任务
CreateOfficeConversionTaskRequest req = new CreateOfficeConversionTaskRequest();
req.setProject(projectName);
// 设置待转换对文件OSS路径
req.setSrcUri("oss://preview-office-bucket/docs/input/demo.pptx");
// 设置文件输出格式为 vector
req.setTgtType("vector");
// 设置转换后的输出路径
req.setTgtUri("oss://preview-office-bucket/docs/output/demo_pptx");
CreateOfficeConversionTaskResponse res = client.getAcsResponse(req);
String taskId = res.getTaskId();
// 获取文档转换任务结果,最多轮询 30 次
// 每次轮询的间隔为 1 秒
GetOfficeConversionTaskRequest getOfficeConversionTaskRequest = new GetOfficeConversionTaskRequest();
getOfficeConversionTaskRequest.setProject(projectName);
getOfficeConversionTaskRequest.setTaskId(taskId);
int maxCount = 30;
int count = 0;
try {
while (true) {
Thread.sleep(1000); // 1 秒
GetOfficeConversionTaskResponse getOfficeConversionTaskResponse = client.getAcsResponse(getOfficeConversionTaskRequest);
if (!getOfficeConversionTaskResponse.getStatus().equals("Running")) {
// 输出文档转换任务执行结果
System.out.println(getOfficeConversionTaskResponse.getTaskId());
System.out.println(getOfficeConversionTaskResponse.getFailDetail().getCode());
System.out.println("Done");
break;
}
count = count + 1;
if(count >= maxCount) {
System.out.println("OfficeConversion Timeout for 30 seconds");
break;
}
System.out.println("Task is still running.");
}
} catch (InterruptedException e){
e.printStackTrace();
}
}
}
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论