文件上传下载(JavaWeb - SpringMVC - SpringBoot)

目录

1. 文章说明

2. JavaWeb实现文件上传下载

2.1 JavaWeb实现文件上传的步骤

2.2 JavaWeb实现文件上传代码

2.3 文件上传的HTTP协议说明

2.4 JavaWeb实现文件下载

 3. SpringMVC实现文件上传下载

3.1 SpringMVC实现文件上传的步骤


1. 文章说明

文件上传在Web项目开发中是一个很重要的功能点,随着技术(框架)的更新变化,不同的技术对文件上传有不同的实现方式。在上传和下载文件的使用操作上,新的技术比旧的技术实现了更便捷(更容易上手)操作方式,这是因为新技术对旧技术进行了更深层次的封装,屏蔽了底层的一些实现细节,但是这也导致我们在使用新技术的时候,大多数时候只是停留在会使用的层面,而不明白这些技术的演变过程和底层实现原理,本篇文章就从传统的JavaWeb 到 SpringMVC 再到SpringBoot实现文件上传的方式做一个总结。

2. JavaWeb实现文件上传下载

2.1 JavaWeb实现文件上传的步骤

  1. 引入可以实现文件上传的两个jar包 commons-fileupload-1.2.1.jar 和 commons-io-1.4.jar
  2. 写一个如下要求的form表单
    • 表单提交方式必须为post
    • form标签的enctype属性值必须为multipart/form-data 【enctype=multipart/form-data表示提交的数据以多段(每一个表单项一个数据段)的形式进行拼接,然后以二进制流的形式发送给服务器,因为客户端是以流的形式把信息发送给服务器段,所以在服务器段接收的时候,也需要以流的形式进行接收】
    • form表单中使用 input="file"添加要上传的文件
    • 编写服务器代码(Servlet程序)接收并处理上传的数据

2.2 JavaWeb实现文件上传代码

  1. file_upload.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>


    文件上传


    
用户名:
头 像:

2. UploadServlet.java

package com.example.web;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileItemFactory;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.IOException;
import java.util.List;

