Spring Web MVC其他扩展（详解下）

文章目录

Spring MVC其他扩展（下）

异常处理

异常处理机制

异常处理概念

开发过程中是不可避免地会出现各种异常情况的，例如网络连接异常、数据格式异常、空指针异常等等。异常的出现可能导致程序的运行出现问题，甚至直接导致程序崩溃。因此，在开发过程中，合理处理异常、避免异常产生、以及对异常进行有效的调试是非常重要的。

对于异常的处理，一般分为两种方式：

• 编程式异常处理：是指在代码中显式地编写处理异常的逻辑。它通常涉及到对异常类型的检测及其处理，例如使用 try-catch 块来捕获异常，然后在 catch 块中编写特定的处理代码，或者在 finally 块中执行一些清理操作。在编程式异常处理中，开发人员需要显式地进行异常处理，异常处理代码混杂在业务代码中，导致代码可读性较差。
• 声明式异常处理：则是将异常处理的逻辑从具体的业务逻辑中分离出来，通过配置等方式进行统一的管理和处理。在声明式异常处理中，开发人员只需要为方法或类标注相应的注解（如 @Throws 或 @ExceptionHandler），就可以处理特定类型的异常。相较于编程式异常处理，声明式异常处理可以使代码更加简洁、易于维护和扩展。

站在宏观角度来看待声明式事务处理：

整个项目从架构这个层面设计的异常处理的统一机制和规范。

一个项目中会包含很多个模块，各个模块需要分工完成。如果张三负责的模块按照 A 方案处理异常，李四负责的模块按照 B 方案处理异常……各个模块处理异常的思路、代码、命名细节都不一样，那么就会让整个项目非常混乱。

使用声明式异常处理，可以统一项目处理异常思路，项目更加清晰明了！

声明式异常好处

• 使用声明式代替编程式来实现异常管理 - 让异常控制和核心业务解耦，二者各自维护，结构性更好
• 整个项目层面使用同一套规则来管理异常 - 整个项目代码风格更加统一、简洁- 便于团队成员之间的彼此协作

基于注解异常声明异常处理

声明异常处理控制器类

异常处理控制类，统一定义异常处理handler方法！

/**
 * projectName: com.gj.execptionhandler
 * 
 * description: 全局异常处理器,内部可以定义异常处理Handler!
 *//**
 * @RestControllerAdvice = @ControllerAdvice + @ResponseBody
 * @ControllerAdvice 代表当前类的异常处理controller! 
 */@RestControllerAdvicepublicclassGlobalExceptionHandler{}

声明异常处理hander方法

异常处理handler方法和普通的handler方法参数接收和响应都一致！

只不过异常处理handler方法要映射异常，发生对应的异常会调用！

普通的handler方法要使用@RequestMapping注解映射路径，发生对应的路径调用！

/**
 * 异常处理handler 
 * @ExceptionHandler(HttpMessageNotReadableException.class) 
 * 该注解标记异常处理Handler,并且指定发生异常调用该方法!
 * 
 * 
 * @param e 获取异常对象!
 * @return 返回handler处理结果!
 */@ExceptionHandler(HttpMessageNotReadableException.class)publicObjecthandlerJsonDateException(HttpMessageNotReadableException e){returnnull;}/**
 * 当发生空指针异常会触发此方法!
 * @param e
 * @return
 */@ExceptionHandler(NullPointerException.class)publicObjecthandlerNullException(NullPointerException e){returnnull;}/**
 * 所有异常都会触发此方法!但是如果有具体的异常处理Handler! 
 * 具体异常处理Handler优先级更高!
 * 例如: 发生NullPointerException异常!
 *       会触发handlerNullException方法,不会触发handlerException方法!
 * @param e
 * @return
 */@ExceptionHandler(Exception.class)publicObjecthandlerException(Exception e){returnnull;}

配置文件扫描控制器类配置

确保异常处理控制类被扫描

