5.【SpringBoot3】文件上传

已于 2024-01-29 14:22:10 修改
阅读量2.1k 收藏 20
点赞数 20
分类专栏： SpringBoot 文章标签： 文章管理系统 springboot 后端 java 文件上传
于 2024-01-25 17:31:12 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_44378854/article/details/135828579
版权

文章目录

1. 文件上传到本地

需求分析

在用户更换头像或发布文章时，需要携带一个图片的 url 地址，该 url 地址是当用户访问文件上传接口，将图片上传成功后，服务器返回的地址。所以，后台需要提供一个文件上传接口，用来接收前端提交的文件数据，并且返回文件的访问地址。

在这里插入图片描述

接口文档

在这里插入图片描述

文件上传知识回忆

前端页面文件上传三要素：

  • 请求方式必须是 post；
  • 表单的编码类型必须是 multipart/form-data；
  • 文件表单项对应的类型必须是 file。

在这里插入图片描述

这三个要素满足后，用户就可以选择要上传的文件，点击提交按钮，最终把文件内容提交给服务器。当服务器接收到该请求后，如果服务器中的代码是使用 SpringMVC 框架编写的，我们就可以在方法上声明一个 MultipartFile 类型的参数，用来接收上传的文件内容。MultipartFile 提供了很多方法：

在这里插入图片描述
接口实现思路

Controller 中声明用于上传文件的 upload()方法，方法内部需要借助 MultipartFile 提供的 api，把文件内容写入本地磁盘文件，因此方法上要声明一个 MultipartFile 类型的参数。

在这里插入图片描述

现在还没有把文件内容上传到阿里云服务器，我们先把文件存储到服务器本地，保证接口访问是正常的，接口没问题后，再把文件上传到服务器测试。

@RestController
public class FileUploadController {
    @PostMapping("/upload")
    public Result<String> upload(MultipartFile file) throws IOException {
        //把文件内容存储到本地磁盘

        //获取文件原始的名称
        String originalFilename = file.getOriginalFilename();
        //file.transferTo的异常直接抛出去
        //再次存储的时候使用原来的文件名
        file.transferTo(new File("C:\\Users\\xxx\\Desktop\\files\\"+originalFilename));
        return Result.success("url访问地址...");
    }
}

postman 测试：

在这里插入图片描述

点击 select file 选择要上传的文件：

在这里插入图片描述

打开文件：

在这里插入图片描述

上传成功：

在这里插入图片描述

在这里插入图片描述

但是，现在的代码中还存在bug。当我们在 postman 中针对刚刚选择的图片再次点击 send 时，files 文件夹中并没有出现两张图片。原因是后上传的图片与之前上传的图片重名，导致之前的图片被覆盖了。在现实中，很有可能出现需要上传两张同名图片的需求，比如两个用户上传的图片同名。因此这个问题需要解决一下。

解决方式就是保证上传时的文件名唯一：在文件后缀名前面拼接UUID：

在这里插入图片描述

再次上传：

在这里插入图片描述

现在只是通过将文件上传到本地的方式模拟了将文件上传到服务器的过程。下面来介绍将文件上传到服务器的实现方式。

2. 文件上传到云服务器

云服务器会提供很多服务，当计算机连接上云服务器并开通某个服务后后就可以使用该服务了。

在这里插入图片描述

在本节，我们使用阿里云的对象存储服务。

使用云对象存储 OSS（Object Storage Service），可以通过网络随时存储和调用包括文本、图片、音频和视频等在内的各种文件。

使用第三方服务的通用思路

  • 准备工作：在服务提供商网站上注册用户，开通对应服务
  • 参照官方 SDK 编写入门程序：引入阿里云 OSS 相关的 jar 包，并参照提供的示例代码编写程序
  • 参照入门程序，将功能集成到自己的代码中使用

SDK：Software Development Kit
的缩写，软件开发工具包，包括辅助软件开发的依赖（jar包）、代码示例等，都可以叫做SDK。

2.1 准备工作

在服务提供商网站上注册用户，开通对应服务

在这里插入图片描述

① 登录之后，点击控制台

