安装说明

OAS Java SDK 托管在 Maven 中央库内，版本与文档中心上发布的 Jar 包会保持一致，用户可根据实际需求选择合适的安装方式。

使用 Jar 包

1. 从 SDK 下载页获取最新版的 Java SDK，并解压到本地目录。

2. 若用户没有使用 IDE 进行开发，则把 lib 文件夹内的 aliyun-oas-sdk-<version>.jar，以及 third-party 文件夹中的所有 jar 包复制到CLASSPATH 下。

3. 若用户使用的是 Eclipse 进行开发，则把 lib 文件夹内的 aliyun-oas-sdk-<version>.jar，以及 third-party 文件夹中的所有 jar 包复制到项目中，然后进入项目属性中的 Java Build Path 项内的 Library 选项卡，选择 Add JARs，添加所复制的所有 Jar 包。

4. 若用户使用的是 Intellij IDEA，则在项目属性中的 Libraries 项中，添加 lib 文件夹内的 aliyun-oas-sdk-<version>.jar，以及 third-party 文件夹中的所有 jar 包。

5. 注意，以上操作可能与软件版本有关，如果用户使用的IDE不在上述之列，或者本文所描述的方法无法实现预期功能，请参阅当前使用版本的IDE的帮助手册。

使用 Maven

请在 pom.xml 的 dependencies 标签下加入如下依赖项（版本号VERSION请根据实际发布版本修改）：

<dependency>
    <groupId>com.aliyun.oas</groupId>
    <artifactId>aliyun-oas</artifactId>
    <version>VERSION</version>
</dependency>

开发示例

本节将用最简单地例子展示如何使用 OAS Java SDK，对于其中的细节介绍将在之后的各小节展开。代码中使用方括号括起来的参数，表示用户需要根据实际情况进行替换，下文也将沿用这一做法。

// Access Key 配置
ServiceCredentials credentials = new ServiceCredentials("[yourAccessKeyId]", "[yourAccessKeySecret]");

// 通过工厂类获得archiveManager接口
ArchiveManager archiveManager = OASFactory.archiveManagerFactory(
    credentials, "http://cn-hangzhou.oas.aliyuncs.com");

// 上传文件
UploadResult result = archiveManager.upload("[yourVaultName]", new File("pathForFileToUpload"));
System.out.println("Archive ID: " + result.getArchiveId());
System.out.println("Content Etag value: " + result.getContentEtag());
System.out.println("Tree Etag value: " + result.getTreeEtag());