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

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

  也称之为 spring-validator 和 JSR303-validator。 在开发中更建议使用 JSR303-validato.

1、JSR303约束

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

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

2、JSR303约束规则

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;	
}

• 细节：那个使用了校验的注解的参数对象必须紧跟着参数BindingResult

	@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、国际化操作

■ 一般很少很少用到，使用的是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"%>

• 表单标签库中的标签:

• form 表单的属性：

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

• input 的属性：

• password 的属性：

• hidden 的属性：

• textarea 的属性：

• checkbox 的属性：

• checkboxes 的属性：

• radiobutton 的属性：

• radiobuttons 的属性：

• select 的属性：

• option 和 options 的属性：

• errors 的属性：

■ 解决常规回显的麻烦：使用springmvc的表单标签（会直接回显对象的属性值的~，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.

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

三、文件上传和下载

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也做了封装

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