前言

一次“上传文件”的点击蕴含着一轮请求,我们要做的就是针对每一次的请求进行i/o处理,并返回给前端用户

一.文件上传

文件上传,也称为upload,是指将本地图片、视频、音频等文件上传到服务器上,文件上传与下载可谓是在生活中应用十分广泛,一次上传对应一次请求,后端要做的是如何把这次请求中的文件信息转存到指定的地址

【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
以上传图片为例

在表单里,当点击或者拖拽文件上传,前端页面就会发出一次如下的请求:
【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
在后端的Controller层中怎样才能接受到前端发来的文件呢?这就要用到Apache为我们提供的两个组件,commons-fileuploadcommons-io,本质是对文件的i/o操作

基于上面两个组件,Spring框架在spring-web包中对文件上传进行了封装,大大简化了服务端代码,所以只需要在Controller的方法中声明一个MultipartFile类型的参数即可接收上传的文件,就像这样:

public class CommonController {

    @Value("${reggie.path}") //@Value注解读取配置文件中reggie的值
    private String Basepath;

    @PostMapping("/upload")
    public R<String> upload(MultipartFile file) {
        //file是一个指定文件,必须转存到指定位置,这里的形参必须命名为file!
        log.info(file.toString());

        String usedName = file.getOriginalFilename();//原始名

        String jpg = usedName.substring(usedName.lastIndexOf("."));
        String uuidName = UUID.randomUUID().toString() + jpg;//使用UUID生成32位随机名
        //创建一个目录对象
        File file1 = new File(Basepath);
        //如果目录不存在
        if (!(file1.exists())) {
            file1.mkdirs();//就按照Basepath创建一个目录
        }
        //将临时文件转存到电脑硬盘
        try {
            //通过配置文件的形式将转存路径变得更灵活
            file.transferTo(new File(Basepath + uuidName));
        } catch (IOException e) {
            e.printStackTrace();
        }
        return R.success(uuidName);//把文件名字给前端,回显数据
    }
}

要注意这里的形参必须定义为file,与前端中的表单信息一致,否则文件信息不会传到方法里。
【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
当在前端页面上传文件过后,文件信息就被存到了一个tomcat临时目录中,在本地电脑中可以找到
【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
为了实现完整的上传功能,需要将临时的文件转存到指定的位置中,如果不转存,下一次刷新文件信息就会丢失
file.transferTo(new File(Basepath+usedName));

二.改进

大家可能会发现,usedName就是用户上传文件的文件名,但难免会出现重名的情况,为了避免我们可以使用UUID生成随机文件名,但是生成的id没有“.jpg”的的后缀,所以还需要动态地去截取一下usedName,就像这样:

      String usedName= file.getOriginalFilename();//原始名
      String jpg = usedName.substring(usedName.lastIndexOf("."));//截取.jpg后缀
      String uuidName= UUID.randomUUID().toString()+jpg;//使用UUID生成32位随机名

在SpringBoot的配置类中,转存目录path是我自定义的,这就需要考虑目录存不存在的问题,对此应在转存前加上判断条件,就像这样:

//创建一个目录对象
File file1 = new File(Basepath);
//如果目录不存在
if (!(file1.exists())){
    file1.mkdirs();//就按照Basepath创建一个目录
}

三.文件下载

为了上传文件(图片)后能够回显至浏览器(上传后能看到自己上传的图片)我们需要对上传的文件进行读取、下载,本质是将文件从服务器传输到本地计算机的过程,也是文件i/o读写的一种体现形式,只不过是从服务器到浏览器再到电脑

【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
同样地,当客户端点击下载文件,一次请求就夹带了文件的id,也就是(uuidName),针对前端传来的name,在Controller层中要做出相应的i/o处理,做出响应,就像这样:

@GetMapping("/download")
//请求匹配到方法
public void download(String name, HttpServletResponse response) {
    //通过输入流读取文件内容
    try {
        FileInputStream fileInputStream = new FileInputStream(Basepath + name);
        //通过输出流,将文件写回到浏览器,在浏览器展示图片
        ServletOutputStream outputStream = response.getOutputStream();

        response.setContentType("image/jpg");//设置响应回去的是什么类型的文件

        int length = 0;       //   i/o读取 重点复习
        byte[] bytes = new byte[1024];
        while (((length = fileInputStream.read(bytes)) != -1)) {
            outputStream.write(bytes, 0, length);
            outputStream.flush();
        }

        //关闭资源
        outputStream.close();
        fileInputStream.close();

    } catch (Exception e) {
        e.printStackTrace();
    }

四.上传图片/回显图片

当为菜品添加其图示并回显至浏览器,这就涉及到文件上传下载,文件不下载到浏览器就不会回显!

【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
回显的过程,不难看出就是通过发送一个name参数传给后端的download方法并得到响应:
【SpringBoot+MyBatisPlus】文件上传与文件下载的应用与实现-LMLPHP
从上传到回显其实就是upload/download方法的调用,就像这样:

@PostMapping("/upload")
public R<String> upload(MultipartFile file) {
    //file是一个指定文件,必须转存到指定位置,这里的形参必须命名为file!
    log.info(file.toString());

    String usedName = file.getOriginalFilename();//原始名

    String jpg = usedName.substring(usedName.lastIndexOf("."));
    String uuidName = UUID.randomUUID().toString() + jpg;//使用UUID生成32位随机名
    //创建一个目录对象
    File file1 = new File(Basepath);
    //如果目录不存在
    if (!(file1.exists())) {
        file1.mkdirs();//就按照Basepath创建一个目录
    }
    //将临时文件转存到电脑硬盘
    try {
        //通过配置文件的形式将转存路径变得更灵活
        file.transferTo(new File(Basepath + uuidName));
    } catch (IOException e) {
        e.printStackTrace();
    }
    return R.success(uuidName);//把文件名字给前端,回显数据
}

@GetMapping("/download")
//请求匹配到方法
public void download(String name, HttpServletResponse response) {
    //通过输入流读取文件内容
    try {
        FileInputStream fileInputStream = new FileInputStream(new File(Basepath + name));
        //通过输出流,将文件写回到浏览器,在浏览器展示图片
        ServletOutputStream outputStream = response.getOutputStream();

        response.setContentType("image/jpg");//设置响应回去的是什么类型的文件

        int length = 0;       //   i/o读取 重点复习
        byte[] bytes = new byte[1024];
        while (((length = fileInputStream.read(bytes)) != -1)) {
            outputStream.write(bytes, 0, length);
            outputStream.flush();
        }

        //关闭资源
        outputStream.close();
        fileInputStream.close();

    } catch (Exception e) {
        e.printStackTrace();
    }

这样文件的上传与下载就get了
又是一个小技巧啊~

10-20 10:31