学习SpringMVC必知必会（7）~springmvc的数据校验、表单标签、文件上传和下载

• 输入校验是 Web 开发任务之一，在 SpringMVC 中有两种方式可以实现，分别是使用 Spring 自带的验证 框架和使用 JSR 303 实现，

  也称之为 spring-validator 和 JSR303-validator。 在开发中更建议使用 <font color=blue>JSR303-validato</font>.

1、JSR303约束

• Spring 在进行数据绑定时，可同时调用校验框架完成数据校验工作。

图片.png

• Spring 本身并没有提供 JSR303 的实现，所以必须将 JSR303 的实现者的 jar 包放到类路径下。
• JSR303 仅仅是校验的标准，我们这里使用的是 Hibernate Validator 框架实现方案。

2、JSR303约束规则

图片.png

3、校验规则开发：

（1）拷贝jar包：

• hibernate-validator-6.0.7.Final.jar

• classmate-1.3.1.jar

• jboss-logging-3.3.0.Final.jar

• validation-api-2.0.1.Final.jar

（2）使用注解

• 常用注解：@NotNull、@Size、@Min、@Max

@Data
public class Employee {
    private Long id;
    @NotNull(message = "用户名不能为空")
    @Size(max=10, min=4, message="用户名在4-10位之间")
    private String username;
    @NotNull(message = "密码不能为空")
    @Size(max=10, min=4, message="密码在4-10位之间")
    private String password;
    
    @NotNull(message = "年龄不能为空")
    @Min(value=18, message="年龄最小值为18")
    @Max(value=40, message="年龄最大值为40" )
    private Integer age;
    @DateTimeFormat(pattern = "yyyy-MM-dd")
    private Date hiredate;  
}

• 细节：<font color=blue>那个使用了校验的注解的参数对象必须紧跟着参数BindingResult</font>

    @RequestMapping("/saveOrUpdate")
    public String saveOrUpdate(@Valid Employee e, BindingResult bindingResult, Model model) {
        System.out.println("save~~~");
        List<ObjectError> errors = bindingResult.getAllErrors();
        if (errors.size() > 0) {
            model.addAttribute("errors", errors);
            return "employee/input";
        }
        if(e.getId() == null) {
            employeeService.save(e);
        }else {
            employeeService.update(e);
        }
        return "redirect:/employee/list";
    }

4、国际化操作

■ <font color=blue>一般很少很少用到</font>，使用的是ValidationMessages.properties文件，通过key=value形式，将校验注解的属性的属性值定义成变量，赋值给key，value就是原先的内容。

• 举例 @NotNull(message = "年龄不能为空") 修改为：@NotNull(message = {employee.username})

   private String username;               private String username;
  

• 在ValidationMessages.properties文件中： employee.username="年龄不能为空"

二、表单标签(作用：方便回显数据)

■ 通过 SpringMVC 的表单标签可以实现将模型数据中的属性和 HTML 表单元素相绑定，以实现表单数据 更便捷编辑和表单值的回显功能。

<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%>

• 表单标签库中的标签:

图片.png

• form 表单的属性：

图片.png

--------------------------- modelAttribute 已经取代 commandName 属性。

• input 的属性：

图片.png

• password 的属性：

图片.png

• hidden 的属性：

图片.png

• textarea 的属性：

图片.png

• checkbox 的属性：

图片.png

• checkboxes 的属性：

图片.png

• radiobutton 的属性：

图片.png

• radiobuttons 的属性：

图片.png

• select 的属性：

图片.png

• option 和 options 的属性：

图片.png

• errors 的属性：

图片.png

■ 解决常规回显的麻烦：<font color=blue>使用springmvc的表单标签</font>（会直接回显对象的属性值的~，path的值就是需要回显的属性）

<%@ taglib uri="http://www.springframework.org/tags/form" prefix="form"%>
 
 
    <form:form action="/employee/saveOrUpdate" modelAttribute="employee">
        <!-- 错误信息(所有是*，具体的话，直接写属性) -->
        <form:errors path="*"/><br/>
        <form:hidden path="id"/><br/>
        账号：<form:input path="username"/><form:errors path="username" cssStyle="color:red;"/><br/>
        密码：<form:password path="password" showPassword="true"/><form:errors path="password" cssStyle="color:red;"/><br/>
        年龄：<form:input path="age"/><form:errors path="age" cssStyle="color:red;"/><br/>
        入职：<form:input path="hiredate"/><br/>
        <input type="submit" value="保存"/><br/>
    </form:form>

• 问题：新增的时候找不到employee报错：

  java.lang.IllegalStateException: Neither BindingResult nor plain target object for bean name 'employ.

• 解决：<font color=blue>在处理新增的时候，也放进去一个对象，只是放的对象是空的对象，方便到视图的时候接收到对象</font>

图片.png

三、文件上传和下载

1、文件上传

• 上传文件的要求：表单form 请求方式必须是post方式，编码方式必须是二进制，即enctype="multipart/form-data"，

  上传的文件的控件类型必须是file.

<form action="/upload" method="POST" enctype="multipart/form-data">
    文件上传: <input type="file" name="pic">
</form>

■ SpringMVC 上传文件有两种方式：

1、基于Apache 的上传组件：

2、基于Servlet3.0

（1）基于 Apache FileUpload 组件：

• 自学—参考文档的User guide [找到最简单的例子然后跑起来]

1）拷贝jar包：commons-fileupload.jar commons-io.jar

• com.springsource.org.apache.commons.fileupload-1.2.0.jar
• com.springsource.org.apache.commons.io-1.4.0.jar

2）配置文件上传解析器：

<!-- 文件上传的解析器（Apache FileUpload 组件） -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
    <!-- 限制文件大小(1MB) -->
    <property name="maxUploadSize" value="1048576"/>
</bean>

3）FileUploadController类：

@Controller
public class FileUploadController {
    @Autowired
    private ServletContext servletContext;

    @RequestMapping("/save")
    public ModelAndView save(Employee e, MultipartFile pic) throws Exception {
        System.out.println(e);
        String fileName = pic.getOriginalFilename();
        System.out.println(fileName);
        //下载目录--通过servletContext获取
        String saveDir = servletContext.getRealPath("/upload");
        Files.copy(pic.getInputStream(), Paths.get(saveDir, fileName));
        return null;
    }
}

（2）基于Servlet3.0

• 不用烤jar包

SpringBoot里边是默认支持的，不依赖Apache，围绕MultipartConfig注解，Part接口

1）配置：在mvc.xml 中进行配置

<!-- 文件上传的解析器（基于Servlet3.0） -->
<bean class="org.springframework.web.multipart.support.StandardServletMultipartResolver"/>

• 在找不属性，它的父类[是接口]也找不到属性，而Servlet3.0 是交给javaWeb的web.xml 进行配置

■ 在前端配置器下面进行配置文件上传：

    <!-- 前端控制器 -->
    <servlet>
        <servlet-name>springDispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:mvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
        <!-- 文件上传的配置
            location 和 file-size-threshold 是超过多少就放到磁盘中去
         -->
        <multipart-config>
            <location>E:/temp</location>
            <max-file-size>100000000</max-file-size>
            <max-request-size>100000000</max-request-size>
            <file-size-threshold>1024</file-size-threshold>
        </multipart-config>
    </servlet>

2、文件下载

• 原来的操作request方式
• Springmvc也做了封装

如果本文对你有帮助的话记得给一乐点个赞哦，感谢！