<!-- 扫描controller对应的包,将handler加入到ioc--><context:component-scanbase-package="com.gj.controller,
    com.gj.exceptionhandler"/>

拦截器

拦截器概念

拦截器和过滤器解决问题

• 生活中为了提高乘车效率，在乘客进入站台前统一检票
• 程序中在程序中，使用拦截器在请求到达具体 handler 方法前，统一执行检测

拦截器 VS 过滤器：

• 相似点 - 拦截：必须先把请求拦住，才能执行后续操作- 过滤：拦截器或过滤器存在的意义就是对请求进行统一处理- 放行：对请求执行了必要操作后，放请求过去，让它访问原本想要访问的资源
• 不同点 - 工作平台不同 - 过滤器工作在 Servlet 容器中- 拦截器工作在 SpringMVC 的基础上- 拦截的范围 - 过滤器：能够拦截到的最大范围是整个 Web 应用- 拦截器：能够拦截到的最大范围是整个 SpringMVC 负责的请求- IOC 容器支持 - 过滤器：想得到 IOC 容器需要调用专门的工具方法，是间接的- 拦截器：它自己就在 IOC 容器中，所以可以直接从 IOC 容器中装配组件，也就是可以直接得到 IOC 容器的支持

选择：

功能需要如果用 SpringMVC 的拦截器能够实现，就不使用过滤器。

拦截器使用

创建拦截器类

