← 返回学习路线

SYSTEM

文件传输

Java基础文件传输system
src/content/notes/system/文件传输.md

文件传输

上传下载

上传文件过程:

MultipartResolver接口:

  • MultipartResolver 接口定义了文件上传过程中的相关操作,并对通用性操作进行了封装
  • MultipartResolver 接口底层实现类 CommonsMultipartResovler
  • CommonsMultipartResovler 并未自主实现文件上传下载对应的功能,而是调用了 apache 文件上传下载组件

文件上传下载实现:

  • 导入坐标

    <dependency>
        <groupId>commons-fileupload</groupId>
        <artifactId>commons-fileupload</artifactId>
        <version>1.4</version>
    </dependency>
  • 页面表单 fileupload.jsp

    <form method="post" action="/upload" enctype="multipart/form-data">
        <input type="file" name="file"><br>
        <input type="submit" value="提交">
    </form>
  • web.xml

    DispatcherServlet + CharacterEncodingFilter
  • 控制器

    @PostMapping("/upload")
    public String upload(@RequestParam("email") String email,
                         @RequestParam("username") String username,
                         @RequestPart("headerImg") MultipartFile headerImg) throws IOException {
    
        if(!headerImg.isEmpty()){
            //保存到文件服务器,OSS服务器
            String originalFilename = headerImg.getOriginalFilename();
            headerImg.transferTo(new File("H:\\cache\\" + originalFilename));
        }
        return "main";
    }

名称问题

MultipartFile 参数中封装了上传的文件的相关信息。

  1. 文件命名问题, 获取上传文件名,并解析文件名与扩展名

    file.getOriginalFilename();
  2. 文件名过长问题

  3. 文件保存路径

    ServletContext context = request.getServletContext();
    String realPath = context.getRealPath("/uploads");
    File file = new File(realPath + "/");
    if(!file.exists()) file.mkdirs();
  4. 重名问题

    String uuid = UUID.randomUUID.toString().replace("-", "").toUpperCase();
@Controller
public class FileUploadController {
    @RequestMapping(value = "/fileupload")
	//参数中定义MultipartFile参数,用于接收页面提交的type=file类型的表单,表单名称与参数名相同
    public String fileupload(MultipartFile file,MultipartFile file1,MultipartFile file2, HttpServletRequest request) throws IOException {
        System.out.println("file upload is running ..."+file);
//        MultipartFile参数中封装了上传的文件的相关信息
//        System.out.println(file.getSize());
//        System.out.println(file.getBytes().length);
//        System.out.println(file.getContentType());
//        System.out.println(file.getName());
//        System.out.println(file.getOriginalFilename());
//        System.out.println(file.isEmpty());
        //首先判断是否是空文件,也就是存储空间占用为0的文件
        if(!file.isEmpty()){
            //如果大小在范围要求内正常处理,否则抛出自定义异常告知用户(未实现)
            //获取原始上传的文件名,可以作为当前文件的真实名称保存到数据库中备用
            String fileName = file.getOriginalFilename();
            //设置保存的路径
            String realPath = request.getServletContext().getRealPath("/images");
            //保存文件的方法,通常文件名使用随机生成策略产生,避免文件名冲突问题
            file.transferTo(new File(realPath,file.getOriginalFilename()));
        }
        //测试一次性上传多个文件
        if(!file1.isEmpty()){
            String fileName = file1.getOriginalFilename();
            //可以根据需要,对不同种类的文件做不同的存储路径的区分,修改对应的保存位置即可
            String realPath = request.getServletContext().getRealPath("/images");
            file1.transferTo(new File(realPath,file1.getOriginalFilename()));
        }
        if(!file2.isEmpty()){
            String fileName = file2.getOriginalFilename();
            String realPath = request.getServletContext().getRealPath("/images");
            file2.transferTo(new File(realPath,file2.getOriginalFilename()));
        }
        return "page.jsp";
    }
}

源码解析

StandardServletMultipartResolver 是文件上传解析器

DispatcherServlet#doDispatch:

protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
    // 判断当前请求是不是文件上传请求
    processedRequest = checkMultipart(request);
    // 文件上传请求会对 request 进行包装,导致两者不相等,此处赋值为 true,代表已经被解析
    multipartRequestParsed = (processedRequest != request);
}

DispatcherServlet#checkMultipart:

  • if (this.multipartResolver != null && this.multipartResolver.isMultipart(request)):判断是否是文件请求
    • StandardServletMultipartResolver#isMultipart:根据开头是否符合 multipart/form-data 或者 multipart/
  • return this.multipartResolver.resolveMultipart(request):把请求封装成 StandardMultipartHttpServletRequest 对象

开始执行 ha.handle() 目标方法进行数据的解析

  • RequestPartMethodArgumentResolver#supportsParameter:支持解析文件上传数据

    public boolean supportsParameter(MethodParameter parameter) {
        // 参数上有 @RequestPart 注解
        if (parameter.hasParameterAnnotation(RequestPart.class)) {
            return true;
        }
    }
  • RequestPartMethodArgumentResolver#resolveArgument:解析参数数据,封装成 MultipartFile 对象

    • RequestPart requestPart = parameter.getParameterAnnotation(RequestPart.class):获取注解的相关信息
    • String name = getPartName(parameter, requestPart):获取上传文件的名字
    • Object mpArg = MultipartResolutionDelegate.resolveMultipartArgument():解析参数
      • List<MultipartFile> files = multipartRequest.getFiles(name):获取文件的所有数据
  • return doInvoke(args):解析完成执行自定义的方法,完成上传功能