Spring Boot实现文件上传与OSS集成:从基础到应用

目录

  • 前言
  • 1. 文件上传的基础实现
    • 1.1 前端文件上传请求
    • 1.2 后端文件接收与保存
  • 2. 集成第三方OSS服务
    • 2.1 准备工作
    • 2.2 编写OSS集成代码
    • 2.3 修改Controller实现文件上传至OSS
  • 3. 文件上传的扩展:多文件上传与权限控制
  • 结语

前言

随着互联网应用的快速发展,文件上传已成为各类应用的重要功能之一。本文将基于Spring Boot实现文件上传的基础功能,并探讨如何将文件上传服务集成至第三方OSS(如阿里云OSS、华为云OBS等),以提升应用的文件存储能力。我们将以具体的示例代码为切入点,从前端文件上传、后端文件接收与存储、到OSS集成提供详细说明,帮助开发者快速掌握文件上传的开发要点。

1. 文件上传的基础实现

文件上传是现代Web开发中常见的需求。通过MultipartFile类,Spring Boot支持多种文件类型的接收和处理。在此,我们首先实现文件上传的基础功能,包括前端发送文件、后端接收并存储至本地文件系统。
在这里插入图片描述

1.1 前端文件上传请求

前端通过<form>表单提交文件,并设置enctype属性为multipart/form-data。这样可以确保文件以合适的格式传输给服务器。以下是前端表单的示例代码:

<form action="/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file"/>
    <button type="submit">上传文件</button>
</form>

在这里,我们使用POST方法将文件上传至/upload路径,并确保数据类型为multipart/form-data。用户选择文件后,表单将自动将文件数据与表单数据打包并提交给服务器。

1.2 后端文件接收与保存

在后端,使用@RestController@PostMapping注解定义一个/upload接口,用于接收和处理前端上传的文件。Spring Boot的MultipartFile类提供了一些方便的方法,如getOriginalFilename()用于获取原始文件名,transferTo()用于保存文件。

以下是文件上传的Controller代码:

@RestController
public class FileUploadController {
    
    @PostMapping("/upload")
    public Result<String> upload(MultipartFile file) throws IOException {
        // 获取原始文件名
        String originalFilename = file.getOriginalFilename();
        // 生成唯一文件名,防止文件重名
        String filename = UUID.randomUUID() + originalFilename.substring(originalFilename.lastIndexOf("."));
        // 将文件存储到本地目录
        file.transferTo(new File("D:\\temp\\files\\" + filename));
        // 返回文件访问URL或成功信息
        return Result.success("文件上传成功,访问路径为:url地址.../" + filename);
    }
}

在此代码中,我们:

  • 获取了原始文件名,并通过UUID生成唯一文件名,避免重名文件的覆盖。
  • 使用file.transferTo()方法将文件存储到指定目录。
  • 返回结果信息,其中可以包含上传文件的访问URL(假设文件已通过Web服务器对外提供访问)。

2. 集成第三方OSS服务

存储文件到本地虽然简单,但在高访问量或大文件场景中,本地存储可能存在扩展性、存储容量、安全性等方面的限制。因此,将文件存储至第三方OSS(如阿里云OSS、华为云OBS等)是一种更为合理的选择。第三方云存储提供稳定的存储服务、CDN加速、权限管理等功能,适合互联网应用。
在这里插入图片描述

2.1 准备工作

为了集成OSS服务,我们需要根据官方文档获取相关SDK,并完成账户授权等配置。以下步骤以阿里云OSS为例:

  1. 引入SDK依赖:在Maven或Gradle配置中添加阿里云OSS SDK的依赖。

    <dependency>
        <groupId>com.aliyun.oss</groupId>
        <artifactId>aliyun-sdk-oss</artifactId>
        <version>3.10.2</version>
    </dependency>
    
  2. 配置OSS信息:在配置文件application.ymlapplication.properties中添加OSS的配置信息,包括accessKeyIdaccessKeySecretbucketNameendpoint

    oss:
      endpoint: http://oss-cn-hangzhou.aliyuncs.com
      accessKeyId: yourAccessKeyId
      accessKeySecret: yourAccessKeySecret
      bucketName: yourBucketName
    

2.2 编写OSS集成代码

在配置完必要的依赖和参数后,我们创建一个OssService类,用于封装文件上传至OSS的逻辑:

import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;

import java.io.InputStream;
import java.util.UUID;

@Service
public class OssService {
    @Value("${oss.endpoint}")
    private String endpoint;
    @Value("${oss.accessKeyId}")
    private String accessKeyId;
    @Value("${oss.accessKeySecret}")
    private String accessKeySecret;
    @Value("${oss.bucketName}")
    private String bucketName;

    public String uploadFileToOss(InputStream inputStream, String originalFilename) {
        // 创建OSSClient实例
        OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        try {
            // 生成唯一文件名
            String filename = UUID.randomUUID() + originalFilename.substring(originalFilename.lastIndexOf("."));
            // 上传文件
            ossClient.putObject(bucketName, filename, inputStream);
            // 返回文件的URL
            return "https://" + bucketName + "." + endpoint + "/" + filename;
        } finally {
            // 关闭OSSClient
            ossClient.shutdown();
        }
    }
}

