android 阿里oss文件上传

原创

mob649e815adb02 2024-11-06 07:46:48 ©著作权

文章标签 文件上传上传 android 文章分类 Android 移动开发

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

Android 阿里OSS文件上传指南

在现代的移动应用开发中，通常需要向服务器上传文件，例如图片、音频、视频等。阿里云的对象存储服务（OSS）提供了高效、可靠的存储解决方案。本文将介绍如何在 Android 应用中上传文件到阿里 OSS，包括必要的配置、代码示例和使用步骤。

阿里OSS简介

阿里云OSS（Object Storage Service）是一个安全、低成本、高可扩展性的云存储服务。它能够帮助开发者存储和管理大量的数据。

使用场景

媒体文件存储（如图片、音频、视频等）
备份和恢复数据
网站静态资源托管

环境准备

在开始编码之前，你需要注册阿里云账号并创建一个OSS实例。获取到 Access Key ID 和 Access Key Secret 后，可以进行文件上传。

依赖库

在你的项目 build.gradle 文件中，添加阿里 OSS SDK 的依赖：

dependencies {
    implementation 'com.aliyun.oss:oss-android-sdk:2.9.0'
}

AndroidManifest.xml 权限

在 AndroidManifest.xml 中添加以下权限，以使应用可以访问网络并读取文件：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

文件上传实现

下面是一个简单的类图，展示了文件上传的主要类关系。

classDiagram
    class OssUploader {
        +String endpoint
        +String accessKeyId
        +String accessKeySecret
        +String bucketName
        +OssUploader(String endpoint, String accessKeyId, String accessKeySecret, String bucketName)
        +void uploadFile(String objectKey, File file)
    }
    class MainActivity {
        +void onUploadButtonClick()
    }

    OssUploader --> MainActivity

OssUploader类

首先，我们创建一个 OssUploader 类来处理与 OSS 的连接和文件上传。

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.model.PutObjectRequest;

import java.io.File;

public class OssUploader {
    private String endpoint;
    private String accessKeyId;
    private String accessKeySecret;
    private String bucketName;
    private OSS ossClient;

    public OssUploader(String endpoint, String accessKeyId, String accessKeySecret, String bucketName) {
        this.endpoint = endpoint;
        this.accessKeyId = accessKeyId;
        this.accessKeySecret = accessKeySecret;
        this.bucketName = bucketName;
        this.ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
    }

    public void uploadFile(String objectKey, File file) {
        PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectKey, file);
        ossClient.putObject(putObjectRequest);
        ossClient.shutdown(); 
    }
}

MainActivity类

然后，在 MainActivity 中调用上传功能，监听按钮的点击事件。

import android.os.Bundle;
import android.view.View;
import android.widget.Button;

import androidx.appcompat.app.AppCompatActivity;

import java.io.File;

public class MainActivity extends AppCompatActivity {
    private OssUploader ossUploader;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化OSS上传器
        String endpoint = "你的OSS域名";
        String accessKeyId = "你的Access Key ID";
        String accessKeySecret = "你的Access Key Secret";
        String bucketName = "你的Bucket名称";
        ossUploader = new OssUploader(endpoint, accessKeyId, accessKeySecret, bucketName);

        Button uploadButton = findViewById(R.id.upload_button);
        uploadButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 调用文件上传
                String objectKey = "uploads/example.jpg"; // 上传后在OSS上的文件路径
                File file = new File("/storage/emulated/0/DCIM/example.jpg"); // 本地文件路径
                ossUploader.uploadFile(objectKey, file);
            }
        });
    }
}