Spring Boot开发之文件上传和异常处理

1 文件上传

1 前端表单

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

2 后台接收

    /**
     * MultipartFile 自动封装上传过来的文件
     * @param email
     * @param username
     * @param headerImg
     * @param photos
     * @return
     */
    @PostMapping("/upload")
    public String upload(@RequestParam("email") String email,
                         @RequestParam("username") String username,
                         @RequestPart("headerImg") MultipartFile headerImg,
                         @RequestPart("photos") MultipartFile[] photos) throws IOException {

        log.info("上传的信息：email={}，username={}，headerImg={}，photos={}",
                email,username,headerImg.getSize(),photos.length);

        if(!headerImg.isEmpty()){
            // 保存到文件服务器，OSS服务器
            String originalFilename = headerImg.getOriginalFilename();
            headerImg.transferTo(new File("D:\\cache\\"+originalFilename));
        }

        if(photos.length > 0){
            for (MultipartFile photo : photos) {
                if(!photo.isEmpty()){
                    String originalFilename = photo.getOriginalFilename();
                    photo.transferTo(new File("D:\\cache\\"+originalFilename));
                }
            }
        }

        return "main";
    }

3 配置原理

**文件上传自动配置类-MultipartAutoConfiguration-**MultipartProperties

• 自动配置好了 StandardServletMultipartResolver 【文件上传解析器】

  • 1 请求进来使用文件上传解析器判断（isMultipart）并封装（resolveMultipart，返回MultipartHttpServletRequest）文件上传请求

  • 2 参数解析器来解析请求中的文件内容封装成MultipartFile

  • 3 将request中文件信息封装为一个Map

2 异常处理

1 错误处理

1 默认规则

默认情况下，Spring Boot提供/error处理所有错误的映射

对于机器客户端，它将生成JSON响应，其中包含错误，HTTP状态和异常消息的详细信息。对于浏览器客户端，响应一个“ whitelabel”错误视图，以HTML格式呈现相同的数据

要对其进行自定义，添加View解析为error

• 要完全替换默认行为，可以实现 ErrorController 并注册该类型的Bean定义，或添加ErrorAttributes类型的组件以使用现有机制但替换其内容
• error/下的4xx，5xx页面会被自动解析

2 定制错误处理逻辑

自定义错误页:

• error/404.html error/5xx.html；有精确的错误状态码页面就匹配精确，没有就找 4xx.html；如果都没有就触发白页

@ControllerAdvice+@ExceptionHandler处理全局异常；底层是 ExceptionHandlerExceptionResolver 支持的

@ResponseStatus+自定义异常 ；底层是 ResponseStatusExceptionResolver ，把responsestatus注解的信息底层调用 response.sendError(statusCode, resolvedReason)；tomcat发送的/error

Spring底层的异常，如 参数类型转换异常

• DefaultHandlerExceptionResolver 处理框架底层的异常

自定义实现 HandlerExceptionResolver 处理异常；可以作为默认的全局异常处理规则

ErrorViewResolver 实现自定义处理异常

• response.sendError 。error请求就会转给controller
• 异常没有任何人能处理。tomcat底层 response.sendError。error请求就会转给controller
• basicErrorController 要去的页面地址是 ErrorViewResolver

2 异常处理自动配置原理

ErrorMvcAutoConfiguration 自动配置异常处理规则

• 容器中的组件：类型：DefaultErrorAttributes -> id：errorAttributes
  • DefaultErrorAttributes 定义错误页面中可以包含哪些数据
• **容器中的组件：类型：**BasicErrorController --> id：basicErrorController（json+白页 适配响应）
  • 处理默认 /error 路径的请求；页面响应 new ModelAndView(“error”, model)；
  • 容器中有组件 View->id是error；（响应默认错误页）
  • 容器中放组件 BeanNameViewResolver（视图解析器）；按照返回的视图名作为组件的id去容器中找View对象
• **容器中的组件：**类型：**DefaultErrorViewResolver -> id：**conventionErrorViewResolver
  • 如果发生错误，会以HTTP的状态码 作为视图页地址（viewName），找到真正的页面
  • error/404、5xx.html

3 异常处理流程

1 执行目标方法，目标方法运行期间有任何异常都会被catch、而且标志当前请求结束；并且用 dispatchException

2 进入视图解析流程（页面渲染）

processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);

3 mv = processHandlerException；处理handler发生的异常，处理完成返回ModelAndView

• 遍历所有的 **handlerExceptionResolvers，看谁能处理当前异常【**HandlerExceptionResolver处理器异常解析器】
• 系统默认的 异常解析器
  • DefaultErrorAttributes先来处理异常。把异常信息保存到rrequest域，并且返回null；
  • 默认没有任何人能处理异常，所以异常会被抛出
    • 没有任何人能处理最终底层就会发送 /error 请求。会被底层的BasicErrorController处理
    • 解析错误视图；遍历所有的 ErrorViewResolver 看谁能解析
    • 默认的 DefaultErrorViewResolver ,作用是把响应状态码作为错误页的地址，error/500.html
    • 模板引擎最终响应这个页面 error/500.html