获取对象列表

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何获取对象列表。

接口定义

// 简化接口 
public ObjectListing listObjects(String bucketName)
// 完整接口
public ObjectListing listObjects(ListObjectsRequest listObjectsRequest)

参数说明

代码示例

public void ListObjects(String bucketName, OnS3ResponseListener<List<S3ObjectSummary>> listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            List<S3ObjectSummary> list = sS3Client.listObjects(bucketName).getObjectSummaries();
​
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onResponse(list));
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}

上传对象

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何上传对象。

接口定义

// 简化接口 
public PutObjectResult putObject(String bucketName, String key, File file)
// 完整接口
public PutObjectResult putObject(PutObjectRequest putObjectRequest)

参数说明

代码示例

public void PutObject(String bucketName, String objectKey, File file,
                              OnS3ResponseListener<PutObjectResult> listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectKey, file);
            ObjectMetadata metadata = new ObjectMetadata();
            //metadata.setContentType("image/jpeg");        // content-type
            //metadata.addUserMetadata("my-metadata-key", "my-metadata-value");     // 自定义元数据
            putObjectRequest.setMetadata(metadata);
            PutObjectResult result = sS3Client.putObject(putObjectRequest);
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onResponse(result));
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}

注意：putObject对文件大小有限制，最大能上传5GB大小的文件，超过5GB需要使用分片上传。

下载对象

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何下载对象。

接口定义

// 简化接口 
public S3Object getObject(String bucketName, String key)
// 完整接口
public S3Object getObject(GetObjectRequest getObjectRequest)

参数说明

代码示例

public void GetObjects(String bucketName, String objectKey,
                        OnS3ResponseListener<S3Object> listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            S3Object result = sS3Client.getObject(bucketName, objectKey);
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onResponse(result));
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}

复制对象

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何复制对象。

接口定义

// 简化接口 
public CopyObjectResult copyObject(String sourceBucketName, String sourceKey, String destinationBucketName, String destinationKey)
// 完整接口
public CopyObjectResult copyObject(CopyObjectRequest copyObjectRequest)

参数说明

代码示例

public void CopyObjects(String sourceBucketName, String sourceObjectKey,
                        String destBucketName, String destObjectKey,
                        OnS3ResponseListener<CopyObjectResult> listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            CopyObjectResult result = sS3Client.copyObject(sourceBucketName, sourceObjectKey, destBucketName, destObjectKey);
​
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onResponse(result));
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}

删除对象

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何删除对象。

接口定义

// 简化接口 
public void deleteObject(String bucketName, String key)
// 完整接口
public void deleteObject(DeleteObjectRequest deleteObjectRequest)

参数说明

代码示例

public void DeleteObjects(String bucketName, String objectKey,
                        OnS3ResultListener listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            sS3Client.deleteObject(bucketName, objectKey);
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onSuccess());
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}

获取对象元数据

对象是存储数据的基本单元。对象由元信息（Object Meta），用户数据（Data）和文件名（Key）组成。对象由桶内部唯一的Key来标识。本章节介绍如何获取对象元数据。

接口定义

// 简化接口 
public ObjectMetadata getObjectMetadata(String bucketName, String key)
// 完整接口
public ObjectMetadata getObjectMetadata(GetObjectMetadataRequest getObjectMetadataRequest)

参数说明

代码示例

public void GetObjectMetadata(String bucketName, String objectKey,
                       OnS3ResponseListener<ObjectMetadata> listener) {
    GlobalThreadPool.getInstance().execute(() -> {
        try {
            ObjectMetadata result = sS3Client.getObjectMetadata(bucketName, objectKey);
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onResponse(result));
        } catch (Exception e) {
            Handler mainHandler = new Handler(Looper.getMainLooper());
            mainHandler.post(() -> listener.onError());
        }
    });
}