此类中,我们使用OSSClient将文件上传至OSS,并生成一个唯一的文件名。uploadFileToOss()方法返回文件的访问URL,便于后续使用。

2.3 修改Controller实现文件上传至OSS

FileUploadController中注入OssService,并使用其方法上传文件至OSS。以下是修改后的代码:

@RestController
public class FileUploadController {

    private final OssService ossService;

    public FileUploadController(OssService ossService) {
        this.ossService = ossService;
    }

    @PostMapping("/upload")
    public Result<String> upload(MultipartFile file) throws IOException {
        // 将文件上传至OSS,并获取文件访问URL
        String url = ossService.uploadFileToOss(file.getInputStream(), file.getOriginalFilename());
        // 返回OSS的URL
        return Result.success("文件上传成功,访问路径为:" + url);
    }
}

3. 文件上传的扩展:多文件上传与权限控制

在实际应用中,文件上传可能涉及多文件上传和权限控制等扩展功能。以下是一些典型需求:

  • 多文件上传:可以通过在Controller中接收MultipartFile[]数组实现多文件上传,循环处理数组中的每个文件。
  • 权限控制:根据OSS服务的权限策略,配置文件访问的公开或私有权限。例如,阿里云OSS允许通过设置Bucket的权限控制公开、私有或指定访问者。

结语

本文介绍了Spring Boot中实现文件上传的基础步骤,包括如何在前端发送文件、后端接收并存储文件。同时,展示了如何将文件存储服务集成至第三方OSS,提升系统的扩展性与安全性。在实际开发中,还可以根据业务需求增加权限控制、多文件处理等功能。希望本文的讲解能够为读者提供清晰的指导,帮助更好地实现文件上传功能。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:/a/912810.html

如若内容造成侵权/违法违规/事实不符,请联系我们进行投诉反馈qq邮箱809451989@qq.com,一经查实,立即删除!

相关文章

万字长文解读深度学习——卷积神经网络CNN

推荐阅读&#xff1a; 卷积神经网络&#xff08;CNN&#xff09;详细介绍及其原理详解 CNN笔记&#xff1a;通俗理解卷积神经网络 文章目录 &#x1f33a;深度学习面试八股汇总&#x1f33a;主要组件输入层卷积层 (Convolutional Layer)批归一化层&#xff08;Batch Normalizat…

07 Oracle数据库恢复基础解析:从检查点到归档,一步步构建数据安全防线

文章目录 Oracle数据库恢复基础解析&#xff1a;从检查点到归档&#xff0c;一步步构建数据安全防线一、检查点&#xff08;Checkpoint&#xff09;1.1 检查点定义1.2 检查点重要性1.3 检查点工作原理1.4 手动触发检查点 二、日志&#xff08;Redo Log&#xff09;2.1 日志定义…

css | padding vs margin

前置知识 height是作用域内容(content)区域的 padding和margin用百分比的时候是怎么算的&#xff1f;父元素的宽度。注意&#xff0c;不是根据父元素相应的属性&#xff0c;就是父亲的width 自身的height是0 以下代码&#xff0c;外面盒子是100x10的&#xff0c;里面的widt…

Linux平台C99与C++11获取系统时间

源码: #include <iostream> #include <chrono> #include <ctime> #include <thread>using namespace std; int main() {cout << "===使用C99方式获取系统时间===" << endl;time_t now = time(nullptr);struct tm *tm_c99 = lo…

pwn学习笔记(11)--off_by_one

pwn学习笔记&#xff08;11&#xff09;–off_by_one ​ 在处理for循环或者while循环的时候&#xff0c;有的可能会遇到如下情况&#xff1a; #include<stdio.h>int main(){char buf[0x10];for (int i 0 ; i < 0x10 ; i ){buf[i] getchar();}puts(buf);}​ 多次输…

基于Java Web的传智播客crm企业管理系统的设计与实现

项目描述 临近学期结束&#xff0c;还是毕业设计&#xff0c;你还在做java程序网络编程&#xff0c;期末作业&#xff0c;老师的作业要求觉得大了吗?不知道毕业设计该怎么办?网页功能的数量是否太多?没有合适的类型或系统?等等。这里根据疫情当下&#xff0c;你想解决的问…

【Vue】Vue3.0(十七)Vue 3.0中Pinia的深度使用指南(基于setup语法糖)

上篇文章&#xff1a; 【Vue】Vue3.0&#xff08;十一&#xff09;Vue 3.0 中 computed 计算属性概念、使用及示例 &#x1f3e1;作者主页&#xff1a;点击&#xff01; &#x1f916;Vue专栏&#xff1a;点击&#xff01; ⏰️创作时间&#xff1a;2024年11月10日15点23分 文章…

常用的c++新特性-->day03

