1.基础知识(补充)

File协议:

FIle协议也叫本地文件传输协议 ,主要用于访问本地计算机中的文件,就如同在Windows资源管理器中打开文件或者通过右键单击‘打开’一样。即File协议是访问你本机的文件资源。
要使用File协议,基本的格式如下:file:///文件路径。

2.后端依赖导入Maven

这里使用到了hutool工具,很好用,不过建议新手多了解底层,在使用工具

<!-- 文件上传工具类 -->
	<dependency>
         <groupId>commons-fileupload</groupId>
         <artifactId>commons-fileupload</artifactId>
         <version>1.4</version>
     </dependency>
<!-- hutool 工具类 -->
            <dependency>
                <groupId>cn.hutool</groupId>
                <artifactId>hutool-all</artifactId>
                <version>5.8.8</version>
            </dependency>

3.后端Controller代码(核心)

看不懂代码请认真看代码上面的注释,写的比较详细了,如果有什么不懂的,或者有什么问题,可以在评论区指出,都会回答的!!!为的就是共同学习!!!

这个项目我用到的是SpringSecurity,然后通过一个BaseController封装了SecurityContextHolder来获取当前登录用户的信息,其次就是用到了一些定义好的变量

将上传的文件通过前端表单传给后端,后端通过file.transferTo()方法下载到本地

@PostMapping("/avatar")
    public R<Map<String,Object>> avatar(MultipartFile file) throws IOException {
    	// 获取当前登录用户
        LoginUser loginUser = getLoginUser();
        // 文件名称  时间日期+文件名_uuid+后缀
        String fileName = StrUtil.format("{}/{}_{}.{}", DateUtil.format(DateUtil.date(),"yyy/MM/dd"), FilenameUtils.getBaseName(file.getOriginalFilename()),DateUtil.format(new Date(),"yyyyMMdd")+ IdUtil.fastUUID(),FilenameUtils.getExtension(file.getOriginalFilename()));
        // 父目录
        String baseDir = WenJianConfig.getAvatarPath();
        //路径拼接
        File desc = new File(baseDir + File.separator + fileName);
        if (!desc.exists())
        {
            if (!desc.getParentFile().exists())
            {
                desc.getParentFile().mkdirs();
            }
        }
        // 下载
        file.transferTo(desc);
        int dirLastIndex = WenJianConfig.getProfile().length() + 1;
        // 截取upload/下的名称存入数据库
        String currentDir = baseDir.substring(dirLastIndex);
		// /profile/avatar/2022/10/10/293a05e068a7dfb298c87238de858130_2022101031242e4a-079a-4d4b-9c5c-139f5d2152ab.jpeg
   		// Constants.RESOURCE_PREFIX = "/profile";
        String avatar = Constants.RESOURCE_PREFIX + "/" + currentDir + "/" + fileName;
        // 修改数据库中的头像路径
        iSysUserService.updateUserAvatar(loginUser.getUser().getUsername(),avatar);
        Map<String, Object> map = new HashMap<>();
        // 将头像路径返回,这里是为了头像上传后有一个回显的效果
        map.put("imgUrl",avatar);
        // 将缓存中的对象信息进行一个更新
        loginUser.getUser().setAvatar(avatar);
        tokenUtil.setLoginUser(loginUser);
        return R.ok(map);
    }

4.配置代码(核心)

在application.yml中配置本地保存的路径,后面想改下载的路径可以直接在配置文件中修改

# 项目相关配置
wenjian:
  # 文件路径 示例( Windows配置D:/wenjian/uploadPath,Linux配置 /home/wenjian/uploadPath)
  profile: D:/wenjian/uploadPath

获取yml中配置路径的属性值

package com.sky.common.config;

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.stereotype.Component;

/**
 * @author 尹稳健~
 * @version 1.0
 * @time 2022/10/9
 */
@Component
@ConfigurationProperties(prefix = "wenjian")
public class WenJianConfig {
    /** 上传路径 */
    private static String profile;

    public static String getProfile() {
        return profile;
    }

    public void setProfile(String profile) {
        WenJianConfig.profile = profile;
    }

    /**
     * 获取导入上传路径
     */
    public static String getImportPath()
    {
        return getProfile() + "/import";
    }

    /**
     * 获取头像上传路径
     */
    public static String getAvatarPath()
    {
        return getProfile() + "/avatar";
    }

    /**
     * 获取下载路径
     */
    public static String getDownloadPath()
    {
        return getProfile() + "/download/";
    }

    /**
     * 获取上传路径
     */
    public static String getUploadPath(){
        return getProfile() + "/upload";
    }
}

这个时候就有人会问如何进行一个头像回显?
就拿这个路径进行举例:

/profile/avatar/2022/10/10/293a05e068a7dfb298c87238de858130_2022101031242e4a-079a-4d4b-9c5c-139f5d2152ab.jpeg

凭什么网页拿着这玩意可以直接展示出来一张图片?
因为在后端这里进行一个路径映射

@Configuration
public class MyWebConfigurer implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {

        /** 本地文件上传路径 */
        // Constants.RESOURCE_PREFIX = "/profile"
        // WenJianConfig.getProfile() = 你本地存储的位置
        registry.addResourceHandler(Constants.RESOURCE_PREFIX + "/**")
                .addResourceLocations("file:" + WenJianConfig.getProfile() + "/");
    }

}

图片展示在网页上
在这里插入图片描述

5.前端代码

前端使用的是Vue+ElementUI,所以我只截图关键代码,谢谢!!

参数解读:

  • action:是必须指定的,这对应着你后端的接口。
  • headers:我这里为什么指定了呢?一开始我是没有指定,但是我发现如果你不指定,那么你通过点击确定按钮后,后端不会进行一个响应,因为SpringSecurity把他拦截下来了,因为你本次请求没有携带token信息,所以这里我添加了一个headers。
  • on-success:这个也是关键参数,文件上传成功时的钩子,将上传的文件流传给后端进行接收,后端再将数据进行响应回前端 。
<el-upload
      class="avatar-uploader"
      action="http://localhost:8080/manage/sys/user/avatar"
      :show-file-list="false"
      :on-success="handleAvatarSuccess"
      :before-upload="beforeAvatarUpload"
      :headers="headerObj"
    >
      <img v-if="avatar" :src="avatar" class="img-circle img-lg" />
      <i v-else class="el-icon-plus avatar-uploader-icon"></i>
    </el-upload>


<script>
export default {
methods: {
    handleAvatarSuccess(res, file) {
      let formData = new FormData();
      // 将文件传给后端下载
      formData.append("file", file);
      this.$message.success(res.msg);
      this.avatar = "http://localhost:8080" + res.data.imgUrl;
      // 将数据保存再vuex中
      this.$store.commit("setAvatar", this.avatar);
    },
    beforeAvatarUpload(file) {
      const isJPG = file.type === "image/jpeg";
      const isLt2M = file.size / 1024 / 1024 < 2;

      if (!isJPG) {
        this.$message.error("上传头像图片只能是 JPG 格式!");
      }
      if (!isLt2M) {
        this.$message.error("上传头像图片大小不能超过 2MB!");
      }
      return isJPG && isLt2M;
    },
  },
}
</script>

6.总结

  1. 文件上传不难,关键点在前端接收文件,然后将文件传给后端,后端将文件通过流的方式下载到指定的位置。
  2. 稍微难一点的地方就是图片回显,只需要将本地的路径返回给前端就行通过file:/文件路径,的方式进行一个图片的回显
Logo

前往低代码交流专区

更多推荐