全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

安装

更新时间:2017-10-19 17:13:41

环境准备

适用于JDK 6及以上版本。

安装方式

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

在Maven工程中使用OSS Java SDK只需在pom.xml中加入相应依赖即可。以2.7.0版本为例,在dependencies标签内加入如下内容:

  1. <dependency>
  2. <groupId>com.aliyun.oss</groupId>
  3. <artifactId>aliyun-sdk-oss</artifactId>
  4. <version>2.7.0</version>
  5. </dependency>

方式二:在Eclipse项目中导入JAR包

2.7.0版本为例,步骤如下:

  1. 下载Java SDK开发包版本号 aliyun_java_sdk_20170629.zip
  2. 解压该开发包。
  3. 将解压后文件夹中的文件: aliyun-sdk-oss-<versionId>.jar 以及lib文件夹下的所有文件拷贝到您的项目中。
  4. 在Eclipse中选择您的工程,右击选择 Properties > Java Build Path > Add JARs
  5. 选中您在第3步拷贝的所有JAR文件。

经过以上几步,您就可以在Eclipse项目中使用OSS Java SDK。

示例工程

OSS Java SDK提供了基于maven、ant的示例工程,您可以在本地设备上编译运行示例工程。您也可以以示例工程为基础开发您的应用。

说明:

  • 编译运行前,请修改HelloOSS.javaendpoint/accessKeyId/accessKeySecret/bucketName为您的真实信息。
  • 工程的编译运行方法,参看工程目录下README.md

示例程序

OSS Java SDK提供丰富的示例程序,方便用户参考或直接使用。您可以通过以下两种方式获取示例程序:

  • Github查看下载,OSS Java SDK github 下的src/samples为示例程序。
  • 下载OSS Java SDK开发包,如 aliyun_java_sdk_20170629.zip,解压后aliyun_java_sdk_20170629/samples为示例程序。

示例包括以下内容:

示例文件 示例内容
GetStartedSample.java 展示了基本的上传下载用法
SimpleGetObjectSample.java 展示了文件下载的用法
ListObjectsSample.java 展示了列举文件的用法
DeleteObjectsSample.java 展示了批量删除文件的用法
AppendObjectSample.java 展示了追加上传的用法
ObjectMetaSample.java 展示文件元信息的使用方法
CreateFolderSample.java 创建文件夹的用法,OSS文件夹的详细说明请参看文件夹
UploadSample.java 展示断点续传上传的用法
DownloadSample.java 展示了断点续传下载的用法
ImageSample.java 展示了图片服务的用法
PostObjectSample.java 展示了PostObject的用法,该实现不依赖于Java SDK
GetProgressSample.java 展示了上传、下载进度条的用法
CallbackSample.java 展示了上传回调的用法
CRCSample.java 展示了上传、下载CRC校验的用法
BucketOperationsSample.java 展示了存储空间配置的用法,包括权限生命周期日志防盗链CORS
MultipartUploadSample.java 利用分片上传接口实现的并发上传,推荐直接使用断点续传上传(uploadFile)
ConcurrentGetObjectSample.java 利用范围下载实现的并发下载,推荐直接使用的断点续传下载(downloadFile)
UploadPartCopySample.java 展示了大文件分片复制的用法
本文导读目录