publicclassProcess01InterceptorimplementsHandlerInterceptor{// 在处理请求的目标 handler 方法前执行@OverridepublicbooleanpreHandle(HttpServletRequest request,HttpServletResponse response,Object handler)throwsException{System.out.println("request = "+ request +", response = "+ response +", handler = "+ handler);System.out.println("Process01Interceptor.preHandle");// 返回true：放行// 返回false：不放行returntrue;}// 在目标 handler 方法之后，handler报错不执行!@OverridepublicvoidpostHandle(HttpServletRequest request,HttpServletResponse response,Object handler,ModelAndView modelAndView)throwsException{System.out.println("request = "+ request +", response = "+ response +", handler = "+ handler +", modelAndView = "+ modelAndView);System.out.println("Process01Interceptor.postHandle");}// 渲染视图之后执行(最后),一定执行!@OverridepublicvoidafterCompletion(HttpServletRequest request,HttpServletResponse response,Object handler,Exception ex)throwsException{System.out.println("request = "+ request +", response = "+ response +", handler = "+ handler +", ex = "+ ex);System.out.println("Process01Interceptor.afterCompletion");}}

单个拦截器执行顺序:

• preHandle() 方法
• 目标 handler 方法
• postHandle() 方法
• 渲染视图(返回json没有此步骤)
• afterCompletion() 方法

拦截器配置

springmvc.xml

<!-- 配置拦截器--><mvc:interceptors><!-- 默认拦截器,拦截所有请求--><beanclass="com.gj.interceptor.Process01Interceptor"/></mvc:interceptors>

配置详解

默认拦截全部

<!-- 具体配置拦截器可以指定拦截的请求地址 --><mvc:interceptor><!-- 精确匹配 --><mvc:mappingpath="/common/request/one"/><beanclass="com.gj.mvc.interceptor.Process03Interceptor"/></mvc:interceptor>

精准配置

<!-- 具体配置拦截器可以指定拦截的请求地址 --><mvc:interceptor><!-- 精确匹配 --><mvc:mappingpath="/common/request/one"/><beanclass="com.gj.mvc.interceptor.Process03Interceptor"/></mvc:interceptor><mvc:interceptor><!-- /*匹配路径中的一层 --><mvc:mappingpath="/common/request/*"/><beanclass="com.gj.mvc.interceptor.Process04Interceptor"/></mvc:interceptor><mvc:interceptor><!-- /**匹配路径中的多层 --><mvc:mappingpath="/common/request/**"/><beanclass="com.gj.mvc.interceptor.Process05Interceptor"/></mvc:interceptor>

排除配置

<mvc:interceptor><!-- /**匹配路径中的多层 --><mvc:mappingpath="/common/request/**"/><!-- 使用 mvc:exclude-mapping 标签配置不拦截的地址 --><mvc:exclude-mappingpath="/common/request/two/bbb"/><beanclass="com.gj.mvc.interceptor.Process05Interceptor"/></mvc:interceptor>

多个拦截器执行顺序

• preHandle() 方法：SpringMVC 会把所有拦截器收集到一起，然后按照配置顺序调用各个 preHandle() 方法。
• postHandle() 方法：SpringMVC 会把所有拦截器收集到一起，然后按照配置相反的顺序调用各个 postHandle() 方法。
• afterCompletion() 方法：SpringMVC 会把所有拦截器收集到一起，然后按照配置相反的顺序调用各个 afterCompletion() 方法。

拦截器作用位置图解

拦截器案例

一个网站有 56个资源，其中一个为登陆资源，两个无须登录即可访问，另外三个需要登录后才能访问。如果不登录就访问那三个资源，需要拦截，并且提示登录后访问访问！

提示：登陆为模拟登陆，存储一个user可以到session即可！

访问资源的请求地址可参考：

• 登陆资源：/public/resource/login
• 公共资源1：/public/resource/one
• 公共资源2：/public/resouce/two
• 私密资源1：/private/resouce/one
• 私密资源2：/private/resouce/two
• 私密资源3：/private/resouce/three

案例实现：

声明资源类

/**
 * projectName: com.gj.controller
 * description: 公有资源控制类
 */@RestController@RequestMapping("public/resource")publicclassPublicController{/**
     * 模拟登录,将假用户数据存储到session中!
     */@GetMapping("login")publicObjectlogin(HttpSession session){
        session.setAttribute("user","root");return"login success!!";}@GetMapping("one")publicObjectone(){return"public one";}@GetMapping("two")publicObjecttwo(){return"public two";}}

PrivateController

@RestController@RequestMapping("private/resource")publicclassPrivateController{@GetMapping("one")publicObjectone(){return"private one";}@GetMapping("two")publicObjecttwo(){return"private two";}@GetMapping("three")publicObjectthree(){return"private two";}}

声明拦截器类

/**
 * projectName: com.gj.interceptor
 *
 * description: 登录保护拦截器
 */publicclassLoginProtectInterceptorimplementsHandlerInterceptor{/**
     * 登录保护方法
     * @param request current HTTP request
     * @param response current HTTP response
     * @param handler chosen handler to execute, for type and/or instance evaluation
     * @return
     * @throws Exception
     */@OverridepublicbooleanpreHandle(HttpServletRequest request,HttpServletResponse response,Object handler)throwsException{Object user = request.getSession().getAttribute("user");if(user ==null){
            response.setContentType("text/html;charset=utf-8");//没有登录
            response.getWriter().print("请先登录,再访问! <a href='/public/resource/login'>点击此处登录</a>");//拦截,不到达目标地址returnfalse;}returntrue;}}

配置拦截器类

<!-- 配置拦截器--><mvc:interceptors><mvc:interceptor><mvc:mappingpath="/private/**"/><beanclass="com.gj.interceptor.LoginProtectInterceptor"/></mvc:interceptor></mvc:interceptors>

拦截器工作原理源码

springMVC断点入口

preHandle()正序执行

postHandle()倒序执行

afterCompletion()倒序执行

参数校验

在 Web 应用三层架构体系中，表述层负责接收浏览器提交的数据，业务逻辑层负责数据的处理。为了能够让业务逻辑层基于正确的数据进行处理，我们需要在表述层对数据进行检查，将错误的数据隔绝在业务逻辑层之外。

校验概述

JSR 303 是 Java 为 Bean 数据合法性校验提供的标准框架，它已经包含在 JavaEE 6.0 标准中。JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max 等标准的注解指定校验规则，并通过标准的验证接口对Bean进行验证。
注解规则@Null标注值必须为 null@NotNull标注值不可为 null@AssertTrue标注值必须为 true@AssertFalse标注值必须为 false@Min(value)标注值必须大于或等于 value@Max(value)标注值必须小于或等于 value@DecimalMin(value)标注值必须大于或等于 value@DecimalMax(value)标注值必须小于或等于 value@Size(max,min)标注值大小必须在 max 和 min 限定的范围内@Digits(integer,fratction)标注值值必须是一个数字，且必须在可接受的范围内@Past标注值只能用于日期型，且必须是过去的日期@Future标注值只能用于日期型，且必须是将来的日期@Pattern(value)标注值必须符合指定的正则表达式JSR 303 只是一套标准，需要提供其实现才可以使用。Hibernate Validator 是 JSR 303 的一个参考实现，除支持所有标准的校验注解外，它还支持以下的扩展注解：注解规则@Email标注值必须是格式正确的 Email 地址@Length标注值字符串大小必须在指定的范围内@NotEmpty标注值字符串不能是空字符串@Range标注值必须在指定的范围内
Spring 4.0 版本已经拥有自己独立的数据校验框架，同时支持 JSR 303 标准的校验框架。Spring 在进行数据绑定时，可同时调用校验框架完成数据校验工作。在SpringMVC 中，可直接通过注解驱动 mvc:annotation-driven 的方式进行数据校验。Spring 的 LocalValidatorFactoryBean 既实现了 Spring 的 Validator 接口，也实现了 JSR 303 的 Validator 接口。只要在Spring容器中定义了一个LocalValidatorFactoryBean，即可将其注入到需要数据校验的 Bean中。Spring本身并没有提供JSR 303的实现，所以必须将JSR 303的实现者的jar包放到类路径下。

配置 mvc:annotation-driven 后，SpringMVC 会默认装配好一个 LocalValidatorFactoryBean，通过在处理方法的入参上标注 @Validated 注解即可让 SpringMVC 在完成数据绑定后执行数据校验的工作。

操作演示

导入依赖

<!-- 校验注解 --><dependency><groupId>jakarta.platform</groupId><artifactId>jakarta.jakartaee-web-api</artifactId><version>9.1.0</version><scope>provided</scope></dependency><!-- 校验注解实现--><!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator --><dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator</artifactId><version>8.0.0.Final</version></dependency><!-- https://mvnrepository.com/artifact/org.hibernate.validator/hibernate-validator-annotation-processor --><dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator-annotation-processor</artifactId><version>8.0.0.Final</version></dependency>

应用校验注解

importjakarta.validation.constraints.Email;importjakarta.validation.constraints.Min;importorg.hibernate.validator.constraints.Length;/**
 * projectName: com.gj.pojo
 */publicclassUser{//age   1 <=  age < = 150@Min(10)privateint age;//name 3 <= name.length <= 6@Length(min =3,max =10)privateString name;//email 邮箱格式@EmailprivateString email;publicintgetAge(){return age;}publicvoidsetAge(int age){this.age = age;}publicStringgetName(){return name;}publicvoidsetName(String name){this.name = name;}publicStringgetEmail(){return email;}publicvoidsetEmail(String email){this.email = email;}}

handler标记和绑定错误收集

@RestController@RequestMapping("user")publicclassUserController{/**
     * @Validated 代表应用校验注解! 必须添加!
     */@PostMapping("save")publicObjectsave(@Validated@RequestBodyUser user,//在实体类参数和 BindingResult 之间不能有任何其他参数, BindingResult可以接受错误信息,避免信息抛出!BindingResult result){//判断是否有信息绑定错误! 有可以自行处理!if(result.hasErrors()){System.out.println("错误");String errorMsg = result.getFieldError().toString();return errorMsg;}//没有,正常处理业务即可System.out.println("正常");return user;}}

测试效果

易混总结

@NotNull、@NotEmpty、@NotBlank 都是用于在数据校验中检查字段值是否为空的注解，但是它们的用法和校验规则有所不同。

• @NotNull (包装类型不为null)@NotNull 注解是 JSR 303 规范中定义的注解，当被标注的字段值为 null 时，会认为校验失败而抛出异常。该注解不能用于字符串类型的校验，若要对字符串进行校验，应该使用 @NotBlank 或 @NotEmpty 注解。
• @NotEmpty (集合类型长度大于0)@NotEmpty 注解同样是 JSR 303 规范中定义的注解，对于 CharSequence、Collection、Map 或者数组对象类型的属性进行校验，校验时会检查该属性是否为 Null 或者 size()==0，如果是的话就会校验失败。但是对于其他类型的属性，该注解无效。需要注意的是只校验空格前后的字符串，如果该字符串中间只有空格，不会被认为是空字符串，校验不会失败。
• @NotBlank （字符串，不为null，且不为" "字符串）@NotBlank 注解是 Hibernate Validator 附加的注解，对于字符串类型的属性进行校验，校验时会检查该属性是否为 Null 或 “” 或者只包含空格，如果是的话就会校验失败。需要注意的是，@NotBlank 注解只能用于字符串类型的校验。 总之，这三种注解都是用于校验字段值是否为空的注解，但是其校验规则和用法有所不同。在进行数据校验时，需要根据具体情况选择合适的注解进行校验。

SpringMVC自定义参数验证

定义注解

packagecom.gj.annotation;importjakarta.validation.Constraint;importjakarta.validation.Payload;importjava.lang.annotation.*;@Documented@Constraint(
    validatedBy ={GenderValidate.class})@Target({ElementType.METHOD,ElementType.FIELD,ElementType.ANNOTATION_TYPE,ElementType.CONSTRUCTOR,ElementType.PARAMETER,ElementType.TYPE_USE})@Retention(RetentionPolicy.RUNTIME)public@interfaceGender{Stringmessage()default"性别只能是男或女!";Class<?>[]groups()default{};Class<?extendsPayload>[]payload()default{};}

定义注解验证规则

packagecom.gj.annotation;importjakarta.validation.ConstraintValidator;importjakarta.validation.ConstraintValidatorContext;/**
 * @Author zhangchunsheng
 * @CreateTime: 2024/11/20
 */publicclassGenderValidateimplementsConstraintValidator<Gender,String>{@Overridepublicvoidinitialize(Gender constraintAnnotation){ConstraintValidator.super.initialize(constraintAnnotation);}@OverridepublicbooleanisValid(String value,ConstraintValidatorContext constraintValidatorContext){return value.equals("男")|| value.equals("女");}}

ValueObject(VO)

VO:ValueObject通常用于业务层和表示层之间的数据传输。VO对象通常包含用户界面所需的数据。

packagecom.gj.pojo;importcom.atguigu.annotation.Gender;importjakarta.validation.constraints.Email;importjakarta.validation.constraints.Max;importjakarta.validation.constraints.Min;importjakarta.validation.constraints.NotNull;importorg.hibernate.validator.constraints.Length;/**
 * @Author zhangchunsheng
 * @CreateTime: 2024/11/20
 */publicclassStudent{privateInteger stuId;privateString stuName;privateInteger stuAge;privateString stuEmail;privateString stuGender;@OverridepublicStringtoString(){return"Student{"+"stuId="+ stuId +", stuName='"+ stuName +'\''+", stuAge="+ stuAge +", stuEmail='"+ stuEmail +'\''+", stuGender='"+ stuGender +'\''+'}';}publicStringgetStuGender(){return stuGender;}publicvoidsetStuGender(String stuGender){this.stuGender = stuGender;}publicIntegergetStuId(){return stuId;}publicvoidsetStuId(Integer stuId){this.stuId = stuId;}publicStringgetStuName(){return stuName;}publicvoidsetStuName(String stuName){this.stuName = stuName;}publicIntegergetStuAge(){return stuAge;}publicvoidsetStuAge(Integer stuAge){this.stuAge = stuAge;}publicStringgetStuEmail(){return stuEmail;}publicvoidsetStuEmail(String stuEmail){this.stuEmail = stuEmail;}publicStudent(Integer stuId,String stuName,Integer stuAge,String stuEmail,String stuGender){this.stuId = stuId;this.stuName = stuName;this.stuAge = stuAge;this.stuEmail = stuEmail;this.stuGender = stuGender;}publicStudent(Integer stuId,String stuName,Integer stuAge,String stuEmail){this.stuId = stuId;this.stuName = stuName;this.stuAge = stuAge;this.stuEmail = stuEmail;}publicStudent(){}}

packagecom.gj.pojo.vo;importcom.atguigu.annotation.Gender;importjakarta.validation.constraints.Email;importjakarta.validation.constraints.Max;importjakarta.validation.constraints.Min;importjakarta.validation.constraints.NotNull;importorg.hibernate.validator.constraints.Length;/**
 * @Author zhangchunsheng
 * @CreateTime: 2024/11/20
 */publicclassStudentVO{@NotNull(message ="id不能为空!!!")privateInteger stuId;@Length(min =3, max =6, message ="长度在3-6之间!!!")privateString stuName;@Min(value =18, message ="年龄最小18岁!!!")@Max(value =120,message ="年龄最大120岁!!!")privateInteger stuAge;@Email(message ="邮箱格式不正确!!!")privateString stuEmail;@Gender(message ="请求输入正确的性别!")privateString stuGender;//....@OverridepublicStringtoString(){return"Student{"+"stuId="+ stuId +", stuName='"+ stuName +'\''+", stuAge="+ stuAge +", stuEmail='"+ stuEmail +'\''+", stuGender='"+ stuGender +'\''+'}';}publicStringgetStuGender(){return stuGender;}publicvoidsetStuGender(String stuGender){this.stuGender = stuGender;}publicIntegergetStuId(){return stuId;}publicvoidsetStuId(Integer stuId){this.stuId = stuId;}publicStringgetStuName(){return stuName;}publicvoidsetStuName(String stuName){this.stuName = stuName;}publicIntegergetStuAge(){return stuAge;}publicvoidsetStuAge(Integer stuAge){this.stuAge = stuAge;}publicStringgetStuEmail(){return stuEmail;}publicvoidsetStuEmail(String stuEmail){this.stuEmail = stuEmail;}publicStudentVO(Integer stuId,String stuName,Integer stuAge,String stuEmail,String stuGender){this.stuId = stuId;this.stuName = stuName;this.stuAge = stuAge;this.stuEmail = stuEmail;this.stuGender = stuGender;}publicStudentVO(Integer stuId,String stuName,Integer stuAge,String stuEmail){this.stuId = stuId;this.stuName = stuName;this.stuAge = stuAge;this.stuEmail = stuEmail;}publicStudentVO(){}}

文件上传和下载

文件上传

文件上传表单页面

位置：index.html

• 第一点：请求方式必须是 POST
• 第二点：请求体的编码方式必须是 multipart/form-data（通过 form 标签的 enctype 属性设置）
• 第三点：使用 input 标签、type 属性设置为 file 来生成文件上传框

<!DOCTYPEhtml><htmllang="en"><head><metacharset="UTF-8"><title>Title</title></head><body><formaction="/save/picture"method="post"enctype="multipart/form-data">
      昵称：<inputtype="text"name="nickName"value="龙猫"/><br/>
      头像：<inputtype="file"name="headPicture"/><br/>
      背景：<inputtype="file"name="backgroundPicture"/><br/><buttontype="submit">保存</button></form></body></html>

springmvc环境要求

pom.xml添加依赖

<!-- https://mvnrepository.com/artifact/commons-fileupload/commons-fileupload --><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.1</version></dependency>

配置文件上传处理器(springmvc配置)

<!-- 文件上传处理器,可处理 multipart/* 请求并将其转换为 MultipartFile 对象--><beanid="multipartResolver"class="org.springframework.web.multipart.support.StandardServletMultipartResolver"></bean>

CommonsMultipartResolver的bean的id，必须是：multipartResolver
如果不是这个值，会在上传文件时报错
在

web.xml

文件中添加 Multipart 配置

<servlet><servlet-name>yourAppServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><multipart-config><!-- 定义文件上传时所需的最大值，单位为字节 --><max-file-size>10485760</max-file-size><!-- 定义单个上传文件的最大值，单位为字节 --><max-request-size>20971520</max-request-size><!-- 定义内存中存储文件的最大值，超过此大小的文件会写入到硬盘中 --><file-size-threshold>5242880</file-size-threshold></multipart-config><load-on-startup>1</load-on-startup></servlet>

低版本web.xml约束文件，会爆红，不管担心，继续启动即可！

历史：Spring MVC 6之前，通常使用的是

CommonsMultipartResolver

来解析文件上传请求。但是在 Spring MVC 6中，此类已被移除，Spring 官方推荐使用

StandardServletMultipartResolver

或

MockMultipartResolver

来替代。

handler方法接收数据

/**
 * 上传的文件使用 MultipartFile 类型接收其相关数据
 * @param nickName
 * @param picture
 * @param backgroundPicture
 * @return
 * @throws IOException
 */@PostMapping("picture")publicStringupload(String nickName,@RequestParam("headPicture")MultipartFile picture,@RequestParam("backgroundPicture")MultipartFile backgroundPicture)throwsIOException{System.out.println(nickName);String inputName = picture.getName();System.out.println("文件上传表单项的 name 属性值："+ inputName);// 获取这个数据通常都是为了获取文件本身的扩展名String originalFilename = picture.getOriginalFilename();System.out.println("文件在用户本地原始的文件名："+ originalFilename);String contentType = picture.getContentType();System.out.println("文件的内容类型："+ contentType);boolean empty = picture.isEmpty();System.out.println("文件是否为空："+ empty);long size = picture.getSize();System.out.println("文件大小："+ size);byte[] bytes = picture.getBytes();System.out.println("文件二进制数据的字节数组："+Arrays.asList(bytes));InputStream inputStream = picture.getInputStream();System.out.println("读取文件数据的输入流对象："+ inputStream);Resource resource = picture.getResource();System.out.println("代表当前 MultiPartFile 对象的资源对象"+ resource);return"home";}

MultipartFile接口

文件转存

底层机制

本地转存

转存代码演示：

……
 
// 1、准备好保存文件的目标目录// ①File 对象要求目标路径是一个物理路径（在硬盘空间里能够直接找到文件的路径）// ②项目在不同系统平台上运行，要求能够自动兼容、适配不同系统平台的路径格式//      例如：Window系统平台的路径是 D:/aaa/bbb 格式//      例如：Linux系统平台的路径是 /ttt/uuu/vvv 格式//      所以我们需要根据『不会变的虚拟路径』作为基准动态获取『跨平台的物理路径』// ③虚拟路径：浏览器通过 Tomcat 服务器访问 Web 应用中的资源时使用的路径String destFileFolderVirtualPath ="/head-picture";// ④调用 ServletContext 对象的方法将虚拟路径转换为真实物理路径String destFileFolderRealPath = servletContext.getRealPath(destFileFolderVirtualPath);// 2、生成保存文件的文件名// ①为了避免同名的文件覆盖已有文件，不使用 originalFilename，所以需要我们生成文件名// ②我们生成文件名包含两部分：文件名本身和扩展名// ③声明变量生成文件名本身String generatedFileName = UUID.randomUUID().toString().replace("-","");// ④根据 originalFilename 获取文件的扩展名String fileExtname = originalFilename.substring(originalFilename.lastIndexOf("."));// ⑤拼装起来就是我们生成的整体文件名String destFileName = generatedFileName +""+ fileExtname;// 3、拼接保存文件的路径，由两部分组成//      第一部分：文件所在目录//      第二部分：文件名String destFilePath = destFileFolderRealPath +"/"+ destFileName;// 4、创建 File 对象，对应文件具体保存的位置File destFile =newFile(destFilePath);// 5、执行转存
picture.transferTo(destFile);
 
……

缺陷

• Web 应用重新部署时通常都会清理旧的构建结果，此时用户以前上传的文件会被删除，导致数据丢失。
• 项目运行很长时间后，会导致上传的文件积累非常多，体积非常大，从而拖慢 Tomcat 运行速度。
• 当服务器以集群模式运行时，文件上传到集群中的某一个实例，其他实例中没有这个文件，就会造成数据不一致。
• 不支持动态扩容，一旦系统增加了新的硬盘或新的服务器实例，那么上传、下载时使用的路径都需要跟着变化，导致 Java 代码需要重新编写、重新编译，进而导致整个项目重新部署。

文件服务器转存（推荐）

好处

• 不受 Web 应用重新部署影响
• 在应用服务器集群环境下不会导致数据不一致
• 针对文件读写进行专门的优化，性能有保障
• 能够实现动态扩容

文件服务器类型

• 第三方平台： - 阿里的 OSS 对象存储服务- 七牛云
• 自己搭建服务器：FastDFS 等

上传到其他模块

这种情况肯定出现在分布式架构中，常规业务功能不会这么做，采用这个方案的一定是特殊情况，这种情况极其少见。

在 MultipartFile 接口中有一个对应的方法：

/**
 * Return a Resource representation of this MultipartFile. This can be used
 * as input to the {@code RestTemplate} or the {@code WebClient} to expose
 * content length and the filename along with the InputStream.
 * @return this MultipartFile adapted to the Resource contract
 * @since 5.1
 */defaultResourcegetResource(){returnnewMultipartFileResource(this);}

注释中说：这个 Resource 对象代表当前 MultipartFile 对象，输入给 RestTemplate 或 WebClient。而 RestTemplate 或 WebClient 就是用来在 Java 程序中向服务器端发出请求的组件。

文件下载

在 Spring MVC 中，

ResponseEntity

是用于表示 HTTP 响应的一个类，它既能设置响应体的内容，也能设置响应头相关的信息。

ResponseEntity

可以封装一个 HTTP 响应，包括响应体、响应头和响应状态码等属性，并将其发送回客户端。它提供了一种灵活的方式来表示 HTTP 响应，可以用于处理 RESTful API、文件下载、异常处理等应用场景。

演示json数据返回：

@GetMapping("/users/{age}")publicResponseEntity<User>getUser(@PathVariable("age")int age){User user =newUser();
    user.setAge(age);
    user.setEmail("test");
    user.setName("二狗子");returnResponseEntity.ok(user);}

演示文件下载代码：

@AutowiredprivateServletContext servletContext;@RequestMapping("/download/file")publicResponseEntity<byte[]>downloadFile(){// 1.获取要下载的文件的输入流对象// 这里指定的路径以 Web 应用根目录为基准InputStream inputStream = servletContext.getResourceAsStream("/images/mi.jpg");try{// 2.将要下载的文件读取到字节数组中// ①获取目标文件的长度int len = inputStream.available();// ②根据目标文件长度创建字节数组byte[] buffer =newbyte[len];// ③将目标文件读取到字节数组中
        inputStream.read(buffer);// 3.封装响应消息头// ①创建MultiValueMap接口类型的对象，实现类是HttpHeadersMultiValueMap responseHeaderMap =newHttpHeaders();// ②存入下载文件所需要的响应消息头
        responseHeaderMap.add("Content-Disposition","attachment; filename=mi.jpg");// ③创建ResponseEntity对象ResponseEntity<byte[]> responseEntity =newResponseEntity<>(buffer, responseHeaderMap,HttpStatus.OK);// 4.返回responseEntity对象return responseEntity;}catch(IOException e){
        e.printStackTrace();}finally{if(inputStream !=null){try{
                inputStream.close();}catch(IOException e){
                e.printStackTrace();}}}returnnull;}