在这里插入图片描述

② 查看阿里云提供的所有服务

在这里插入图片描述
在这里插入图片描述

③ 搜索对象存储 OSS

在这里插入图片描述

④ 首次使用 OSS 需要开通
在这里插入图片描述
⑤ 按照提示开通后，开始创建 bucket

在这里插入图片描述

⑥ 填写必要信息，创建 bucket

在这里插入图片描述

⑦ 创建成功后，进入 bucket

在这里插入图片描述

⑧ 概览中展示了 bucket 基本信息和访问地址

在这里插入图片描述

⑨ 获取 AccessKey：

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述
在这里插入图片描述

根据提示一步一步操作就能获取到 AccessKey。至此，准备工作完成。

2.2 参照官方 SDK 编写入门程序

导入阿里云 OSS 相关的依赖坐标，并参照提供的示例代码编写程序。

(1) 导入 OSS 相关依赖坐标

① 左侧点击概览：

在这里插入图片描述

② 滑动到底部，点击 SDK 下载

在这里插入图片描述

③ 找到 Java 版本，点击查看文档，会弹出帮助文档。点击“文档中心打开”

在这里插入图片描述

④ 点击”安装“

在这里插入图片描述

⑤ 将所需依赖坐标导入我们的 pom.xml 文件：

在这里插入图片描述

(2) 参照提供的示例代码编写程序

① 因为是要上传文件，所以点击：对象/文件➡上传文件➡简单上传

在这里插入图片描述

② 此处给出了一个示例代码，copy 一下

在这里插入图片描述

copy 的示例代码如下：

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";
        // 填写Object完整路径，完整路径中不能包含Bucket名称，例如exampledir/exampleobject.txt。
        String objectName = "exampledir/exampleobject.txt";

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

        try {
            // 填写字符串。
            String content = "Hello OSS，你好世界";

            // 创建PutObjectRequest对象。
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, new ByteArrayInputStream(content.getBytes()));

            // 如果需要上传时设置存储类型和访问权限，请参考以下示例代码。
            // ObjectMetadata metadata = new ObjectMetadata();
            // metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard.toString());
            // metadata.setObjectAcl(CannedAccessControlList.Private);
            // putObjectRequest.setMetadata(metadata);
           
            // 上传字符串。
            PutObjectResult result = ossClient.putObject(putObjectRequest);            
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

③ 修改示例代码

public class Demo {