public class UploadServlet extends HttpServlet {

    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        // 1. 判断上传的数据是否为多段数据
        if(ServletFileUpload.isMultipartContent(req)){
            // 2. 创建FileItemFactory工厂实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            // 3. 创建用于解析上传数据的工具类ServletFileUpload类
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            try {
                // 4. 解析上传的数据,得到每一个表单项FileItem
                List fileItems = servletFileUpload.parseRequest(req);
                // 5. 循环判断每一个表单项,是普通表单项还是文件表单项
                for (FileItem fileItem : fileItems) {
                    if(fileItem.isFormField()){
                        // 普通表单项
                        System.out.println("表单项的name值:"+fileItem.getFieldName());
                        System.out.println("表单项的value值:"+fileItem.getString("UTF-8"));
                    }else {
                        // 文件表单项
                        System.out.println("表单项的name值:"+fileItem.getFieldName());
                        System.out.println("上传的文件名:"+fileItem.getName());
                        // 保存文件到服务器指定路径下
                        fileItem.write(new File("D:\\"+fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

2.3 文件上传的HTTP协议说明

        说明:图中 “上传的文件的数据” 并没有显示出要上传的文件数据,是因为浏览器检测到是二进制流的文件数据,就不再展示在此处了(Chrome浏览器不展示,FireFox浏览器会展示上传的文件的二进制流数据)

文件上传下载(JavaWeb - SpringMVC - SpringBoot)_第1张图片

2.4 JavaWeb实现文件下载

1. DownloadFileServlet

package com.example.web;

import org.apache.commons.io.IOUtils;
import sun.misc.BASE64Encoder;

import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URLEncoder;

public class DownloadFileServlet extends HttpServlet {

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //1、获取要下载的文件名(此处为了演示方便,写死在代码中)
        String downloadFileName = "3.jpg";

        //2、读取要下载的文件内容 (通过ServletContext对象可以读取)
        ServletContext servletContext = getServletContext();

        //3、获取要下载的文件类型
        String mimeType = servletContext.getMimeType("/pages/file/" + downloadFileName);
        System.out.println("下载的文件类型:" + mimeType);

        //4、在回传前,通过响应头告诉客户端返回的数据类型
        resp.setContentType(mimeType);

        //5、还要告诉客户端收到的数据是用于下载使用(还是使用响应头来告诉客户端)
        // Content-Disposition响应头,表示收到的数据怎么处理
        // attachment表示附件,表示下载使用
        // filename= 表示指定下载的文件名
        // url编码是把汉字转换成为%xx%xx的格式
        if (req.getHeader("User-Agent").contains("Firefox")) {
            // 如果是火狐浏览器使用Base64编码
            resp.setHeader("Content-Disposition", "attachment; filename==?UTF-8?B?" + new BASE64Encoder().encode("中国.jpg".getBytes("UTF-8")) + "?=");
        } else {
            // 如果不是火狐,是IE或谷歌,使用URL编码操作
            resp.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode("中国.jpg", "UTF-8"));
        }
        /**
         * /斜杠被服务器解析表示地址为http://ip:prot/工程名/  映射 到代码的Web目录
         */
        InputStream resourceAsStream = servletContext.getResourceAsStream("/pages/file/" + downloadFileName);
        // 获取响应的输出流
        OutputStream outputStream = resp.getOutputStream();
        //3、把下载的文件内容回传给客户端 ,读取输入流中全部的数据,复制给输出流,输出给客户端
        IOUtils.copy(resourceAsStream, outputStream);
    }
}

2. 文件下载的HTTP协议头

  • 火狐浏览器

文件上传下载(JavaWeb - SpringMVC - SpringBoot)_第2张图片

  •  谷歌浏览器

文件上传下载(JavaWeb - SpringMVC - SpringBoot)_第3张图片

 3. SpringMVC实现文件上传下载

3.1 SpringMVC实现文件上传的步骤

  • 在pom.xml文件中导入文件上传所需的jar包坐标
           
            
                commons-fileupload
                commons-fileupload
                1.4
            
  • 要求form表单提交方式为post,且添加属性enctype=multipartr/form-data
    
    
    
        
        测试文件上传和下载
    
    
    通过ResponseEntity下载服务器中的文件到客户端
    用户名:
    头 像:
  • SpringMVC中将上传的文件封装到MultipartFile对象中,通过此对象可以获取文件相关信息,需要在SpringMVC的配置文件中添加如下配置:
    
    
  • SpringMVC中的控制器方法

     // 文件上传
        @RequestMapping("/testUp")
        public String testUp(MultipartFile photo,HttpSession session,String username) throws IOException {
            // 可以通过控制器方法的形参获取普通表单项的内容
            System.out.println("username = " + username);
    
            //获取上传的文件的文件名
            String fileName = photo.getOriginalFilename();
            System.out.println("fileName = " + fileName);
    
            //处理文件重名问题
            String hzName = fileName.substring(fileName.lastIndexOf("."));
            System.out.println("hzName = " + hzName);
            fileName = UUID.randomUUID() + hzName;
            System.out.println("hzName = " + hzName);
    
            //获取服务器中photo目录的路径
            ServletContext servletContext = session.getServletContext();
            String photoPath = servletContext.getRealPath("photo");
            System.out.println("photoPath = " + photoPath);
            File file = new File(photoPath);
            if(!file.exists()){
                file.mkdir();
            }
            String finalPath = photoPath + File.separator + fileName;
            System.out.println("finalPath = " + finalPath);
            //实现上传功能,需要使用到 commons-fileupload-1.2.1.jar 及其所依赖的 commons-io-1.4.jar
            photo.transferTo(new File(finalPath));
            return "success";
        }
        // 文件下载
        @RequestMapping("/testDown")
        public ResponseEntity testResponseEntity(HttpSession session) throws IOException {
            //获取ServletContext对象
            ServletContext servletContext = session.getServletContext();
            //获取服务器中文件的真实路径
            String realPath = servletContext.getRealPath("/static/img/1.jpg");
            System.out.println("realPath = " + realPath);
            //创建输入流
            InputStream is = new FileInputStream(realPath);
            //创建字节数组
            //byte[] bytes = new byte[is.available()];
            byte[] buffer = new byte[1024];
            int len = 0;
            ByteArrayOutputStream out = new ByteArrayOutputStream();
            while ((len = is.read(buffer)) != -1){
                out.write(buffer,0,len);
            }
            byte[] bytes = out.toByteArray();
            //将流读到字节数组中
            //is.read(bytes);
            //创建HttpHeaders对象设置响应头信息
            MultiValueMap headers = new HttpHeaders();
            //设置要下载方式以及下载文件的名字
            headers.add("Content-Disposition", "attachment;filename=1.jpg");
            String mimeType = servletContext.getMimeType("/static/img/1.jpg");
            headers.add("Content-Type",mimeType);
            //设置响应状态码
            HttpStatus statusCode = HttpStatus.OK;
            //创建ResponseEntity对象
            ResponseEntity responseEntity = new ResponseEntity(bytes, headers, statusCode);
            //关闭输入流
            is.close();
            return responseEntity;
        }

你可能感兴趣的:(Java,java,idea)