如果您需要管理OSS存储空间、上传下载文件、管理数据、进行图片处理等,可以先安装Java SDK。本文提供了Java SDK的多种安装方式,请结合实际使用场景选用。

环境准备

使用Java 1.7.0及以上版本。

您可以通过命令java -version查看Java版本。

下载SDK

安装SDK

您可以通过以下三种方式安装SDK。

说明

请根据需求选择合适的OSS Java SDK版本,推荐您使用最新版本。关于版本功能的更多信息,请参见GitHub

在Maven项目中加入依赖项(推荐方式)

在Maven工程中使用OSS Java SDK,只需在pom.xml中加入相应依赖即可。以在<dependencies>中加入3.17.4版本的依赖为例:

说明

建议优先使用最新版本的依赖项。关于Java SDK最新版本相关信息,请参见GitHub

<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>3.17.4</version>
</dependency>

如果使用的是Java 9及以上的版本,则需要添加JAXB相关依赖。添加JAXB相关依赖示例代码如下:

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.1</version>
</dependency>
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
    <version>1.1.1</version>
</dependency>
<!-- no more than 2.3.3-->
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
    <version>2.3.3</version>
</dependency>

在Eclipse项目中导入JAR包

以3.17.4版本为例,步骤如下:

  1. 下载Java SDK开发包

  2. 解压该开发包。

  3. 将解压后文件夹中的文件aliyun-sdk-oss-3.17.4.jar以及lib文件夹下的所有文件拷贝到您的项目中。

  4. 在Eclipse中选择您的工程,右键选择Properties > Java Build Path > Add JARs

  5. 选中拷贝的所有JAR文件,导入到Libraries中。

在IntelliJ IDEA项目中导入JAR包

以3.17.4版本为例,步骤如下:

  1. 下载Java SDK开发包

  2. 解压该开发包。

  3. 将解压后文件夹中的文件aliyun-sdk-oss-3.17.4.jar以及lib文件夹下的所有JAR文件拷贝到您的项目中。

  4. 在IntelliJ IDEA中选择您的工程,右键选择File > Project Structure > Modules > Dependencies > + > JARs or directories

  5. 选中拷贝的所有JAR文件,导入到External Libraries中。

后续步骤

安装Java SDK后,您需要配置访问凭证。详情请参见配置访问凭证