断言和异常 断言断言的基本使用 静态断言静态断言的基本使用 异常异常基本使用c98异常案例 noexceptnoexcept简单案例 断言 断言的基本使用 #include <iostream> #include <cassert>// >>>>>>>>>>>>>>>> 断言的…

11月7日星期四今日早报简报微语报早读

11月7日星期四&#xff0c;农历十月初七&#xff0c;早报#微语早读。 1、河南&#xff1a;旅行社组织1000人次境外游客在豫住宿2夜以上&#xff0c;可申请激励奖补&#xff1b; 2、主播宣称下播后商品恢复原价构成欺诈&#xff0c;广州市监&#xff1a;罚款5万元&#xff1b;…

数据结构-并查集专题(1)

一、前言 因为要开始准备年底的校赛和明年年初的ACM、蓝桥杯、天梯赛&#xff0c;于是开始按专题梳理一下对应的知识点&#xff0c;先从简单入门又值得记录的内容开始&#xff0c;并查集首当其冲。 二、我的模板 虽然说是借用了jiangly鸽鸽的板子&#xff0c;但是自己也小做…

【dvwa靶场:XSS系列】XSS (Stored)低-中-高级别,通关啦

更改name的文本数量限制大小&#xff0c; 其他我们只在name中进行操作 【除了低级可以在message中进行操作】 一、低级low <script>alert("假客套")</script> 二、中级middle 过滤了小写&#xff0c;咱们可以大写 <Script>alert("假客套…

【spark面试】spark的shuffle过程

概述 所有的shuffle的过程本质上就是一个task将内存中的数据写入磁盘&#xff0c;然后另一个task将磁盘中的数据读入内存的过程。 对于mapreduce来说&#xff0c;我们将内存中的数据写入磁盘成为maptask&#xff0c;将磁盘中的数据读入内存称为reducetask。 而对于spark来说&…

MySQL —— Innodb 索引数据结构

文章目录 不用平衡二叉树或红黑树作为索引B树适合作为索引比B树更适合作为索引的结构——B树总结 MySQL 使用 B树索引数据结构&#xff08;因为默认使用 innodb 存储引擎&#xff09; B树&#xff1a;有序数组 平衡多叉树&#xff1b;B树&#xff1a;有序数组链表 平衡多叉树…

shell中执行hive指令以及hive中执行shell和hdfs指令语法

0. 简介 主要介绍了三种环境命令执行语法&#xff1a; shell中执行hive指令hive中执行shell指令hive中执行hdfs指令 1. shell中执行hive指令 语法&#xff1a;hive [-hiveconf xy]* [<-i filename>]* [<-f filename> | <-e query-string>] [-S] 说明&…

MySQL系列之如何在Linux只安装客户端

导览 前言Q&#xff1a;如何安装一个Linux环境下的MySQL客户端一、准备文件1. 确认Server版本2. 选择Client安装文件 二、下载并安装1. 下载1.1 寻找文件1.2 文件说明 2. 安装2.1 上传至Linux服务器2.2 执行安装 三、连接验证1. 确认远程授权2. 建立远程连接 结语精彩回放 前言…

C++20 概念与约束(3)—— 约束的进阶用法

1、再谈约束主句与从句 上一篇文章中提到过约束可以无限嵌套。末尾也提到不考虑嵌套约束的情况下&#xff0c;模板因为 SFINAE 规则的存在&#xff0c;其中 requires 子句只要存在返回值&#xff0c;只有可能是 true 这一种结果。在非模板中&#xff0c;如果 requires 子句中的…

进程启动时,main 函数是如何被找到的?

Linux中一个进程是如何被启动起来的&#xff1f; 一、进程是怎么启动的&#xff1f;二、进程内存空间分段三、进程的入口函数四、总结 一、进程是怎么启动的&#xff1f; 当一个程序被执行时&#xff0c;怎么看出进程的运行呢&#xff1f;一个进程是怎么启动的&#xff1f;为什…

关于 el-table 的合计行问题

目录 一.自定义合计行 二.合计行不展示&#xff0c;只有缩放/变大窗口或者F12弹出后台时才展示 三.合计行出现了表格滚动条下方 四.合计行整体样式的修改 五.合计行单元格样式修改 1.css 2.jsx方式 六.合计行单元格合并 一.自定义合计行 通过 show-summary 属性开启合计…

十三:java web(5)-- Spring数据持久层

目录 Spring 数据持久层 1. Spring 与 JDBC 1.1 使用 Spring 管理数据库连接 1.1.2 Apache Commons DBCP 基于配置文件xml 使用 1.1.3 Apache Commons DBCP 基于配置类使用 1.1.4 HikariCP 基于配置文件xml 使用 推荐使用 Spring Boot 默认连接池 1.1.5 HikariCP 基于配置…

初学者指南:用例图——开启您的软件工程之旅

目录 背景&#xff1a; 基本组成&#xff1a; 关联&#xff08;Assciation&#xff09;&#xff1a; 包含&#xff08;Include&#xff09;&#xff1a; 扩展&#xff08;Extend&#xff09;&#xff1a; 泛化&#xff08;Inheritance&#xff09;&#xff1a; 完整银行…