Vue+SpringBoot实现前后端分离的文件上传学习笔记

原文地址: luoliangDSGA’s blog博客地址: https://luoliangdsga.github.io欢迎转载，转载请注明作者及出处，谢谢！Vue+SpringBoot实现前后端分离的文件上传这篇文章需要一定Vue和SpringBoot的知识，分为两个项目，一个是前端Vue项目，一个是后端SpringBoot项目。后端项目搭建我使用的是SpringBoo...

空-白_格

5831人浏览 · 2018-08-08 23:36:56

空-白_格 · 2018-08-08 23:36:56 发布

原文地址: luoliangDSGA’s blog
博客地址: https://luoliangdsga.github.io
欢迎转载，转载请注明作者及出处，谢谢！

Vue+SpringBoot实现前后端分离的文件上传

这篇文章需要一定Vue和SpringBoot的知识，分为两个项目，一个是前端Vue项目，一个是后端SpringBoot项目。

后端项目搭建

我使用的是SpringBoot1.5.10+JDK8+IDEA
使用IDEA新建一个SpringBoot项目，一直点next即可

项目创建成功后，maven的pom配置如下

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>
    <!--加入web模块-->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-test</artifactId>
        <scope>test</scope>
    </dependency>

    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.39</version>
    </dependency>
</dependencies>

接下来编写上传的API接口

@RestController
@RequestMapping("/upload")
@CrossOrigin
public class UploadController {
    @Value("${prop.upload-folder}")
    private String UPLOAD_FOLDER;
    private Logger logger = LoggerFactory.getLogger(UploadController.class);

    @PostMapping("/singlefile")
    public Object singleFileUpload(MultipartFile file) {
        logger.debug("传入的文件参数：{}", JSON.toJSONString(file, true));
        if (Objects.isNull(file) || file.isEmpty()) {
            logger.error("文件为空");
            return "文件为空，请重新上传";
        }

        try {
            byte[] bytes = file.getBytes();
            Path path = Paths.get(UPLOAD_FOLDER + file.getOriginalFilename());
            //如果没有files文件夹，则创建
            if (!Files.isWritable(path)) {
                Files.createDirectories(Paths.get(UPLOAD_FOLDER));
            }
            //文件写入指定路径
            Files.write(path, bytes);
            logger.debug("文件写入成功...");
            return "文件上传成功";
        } catch (IOException e) {
            e.printStackTrace();
            return "后端异常...";
        }
    }
}

CrossOrigin注解：解决跨域问题，因为前后端完全分离，跨域问题在所难免，加上这个注解会让Controller支持跨域，如果去掉这个注解，前端Ajax请求不会到后端。这只是跨域的一种解决方法，还有其他解决方法这篇文章先不涉及。
MultipartFile：SpringMVC的multipartFile对象，用于接收前端请求传入的FormData。
PostMapping是Spring4.3以后引入的新注解，是为了简化HTTP方法的映射，相当于我们常用的@RequestMapping(value = “/xx”, method = RequestMethod.POST).

后端至此已经做完了，很简单。

前端项目搭建

我使用的是Node8+Webpack3+Vue2

本地需要安装node环境，且安装Vue-cli，使用Vue-cli生成一个Vue项目。

首先安装node，下载地址：https://nodejs.org/en/download/ 根据对应系统的位数下载对应的包

window用户下载.msi 文件即可，双击文件，然后安装，安装的时候可以选择更改安装路径，然后直接next一直到finish。接下来打开命令行，输入node -v 回车，输入npm -v 回车，如图所示

然后安装vue-cli，执行命令npm install -g vue-cli，再在其他盘新建一个文件夹vue，这个我们用来创建vue项目，cd 切换到vue目录下，执行如下图命令vue init webpack vue-upload

这样一个vue项目就创建好了，然后vue-upload\src\components目录下修改HelloWorld.vue文件即可，

项目创建成功之后，用WebStorm打开，就可以写一个简单的上传例子了，主要代码如下：

<template>
  <div class="hello">
    <h1>{{ msg }}</h1>
    <form>
      <input type="file" @change="getFile($event)">
      <button class="button button-primary button-pill button-small" @click="submit($event)">提交</button>
    </form>
  </div>
</template>

<script>
  import axios from 'axios';

  export default {
    name: 'HelloWorld',
    data() {
      return {
        msg: 'Welcome to Your Vue.js App',
        file: ''
      }
    },
    methods: {
      getFile: function (event) {
        this.file = event.target.files[0];
        console.log(this.file);
      },
      submit: function (event) {
        //阻止元素发生默认的行为
        event.preventDefault();
        let formData = new FormData();
        formData.append("file", this.file);
        axios.post('http://localhost:8082/upload/singlefile', formData)
          .then(function (response) {
            alert(response.data);
            console.log(response);
            window.location.reload();
          })
          .catch(function (error) {
            alert("上传失败");
            console.log(error);
            window.location.reload();
          });
      }
    }
  }
</script>

使用Axios向后端发送Ajax请求，使用H5的FormData对象封装图片数据

测试

启动服务端，直接运行BootApplication类的main方法，端口8082

启动前端，端口默认8080，cd到前端目录下，分别执行：

npm install
npm run dev

启动成功后访问localhost:8080

选择一张图片上传，可以看到，上传成功之后，后端指定目录下也有了图片文件

总结

到这里，一个前后端分离的上传demo就做完了，本篇文章是一个简单的demo，只能应对小文件的上传，后面我将会写一篇SpringBoot+Vue实现大文件分块上传，敬请期待。
附上源码，欢迎star：boot-upload。如有问题，欢迎交流！

Vue

前往低代码交流专区

更多推荐

vue 表单验证

1、6位小写字母和数字必须包含两个字母rules: [{ required: true, message: "XXX不能为空", trigger: "blur" },{ max: 6, message: "最大长度为6位字符", trigger: "blur" },{pattern: /^(?=(?:[^a-z]*[a-z]){2})[a-z0-9]{6,6}$/, //不连续的两位字母// /^