Android 七牛大文件上传

原创

mob64ca12d2a342 2024-09-19 07:02:54 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12d2a342的原创作品，请联系作者获取转载授权，否则将追究法律责任

Android 七牛大文件上传指南

在现代的移动应用开发中，支持大文件上传是一项常见的需求。七牛云存储提供了强大的文件上传能力。本文将为刚入行的小白开发者提供一个关于如何在 Android 中实现七牛大文件上传的全面指南。

整体流程

在实现七牛大文件上传的过程中，我们可以将步骤分为以下几个主要流程：

步骤	描述
第一步	创建七牛云账号并获取 Access Key 和 Secret Key
第二步	在 Android 项目中引入七牛 SDK
第三步	初始化七牛上传配置
第四步	实现上传文件的功能
第五步	处理上传结果

接下来，我们将逐步详细讲解每个步骤。

第一步：创建七牛云账号

访问 [七牛云官网]( 注册账号。
在控制面板中获取“Access Key”和“Secret Key”。

注意：在后续的代码中会用到这两个 Key。

第二步：在 Android 项目中引入七牛 SDK

在你的 build.gradle 文件中添加七牛的 SDK 依赖项：

dependencies {
    implementation 'com.qiniu:qiniu-android-sdk:7.7.3' // 指定七牛 SDK 版本
}

记得同步你的项目，使依赖生效。

第三步：初始化七牛上传配置

在你的主活动中，初始化七牛的配置：

import com.qiniu.android.storage.Configuration;
import com.qiniu.android.storage.UploadManager;

// 创建一个配置对象
Configuration config = new Configuration.Builder()
        .chunkSize(1024 * 1024) // 设置分片上传的大小（1MB）
        .putThreshhold(1024 * 1024) // 设置开始上传的阈值（1MB）
        .connectTimeout(10) // 连接超时（秒）
        .responseTimeout(60) // 响应超时（秒）
        .zone(Zone.autoZone) // 选择一个区域
        .build();

// 创建上传管理器
UploadManager uploadManager = new UploadManager(config);

说明：将上传文件分成 1MB 的块可以提升大文件的上传效率和稳定性。

第四步：实现上传文件的功能

下面是一个简单的文件选择和上传的实现过程：

import android.content.Intent;
import android.net.Uri;

// 选择文件的方法
private void chooseFile() {
    Intent intent = new Intent(Intent.ACTION_GET_CONTENT);
    intent.setType("*/*"); // 可以选择任意文件
    startActivityForResult(intent, PICKFILE_REQUEST);
}

// 在Activity的onActivityResult方法中处理选择的文件
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == PICKFILE_REQUEST && resultCode == RESULT_OK && data != null) {
        Uri fileUri = data.getData();
        uploadFile(fileUri); // 调用上传文件方法
    }
}

// 上传文件的方法
private void uploadFile(Uri fileUri) {
    String filePath = fileUri.getPath(); // 获取文件路径
    String key = "example_key"; // 选择一个唯一的key

    uploadManager.put(filePath, key, getUploadToken(), (key1, info, response) -> {
        if (info.isOK()) {
            // 上传成功
            Log.d("Upload", "Upload Success: " + key1);
        } else {
            // 上传失败
            Log.e("Upload", "Upload Fail: " + info.error);
        }
    }, null);
}

// 获取上传的 token
private String getUploadToken() {
    String accessKey = "your_access_key"; // 替换成你的Access Key
    String secretKey = "your_secret_key"; // 替换成你的Secret Key
    String bucket = "your_bucket_name"; // 替换成你的 Bucket 名称

    Auth auth = Auth.create(accessKey, secretKey);
    return auth.uploadToken(bucket);
}

解释：通过 chooseFile() 方法可以打开文件选择器，用户选择文件后，调用 uploadFile() 方法进行上传。成功上传后，您会在 Logcat 中看到上传成功的日志。

第五步：处理上传结果

如上面代码中所示，处理上传结果通过 UploadManager.put() 方法中的回调实现。简单处理可以通过日志输出，也可以根据实际业务需求做出相应提示。

关系图

erDiagram
    User {
        string name
        string email
        string password
    }

    File {
        string fileName
        string filePath
        string fileSize
    }

    User ||--o{ File : uploads