    @Test
    public void test() throws Exception {
        // Endpoint：bucket概览中的访问端口->外网访问的地域节点
        String endpoint = "https://oss-cn-beijing.aliyuncs.com";
        // 阿里云为了防止AccessKeyId和AccessKeySecret泄露，建议以配置环境变量的方式来使用
        // 这里是测试代码，就不再配置环境变量了，直接定义两个变量来模拟，值都改成自己的
        String ACCESS_KEY_ID="**********";
        String ACCESS_KEY_SECRET="**********";
        // Bucket名称
        String bucketName = "big-event-bucket1";
        // 要存储的对象的名称，这里的对象可以是字符串、图片、视频等
        String objectName = "cat.jpg";

        // 创建OSSClient实例
        OSS ossClient = new OSSClientBuilder().build(endpoint, ACCESS_KEY_ID, ACCESS_KEY_SECRET);

        try {
            // 借助图片输入流对象构建出PutObjectRequest对象
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, new FileInputStream("C:\\Users\\xxx\\Desktop\\cat.jpg"));

            // 上传到服务器
            PutObjectResult result = ossClient.putObject(putObjectRequest);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

(3) 运行代码

上传成功：

在这里插入图片描述

点击图片名称，弹出图片具体信息。复制图片在服务器上的 url。

在这里插入图片描述

在浏览器中输入图片在服务器上的 url，搜索。此时已从服务器上下载了图片。

在这里插入图片描述

虽然上面相对于阿里云提供的示例代码该类很多，但只要完成这个 Demo 的改造，今后在一般情况下需要改的地方就只有下面两处：要存储的对象的名称、输入流中要存储的对象在本地的位置。

在这里插入图片描述

2.3 案例集成 OSS

参照入门程序，将功能集成到自己的代码中使用。

为了使用方便，需要把上面改造成功的代码封装成一个工具类。将来哪里需要使用，直接调用工具类的方法即可。

public class AliOssUtil {
    //这四个一般不变，所以抽取到成员处，声明为静态常量
    public static final String ENDPOINT = "https://oss-cn-beijing.aliyuncs.com";//区域节点
    public static final String ACCESS_KEY_ID="LTAI5t9NJbszDF431vYUkzbh";
    public static final String ACCESS_KEY_SECRET="d82arCTGqH3Turz4HY3NA4a9RufHn0";
    public static final String BUCKET_NAME = "big-event-bucket1";// Bucket名称

    // objectName: 要存储的对象的名称，这里的对象可以是字符串、图片、视频等
    // 方法内部可能发生变化的是objectName和输入流，因此以参数的方式暴露出去
    // 方法要返回图片在服务器上的访问地址，因此返回值是String类型
    public static String upLoadFile(String objectName, InputStream inputStream) throws Exception {

        // 创建OSSClient实例
        OSS ossClient = new OSSClientBuilder().build(ENDPOINT, ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        String url = ""; //为了返回url，先声明一个空字符串
        try {
            PutObjectRequest putObjectRequest = new PutObjectRequest(BUCKET_NAME, objectName, inputStream);
            PutObjectResult result = ossClient.putObject(putObjectRequest);//上传到服务器
            //如果下面的代码不报错，就该给url赋值了
            //url组成：https://bucket名称.区域节点(去掉https://)/objectName
            //ENDPOINT.lastIndexOf("/")+1: 在ENDPOINT中，从最后一个"/"的下一个位置开始截取字符串
            url="https://"+BUCKET_NAME+"."+ENDPOINT.substring(ENDPOINT.lastIndexOf("/")+1)+"/"+objectName;
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
        return url;
    }
}

现在工具类准备好了，以后需要将文件上传阿里云只需调用 upLoadFile() 方法即可。

在 FileUploadController 中，之前我们将文件存储到了本地磁盘，现在不需要了，直接调用 upLoadFile() 方法将文件上传服务器。upLoadFile() 方法需要传递两个参数，filename 可以作为传入的第一个参数 objectName；第二个参数是文件输入流，MultipartFile 提供的 getInputStream() 方法可以提供该参数。最后将 upLoadFile() 方法返回的 url 响应给浏览器。

@RestController
public class FileUploadController {
    @PostMapping("/upload")
    public Result<String> upload(MultipartFile file) throws Exception {
        //把文件内容上传到阿里云服务器

        //获取原始文件名
        String originalFilename = file.getOriginalFilename();
        //使用UUID生成文件名，保证文件名唯一，从而防止文件被覆盖
        //originalFilename.lastIndexOf("."): 从文件名的最后一个"."处开始截取字符串(包括".")，即获取原始文件后缀名
        String filename = UUID.randomUUID().toString()+originalFilename.substring(originalFilename.lastIndexOf("."));
        // file.transferTo(new File("C:\\Users\\xxx\\Desktop\\files\\"+filename));
        //upLoadFile()方法上的异常直接抛出去即可
        String url = AliOssUtil.upLoadFile(filename, file.getInputStream());
        return Result.success(url);
    }
}

postman 测试：

在这里插入图片描述

在浏览器中输入文件访问地址，可以下载：

在这里插入图片描述

雾眠气泡水:)
关注
  • 20
    点赞
  • 踩
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【SpringBoot】39、SpringBoot上传文件至项目resources目录
Asurplus
11-24 21万+
当我们没有搭建单独的文件服务器时，我们需要将文件上传至项目目录下，今天我们就学习如何上传文件到项目的resources目录下 一、引入依赖 <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.3.3</version> </depende
SpringBoot 上传文件示例
清山博客
05-22 278
【代码】SpringBoot 上传文件示例。
SpringBoot文件上传
热门推荐
m0_59092234的博客
07-28 2万+
SpringMVC对文件上传做了简化，在SpringBoot中对此做了更进一步的简化，文件上传更为方便。根据这里的配置可以看出，如果开发者没有提供MultipartResolver，那么默认采用的MultipartResolver就是StandardServletMultipartResolver。因此，在SpringBoot中上传文件甚至可以做到零配置。下面来看具体上传过程。...
Springboot 文件上传
小林的博客
07-11 2703
文件上传，是指将本地图片、视频、音频等文件上传到服务器，供其他用户浏览或下载的过程。文件上传在项目中应用非常广泛，我们经常发微博、发微信朋友圈都用到了文件上传功能。在进行文件上传时，我们点击加号或者是点击图片，就可以选择手机或者是电脑本地的图片文件了。当我们选择了某一个图片文件之后，这个文件就会上传到服务器，从而完成文件上传的操作。
Java利用阿里云OSS/本地存储实现文件上传功能
逐梦苍穹的博客
02-08 4446
本文介绍Java实现文件存储和回显(阿里云OSS和本地)
SpringBoot3里的文件上传
最新发布
qq_74474809的博客
08-05 1252
跟着黑马程序员学习SpringBoot3+Vue3的学习笔记！！！！！！
Spring Boot 中文件上传
????
01-30 3198
本博客详细讲解了在SpringBoot中如何使用SpringMVC中的文件上传功能
Spring boot文件上传
weixin_46102505的博客
11-12 4639
本位文描写了spring boot的文件上传，并对其整合成工具类，以便以后使用。 引用了文章：https://blog.csdn.net/qq_43581790/article/details/123811775
java springboot 文件上传，多文件上传.zip
01-14
在Java SpringBoot框架中，文件上传是一个常见的需求，尤其在构建Web应用时。SpringBoot提供了简单易用的API来处理文件上传，无论是单文件还是多文件上传。本示例程序将详细阐述如何实现这一功能。 首先，我们需要...
SpringBoot实现文件上传和下载.docx
12-10
在Spring Boot应用中，文件上传和下载是常见的功能需求，特别是在构建Web应用程序时。这篇文章将指导你如何使用Spring Boot来实现这两个操作。 首先，我们需要创建一个Spring Boot项目。在创建新项目时，需要添加...
vue+springboot 大文件上传
01-23
在大文件上传方面，SpringBoot 提供了支持文件上传的API，我们可以利用这些API来处理文件接收和存储。 ### 分片上传 大文件分片上传是一种优化策略，通过将大文件拆分为多个小块（片段）进行上传，然后在服务器端...
SpringBoot 实现文件上传到本地目录 并返回可访问的文件地址.rar
05-20
在Spring Boot应用中，文件上传是一项常见的功能，它允许用户通过Web接口上传文件，并将这些文件存储在服务器的本地目录中。本项目的核心是利用Spring Boot的MVC特性来处理文件上传请求，以及构建一个安全、可靠且...
springboot文件上传
Starbright.的博客
04-11 2万+
/</</</</其中后端处理文件上传的请求地址为/uploadFile，请求方法为POST。在文件上传时需要设置form表单的enctype属性为“multipart/form-data”。
spring boot文件上传
辞客/的博客
07-28 2374
文件上传，是指将本地图片、视频、音频等文件上传到服务器，供其他用户浏览或下载的过程。文件上传在项目中应用非常广泛，我们经常发微博、发微信朋友圈都用到了文件上传功能。
springboot配置application.yml，文件上传配置
11-06
springboot配置application.yml文件上传配置可以通过以下步骤实现： 1.在application.yml文件中添加以下配置： ``` spring: servlet: multipart: max-file-size: 10MB # 设置上传文件的最大大小 max-request-size: 100MB # 设置上传请求的最大大小 enabled: true # 开启文件上传功能 ``` 2.在Controller中添加以下代码： ``` @PostMapping("/upload") public String upload(@RequestParam("file") MultipartFile file) { // 处理文件上传逻辑 return "上传成功"; } ``` 3.在前端页面中添加文件上传表单： ``` <form method="post" enctype="multipart/form-data" action="/upload"> <input type="file" name="file"> <button type="submit">上传</button> </form> ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值