阿里云OSS文件上传详解

VAWPZ • 2025-02-24 00:34 • 编程

一、OSS介绍

OSS，全称 Object Storage Service，是阿里云提供的一种海量、安全、低成本、高可靠的云存储服务。可以用来存储和处理各种非结构化数据（如图片、音频、视频、日志等）。本文主要介绍如何利用OSS进行文件上传。

二、概述

本文主要讲解基于阿里云OSS和阿里云SDK进行文件上传的相关操作。其中，我们需要了解的操作包括：

1.创建OSSClient实例

2.创建Bucket

3.上传文件

三、创建OSSClient实例

使用阿里云SDK进行操作，我们需要先创建一个OSSClient实例，代码如下：

public OSS createOSSClient() {
    String endpoint = "";
    String accessKeyId = "";
    String accessKeySecret = "";
    String bucketName = "";

    // 创建OSSClient实例。
    OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);

    return ossClient;
}

其中，需要传入Endpoint、AccessKeyId、AccessKeySecret和BucketName。

四、创建Bucket

上传文件之前，我们需要创建一个Bucket用于存储文件。创建Bucket的代码如下：

public void createBucket() {
    // 创建OSSClient实例。
    OSS ossClient = createOSSClient();

    String bucketName = "";
    if (!ossClient.doesBucketExist(bucketName)) {
        ossClient.createBucket(bucketName);
    }

    // 关闭OSSClient。
    ossClient.shutdown();
}

其中，我们需要判断Bucket是否已经存在，如果不存在就创建一个Bucket。

五、上传文件

上传文件时，我们需要先创建PutObjectRequest对象，然后使用OSSClient实例的putObject方法进行上传。代码如下：

public void uploadFile() {
    // 创建OSSClient实例。
    OSS ossClient = createOSSClient();

    String bucketName = "";
    String objectName = "";
    String filePath = "";

    PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, new File(filePath));
    ossClient.putObject(putObjectRequest);

    // 关闭OSSClient。
    ossClient.shutdown();
}

其中，需要传入BucketName、ObjectName和文件路径。

六、上传进度

上传大文件时，可能需要显示上传进度。我们可以通过实现PutObjectRequest的ProgressListener接口来实现上传进度的回调。代码如下：

public void uploadFileWithProgress() {
    // 创建OSSClient实例。
    OSS ossClient = createOSSClient();

    String bucketName = "";
    String objectName = "";
    String filePath = "";

    File file = new File(filePath);

    // 设置分片大小，100M（默认为100K）。
    final int partSize = 100 * 1024 * 1024;

    PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, file);
    putObjectRequest.setPartSize(partSize);

    // 设置上传进度回调。
    putObjectRequest.setProgressListener(new ProgressListener() {
        @Override
        public void progressChanged(ProgressEvent progressEvent) {
            switch (progressEvent.getEventType()) {
                case TRANSFER_STARTED_EVENT:
                    System.out.println("开始上传...");
                    break;
                case REQUEST_CONTENT_LENGTH_EVENT:
                    System.out.println("上传文件大小为：" + progressEvent.getBytes());
                    break;
                case REQUEST_BYTE_TRANSFER_EVENT:
                    System.out.println("已上传：" + progressEvent.getBytes());
                    break;
                case TRANSFER_COMPLETED_EVENT:
                    System.out.println("上传完成！");
                    break;
                case TRANSFER_FAILED_EVENT:
                    System.out.println("上传失败！");
                    break;
                default:
                    break;
            }
        }
    });

    ossClient.putObject(putObjectRequest);

    // 关闭OSSClient。
    ossClient.shutdown();
}

其中，我们需要设置分片大小并实现ProgressListener接口。

七、小结

以上就是使用阿里云OSS和阿里云SDK进行文件上传的相关操作。需要注意的是，上传文件时需要先创建OSSClient实例和Bucket。上传大文件时，可以使用分片上传和上传进度回调功能。希望对大家有所帮助！

原创文章，作者：VAWPZ，如若转载，请注明出处：https://www.506064.com/n/361191.html