springMVC(中篇)

科技2022-08-30 121

上一篇所需框架

RESTful SpringMVC CRUD

目标一：

代码：

///springmvc/WebRoot/WEB-INF/web.xml全局配置文件 <?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">   <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:springmvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet>  <servlet-mapping> <servlet-name>springDispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>  <filter> <filter-name>HiddenHttpMethodFilter</filter-name> <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class> </filter> <filter-mapping> <filter-name>HiddenHttpMethodFilter</filter-name> <url-pattern>/ *</url-pattern>//注意这里应该是/* </filter-mapping> </web-app> ///springmvc/src/springmvc.xml配置文件 <?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context" xmlns:mvc="http://www.springframework.org/schema/mvc" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">  <context:component-scan base-package="springmvc"></context:component-scan>  <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"></property> <property name="suffix" value=".jsp"></property> </bean> </beans> /// ///springmvc/src/springmvc/crud/entities/Department.java javabean package springmvc.crud.entities; public class Department { private Integer id; private String departmentName; public Department() { // TODO Auto-generated constructor stub } public Department(int i, String string) { this.id = i; this.departmentName = string; } public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getDepartmentName() { return departmentName; } public void setDepartmentName(String departmentName) { this.departmentName = departmentName; } @Override public String toString() { return "Department [id=" + id + ", departmentName=" + departmentName + "]"; } } /// ///springmvc/src/springmvc/crud/entities/Employee.java package springmvc.crud.entities; import java.util.Date; import javax.validation.constraints.Past; import org.hibernate.validator.constraints.Email; import org.hibernate.validator.constraints.NotEmpty; import org.springframework.format.annotation.DateTimeFormat; import org.springframework.format.annotation.NumberFormat; public class Employee { private Integer id; @NotEmpty private String lastName; @Email private String email; //1 male, 0 female private Integer gender; private Department department; @Past @DateTimeFormat(pattern="yyyy-MM-dd") private Date birth; @NumberFormat(pattern="#,###,###.#") private Float salary; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } public Integer getGender() { return gender; } public void setGender(Integer gender) { this.gender = gender; } public Department getDepartment() { return department; } public void setDepartment(Department department) { this.department = department; } public Date getBirth() { return birth; } public void setBirth(Date birth) { this.birth = birth; } public Float getSalary() { return salary; } public void setSalary(Float salary) { this.salary = salary; } @Override public String toString() { return "Employee [id=" + id + ", lastName=" + lastName + ", email=" + email + ", gender=" + gender + ", department=" + department + ", birth=" + birth + ", salary=" + salary + "]"; } public Employee(Integer id, String lastName, String email, Integer gender, Department department) { super(); this.id = id; this.lastName = lastName; this.email = email; this.gender = gender; this.department = department; } public Employee() { // TODO Auto-generated constructor stub } } / ///springmvc/src/springmvc/crud/dao/DepartmentDao.java package springmvc.crud.dao; import java.util.Collection; import java.util.HashMap; import java.util.Map; import org.springframework.stereotype.Repository; import springmvc.crud.entities.Department; @Repository public class DepartmentDao { private static Map<Integer, Department> departments = null; static{ departments = new HashMap<Integer, Department>(); departments.put(101, new Department(101, "D-AA")); departments.put(102, new Department(102, "D-BB")); departments.put(103, new Department(103, "D-CC")); departments.put(104, new Department(104, "D-DD")); departments.put(105, new Department(105, "D-EE")); } public Collection<Department> getDepartments(){ return departments.values(); } public Department getDepartment(Integer id){ return departments.get(id); } } /// ///springmvc/src/springmvc/crud/dao/EmployeeDao.java package springmvc.crud.dao; import java.util.Collection; import java.util.HashMap; import java.util.Map; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Repository; import springmvc.crud.entities.Department; import springmvc.crud.entities.Employee; @Repository public class EmployeeDao { private static Map<Integer, Employee> employees = null; @Autowired private DepartmentDao departmentDao; static{ employees = new HashMap<Integer, Employee>(); employees.put(1001, new Employee(1001, "E-AA", "aa@163.com", 1, new Department(101, "D-AA"))); employees.put(1002, new Employee(1002, "E-BB", "bb@163.com", 1, new Department(102, "D-BB"))); employees.put(1003, new Employee(1003, "E-CC", "cc@163.com", 0, new Department(103, "D-CC"))); employees.put(1004, new Employee(1004, "E-DD", "dd@163.com", 0, new Department(104, "D-DD"))); employees.put(1005, new Employee(1005, "E-EE", "ee@163.com", 1, new Department(105, "D-EE"))); } private static Integer initId = 1006; public void save(Employee employee){ if(employee.getId() == null){ employee.setId(initId++); } employee.setDepartment(departmentDao.getDepartment(employee.getDepartment().getId())); employees.put(employee.getId(), employee); } public Collection<Employee> getAll(){ return employees.values(); } public Employee get(Integer id){ return employees.get(id); } public void delete(Integer id){ employees.remove(id); } } ///springmvc/src/springmvc/crud/handlers/EmployeeHandler.java package springmvc.crud.handlers; import java.util.Map; import javax.validation.Valid; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.validation.Errors; import org.springframework.validation.FieldError; import org.springframework.web.bind.annotation.ModelAttribute; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestParam; import springmvc.crud.dao.DepartmentDao; import springmvc.crud.dao.EmployeeDao; import springmvc.crud.entities.Employee; @Controller public class EmployeeHandler { @Autowired private EmployeeDao employeeDao; @Autowired private DepartmentDao departmentDao; @RequestMapping("/emps") public String list(Map<String, Object> map){ map.put("employees", employeeDao.getAll()); return "list"; } } springmvc/WebRoot/index.jsp <a href="emps">List All Employees</a> <br><br> springmvc/WebRoot/WEB-INF/views/list.jsp <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <c:if test="${empty requestScope.employees }"> 没有任何员工信息. </c:if> <c:if test="${!empty requestScope.employees }"> <table border="1" cellpadding="10" cellspacing="0"> <tr> <th>ID</th> <th>LastName</th> <th>Email</th> <th>Gender</th> <th>Department</th> <th>Edit</th> <th>Delete</th> </tr> <c:forEach items="${requestScope.employees }" var="emp"> <tr> <td>${emp.id }</td> <td>${emp.lastName }</td> <td>${emp.email }</td> <td>${emp.gender == 0 ? 'Female' : 'Male' }</td> <td>${emp.department.departmentName }</td> <td><a href="">Edit</a></td> <td><a href="">Delete</a></td> </tr> </c:forEach> </table> </c:if> </body> </html>

目标二：

代码：（在前面的基础上）

springmvc/WebRoot/WEB-INF/views/list.jsp添加 <a href="emp">Add New Employee</a> ///springmvc/src/springmvc/crud/handlers/EmployeeHandler.java添加 @RequestMapping(value="/emp", method=RequestMethod.POST) public String save( Employee employee){ employeeDao.save(employee); return "redirect:/emps"; } @RequestMapping(value="/emp", method=RequestMethod.GET) public String input(Map<String, Object> map){ map.put("departments", departmentDao.getDepartments()); map.put("employee", new Employee()); return "input"; } ///springmvc/WebRoot/WEB-INF/views/input.jsp <%@page import="java.util.HashMap"%> <%@page import="java.util.Map"%> <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="form" uri="http://www.springframework.org/tags/form" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body>  <br><br> <form:form action="emp" method="POST" modelAttribute="employee"> LastName: <form:input path="lastName"/> <br> Email: <form:input path="email"/> <br> <% Map<String, String> genders = new HashMap(); genders.put("1", "Male"); genders.put("0", "Female"); request.setAttribute("genders", genders); %> Gender: <form:radiobuttons path="gender" items="${genders }" delimiter="<br>"/> <br> Department: <form:select path="department.id" items="${departments }" itemLabel="departmentName" itemValue="id"></form:select> <br> <br> <input type="submit" value="Submit"/> </form:form> </body> </html>

目标三：

删除代码：（在前面的基础上）

springmvc/WebRoot/WEB-INF/views/list.jsp添加 //<head>添加 <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title>  <script type="text/javascript" src="https://cdn.staticfile.org/jquery/1.10.2/jquery.min.js"></script> <script type="text/javascript"> $(function(){ $(".delete").click(function(){ var href = $(this).attr("href"); $("form").attr("action", href).submit(); return false; }); }) </script> </head> /<body>添加 <form action="" method="POST"> <input type="hidden" name="_method" value="DELETE"/> </form> /更新 <td><a class="delete" href="emp/${emp.id}">Delete</a></td> ///springmvc/src/springmvc.xml增加  <mvc:default-servlet-handler/> <mvc:annotation-driven ></mvc:annotation-driven> ///springmvc/src/springmvc/crud/handlers/EmployeeHandler.java增加 @RequestMapping(value="/emp/{id}", method=RequestMethod.DELETE) public String delete(@PathVariable("id") Integer id){ employeeDao.delete(id); return "redirect:/emps"; }

修改：代码：（在前面的基础上）

springmvc/WebRoot/WEB-INF/views/list.jsp更新 <td><a href="emp/${emp.id}">Edit</a></td> ///springmvc/src/springmvc/crud/handlers/EmployeeHandler.java增加 @ModelAttribute public void getEmployee(@RequestParam(value="id",required=false) Integer id, Map<String, Object> map){ if(id != null){ map.put("employee", employeeDao.get(id)); } } @RequestMapping(value="/emp", method=RequestMethod.PUT) public String update(Employee employee){ employeeDao.save(employee); return "redirect:/emps"; } @RequestMapping(value="/emp/{id}", method=RequestMethod.GET) public String input(@PathVariable("id") Integer id, Map<String, Object> map){ map.put("employee", employeeDao.get(id)); map.put("departments", departmentDao.getDepartments()); return "input"; } ///springmvc/WebRoot/WEB-INF/views/input.jsp更新 <form:form action="${pageContext.request.contextPath }/emp" method="POST" modelAttribute="employee"><c:if test="${employee.id == null }">  LastName: <form:input path="lastName"/> </c:if> <c:if test="${employee.id != null }"> <form:hidden path="id"/> <input type="hidden" name="_method" value="PUT"/> <%-- 对于 _method 不能使用 form:hidden 标签, 因为 modelAttribute 对应的 bean 中没有 _method 这个属性 --%> <%-- <form:hidden path="_method" value="PUT"/> --%> </c:if> <br> Email: <form:input path="email"/> <br> <% Map<String, String> genders = new HashMap(); genders.put("1", "Male"); genders.put("0", "Female"); request.setAttribute("genders", genders); %> Gender: <form:radiobuttons path="gender" items="${genders }" delimiter="<br>"/> <br> Department: <form:select path="department.id" items="${departments }" itemLabel="departmentName" itemValue="id"></form:select> <br> <br> <input type="submit" value="Submit"/> </form:form>

Spring 的表单标签

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

form 标签

• 一般情况下，通过 GET 请求获取表单页面，而通过POST 请求提交表单页面，因此获取表单页面和提交表单页面的 URL 是相同的。只要满足该最佳条件的契约，< form:form> 标签就无需通过 action 属性指定表单提交的 URL • 可以通过 modelAttribute 属性指定绑定的模型属性，若没有指定该属性，则默认从 request 域对象中读取command 的表单 bean，如果该属性值也不存在，则会发生错误。

表单标签

• SpringMVC 提供了多个表单组件标签，如 < form:input/>、< form:select/> 等，用以绑定表单字段的属性值，它们的共有属性如下： – path：表单字段，对应 html 元素的 name 属性，支持级联属性 – htmlEscape：是否对表单值的 HTML 特殊字符进行转换，默认值为 true – cssClass：表单组件对应的 CSS 样式类名cssErrorClass：表单组件的数据存在错误时，采取的 CSS 样式 • form:input、form:password、form:hidden、form:textarea ：对应 HTML 表单的 text、password、hidden、textarea 标签 • form:radiobutton：单选框组件标签，当表单 bean 对应的属性值和 value 值相等时，单选框被选中 • form:radiobuttons：单选框组标签，用于构造多个单选框– items：可以是一个 List、String[] 或 Map – itemValue：指定 radio 的 value 值。可以是集合中 bean 的一个属性值 – itemLabel：指定 radio 的 label 值 – delimiter：多个单选框可以通过 delimiter 指定分隔符 • form:checkbox：复选框组件。用于构造单个复选框 • form:checkboxs：用于构造多个复选框。使用方式同 form:radiobuttons 标签 • form:select：用于构造下拉框组件。使用方式同 form:radiobuttons 标签 • form:option：下拉框选项组件标签。使用方式同 form:radiobuttons 标签 • form:errors：显示表单组件或数据校验所对应的错误 – <form:errors path= “ ” /> ：显示表单所有的错误 – <form:errors path= “ user” /> ：显示所有以 user 为前缀的属性对应的错误 – <form:errors path= “ username” /> ：显示特定表单对象属性的错误

数据绑定流程

• 1. Spring MVC 主框架将 ServletRequest 对象及目标方法的入参实例传递给 WebDataBinderFactory 实例，以创建 DataBinder 实例对象 • 2. DataBinder 调用装配在 Spring MVC 上下文中的ConversionService 组件进行数据类型转换、数据格式化工作。将 Servlet 中的请求信息填充到入参对象中 • 3. 调用 Validator 组件对已经绑定了请求消息的入参对象进行数据合法性校验，并最终生成数据绑定结果BindingData 对象 • 4. Spring MVC 抽取 BindingResult 中的入参对象和校验错误对象，将它们赋给处理方法的响应入参

数据转换

自定义类型转换器

• ConversionService 是 Spring 类型转换体系的核心接口。 • 可以利用 ConversionServiceFactoryBean 在 Spring 的 IOC 容器中定义一个 ConversionService. Spring 将自动识别出 IOC 容器中的 ConversionService，并在 Bean 属性配置及 Spring MVC 处理方法入参绑定等场合使用它进行数据的转换 • 可通过 ConversionServiceFactoryBean 的 converters 属性注册自定义的类型转换器

Spring 支持的转换器

• Spring 定义了 3 种类型的转换器接口，实现任意一个转换器接口都可以作为自定义转换器注册到ConversionServiceFactroyBean 中： – Converter<S,T>：将 S 类型对象转为 T 类型对象 –ConverterFactory：将相同系列多个 “同质” Converter 封装在一起。如果希望将一种类型的对象转换为另一种类型及其子类的对象（例如将 String 转换为 Number 及 Number 子类（Integer、Long、Double 等）对象）可使用该转换器工厂类 – GenericConverter：会根据源类对象及目标类对象所在的宿主类中的上下文信息进行类型转换自定义转换器示例 • <mvc:annotation-driven conversion-service= “conversionService”/> 会将自定义的 ConversionService 注册到Spring MVC 的上下文中代码（在前面的基础上）：

springmvc/WebRoot/WEB-INF/views/input.jsp增加 <form action="testConversionServiceConverer" method="POST">  Employee: <input type="text" name="employee"/> <input type="submit" value="Submit"/> </form> <br><br> ///springmvc/src/springmvc/test/SpringMVCTest.java import java.io.IOException; import java.io.InputStream; import java.util.Collection; import java.util.Date; import java.util.Locale; import java.util.Map; import javax.servlet.ServletContext; import javax.servlet.http.HttpSession; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.support.ResourceBundleMessageSource; import org.springframework.http.HttpHeaders; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestMethod; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.ResponseStatus; import org.springframework.web.multipart.MultipartFile; import org.springframework.web.servlet.ModelAndView; import springmvc.crud.dao.EmployeeDao; import springmvc.crud.entities.Employee; @Controller public class SpringMVCTest { @Autowired private EmployeeDao employeeDao; @RequestMapping("/testConversionServiceConverer") public String testConverter(@RequestParam("employee") Employee employee){ System.out.println("save: " + employee); employeeDao.save(employee); return "redirect:/emps"; } } ///springmvc/src/springmvc/test/EmployeeConverter.java package springmvc.test; import org.springframework.core.convert.converter.Converter; import org.springframework.stereotype.Component; import springmvc.crud.entities.Department; import springmvc.crud.entities.Employee; @Component public class EmployeeConverter implements Converter<String, Employee> { @Override public Employee convert(String source) { if(source != null){ String [] vals = source.split("-"); //GG-gg@atguigu.com-0-105 if(vals != null && vals.length == 4){ String lastName = vals[0]; String email = vals[1]; Integer gender = Integer.parseInt(vals[2]); Department department = new Department(); department.setId(Integer.parseInt(vals[3])); Employee employee = new Employee(null, lastName, email, gender, department); System.out.println(source + "--convert--" + employee); return employee; } } return null; } } //springmvc/src/springmvc.xml配置文件更新 <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven> //添加  <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean"> <property name="converters"> <set> <ref bean="employeeConverter"/> </set> </property> </bean>

mvc:annotation-driven

• <mvc:annotation-driven /> 会自动注册RequestMappingHandlerMapping 、RequestMappingHandlerAdapter 与 ExceptionHandlerExceptionResolver 三个bean。 • 还将提供以下支持： – 支持使用 ConversionService 实例对表单参数进行类型转换 – 支持使用 @NumberFormat annotation、@DateTimeFormat 注解完成数据类型的格式化 – 支持使用 @Valid 注解对 JavaBean 实例进行 JSR 303 验证 – 支持使用 @RequestBody 和 @ResponseBody 注解

@InitBinder

• 由 @InitBinder 标识的方法，可以对 WebDataBinder 对象进行初始化。WebDataBinder 是 DataBinder 的子类，用于完成由表单字段到 JavaBean 属性的绑定 • @InitBinder方法不能有返回值，它必须声明为void。 • @InitBinder方法的参数通常是是 WebDataBinder 例子在其前面的基础上

//springmvc/src/springmvc/test/SpringMVCTestExceptionHandler.java不给lastname字段赋值 // @InitBinder // public void initBinder(WebDataBinder binder){ // binder.setDisallowedFields("lastName"); // }.setDisallowedFields("lastName"); }

数据格式化

• 对属性对象的输入/输出进行格式化，从其本质上讲依然属于 “类型转换” 的范畴。 • Spring 在格式化模块中定义了一个实现ConversionService 接口的FormattingConversionService 实现类，该实现类扩展了 GenericConversionService，因此它既具有类型转换的功能，又具有格式化的功能 • FormattingConversionService 拥有一个FormattingConversionServiceFactroyBean 工厂类，后者用于在 Spring 上下文中构造前者

• FormattingConversionServiceFactroyBean 内部已经注册了 : – NumberFormatAnnotationFormatterFactroy：支持对数字类型的属性使用 @NumberFormat 注解 –JodaDateTimeFormatAnnotationFormatterFactroy：支持对日期类型的属性使 @DateTimeFormat 注解 • 装配 FormattingConversionServiceFactroyBean 后，就可以在 Spring MVC 入参绑定及模型数据输出时使用注解驱动了。< mvc:annotation-driven/> 默认创建的ConversionService 实例即为FormattingConversionServiceFactroyBean

日期格式化

• @DateTimeFormat 注解可对java.util.Date、java.util.Calendar、java.long.Long 时间类型进行标注： – pattern 属性：类型为字符串。指定解析/格式化字段数据的模式，如：”yyyy-MM-dd hh:mm:ss” – iso 属性：类型为 DateTimeFormat.ISO。指定解析/格式化字段数据的ISO模式，包括四种：ISO.NONE（不使用） – 默认、ISO.DATE(yyyy-MM-dd) 、ISO.TIME(hh:mm:ss.SSSZ)、 ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ) – style 属性：字符串类型。通过样式指定日期时间的格式，由两位字符组成，第一位表示日期的格式，第二位表示时间的格式：S：短日期/时间格式、M：中日期/时间格式、L：长日期/时间格式、F：完整日期/时间格式、-：忽略日期或时间格式

数值格式化

• @NumberFormat 可对类似数字类型的属性进行标注，它拥有两个互斥的属性： – style：类型为 NumberFormat.Style。用于指定样式类型，包括三种：Style.NUMBER（正常数字类型）、 Style.CURRENCY（货币类型）、 Style.PERCENT（百分数类型） – pattern：类型为 String，自定义样式，如patter="#,###"；代码在之前的基础上更新

//springmvc/src/springmvc.xml第一种 <mvc:annotation-driven conversion-></mvc:annotation-driven> //第二种即可格式化也可类型转换 <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>  <bean id="conversionService" class="org.springframework.format.support.FormattingConversionServiceFactoryBean"> <property name="converters"> <set> <ref bean="employeeConverter"/> </set> </property> </bean> springmvc/src/springmvc/crud/entities/Employee.java @DateTimeFormat(pattern="yyyy-MM-dd") private Date birth; @NumberFormat(pattern="#,###,###.#") private Float salary; ///springmvc/src/springmvc/crud/handlers/EmployeeHandler.java //类型转化出错怎么办 @RequestMapping(value="/emp", method=RequestMethod.POST) public String save( Employee employee, Errors result){ System.out.println("save: " + employee); if(result.getErrorCount() > 0){ System.out.println("出错了!"); for(FieldError error:result.getFieldErrors()){ System.out.println(error.getField() + ":" + error.getDefaultMessage()); } employeeDao.save(employee); return "input"; } ///springmvc/WebRoot/WEB-INF/views/input.jsp Birth: <form:input path="birth"/> <form:errors path="birth"></form:errors> <br> Salary: <form:input path="salary"/> <br>

JSR 303

详细教程 • JSR 303 是 Java 为 Bean 数据合法性校验提供的标准框架，它已经包含在 JavaEE 6.0 中 . • JSR 303 通过在 Bean 属性上标注类似于 @NotNull、@Max 等标准的注解指定校验规则，并通过标准的验证接口对 Bean 进行验证

Hibernate Validator 扩展注解

• Hibernate Validator 是 JSR 303 的一个参考实现，除支持所有标准的校验注解外，它还支持以下的扩展注解

Spring MVC 数据校验

• Spring 4.0 拥有自己独立的数据校验框架，同时支持 JSR 303 标准的校验框架。 • Spring 在进行数据绑定时，可同时调用校验框架完成数据校验工作。在 Spring MVC 中，可直接通过注解驱动的方式进行数据校验. • Spring 的 LocalValidatorFactroyBean 既实现了 Spring 的 Validator 接口，也实现了 JSR 303 的 Validator 接口。只要在 Spring 容器中定义了一个LocalValidatorFactoryBean，即可将其注入到需要数据校验的 Bean 中。 • Spring 本身并没有提供 JSR303 的实现，所以必须将 JSR303 的实现者的 jar 包放到类路径下。 • < mvc:annotation-driven/> 会默认装配好一个LocalValidatorFactoryBean，通过在处理方法的入参上标注 @valid 注解即可让 Spring MVC 在完成数据绑定后执行数据校验的工作 • 在已经标注了 JSR303 注解的表单/命令对象前标注一个@Valid，Spring MVC 框架在将请求参数绑定到该入参对象后，就会调用校验框架根据注解声明的校验规则实施校验 • Spring MVC 是通过对处理方法签名的规约来保存校验结果的：前一个表单/命令对象的校验结果保存到随后的入参中，这个保存校验结果的入参必须是 BindingResult 或Errors 类型，这两个类都位于org.springframework.validation 包中 • 需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的，它们之间不允许声明其他的入参 • Errors 接口提供了获取错误信息的方法，如 getErrorCount() 或 getFieldErrors(String field) • BindingResult 扩展了 Errors 接口代码在前面基础上

///springmvc/WebRoot/WEB-INF/views/input.jsp  /// /springmvc/src/springmvc/crud/handlers/EmployeeHandler.java更新 @RequestMapping(value="/emp", method=RequestMethod.POST) public String save(@Valid Employee employee, Errors result, Map<String, Object> map){ System.out.println("save: " + employee); if(result.getErrorCount() > 0){ System.out.println("出错了!"); for(FieldError error:result.getFieldErrors()){ System.out.println(error.getField() + ":" + error.getDefaultMessage()); } //若验证出错, 则转向定制的页面 map.put("departments", departmentDao.getDepartments()); return "input"; } employeeDao.save(employee); return "redirect:/emps"; } /// ///springmvc/src/springmvc/crud/entities/Employee.java private Integer id; @NotEmpty private String lastName; @Email private String email; //1 male, 0 female private Integer gender; private Department department; @Past @DateTimeFormat(pattern="yyyy-MM-dd") private Date birth; @NumberFormat(pattern="#,###,###.#") private Float salary;

在目标方法中获取校验结果

• 在表单/命令对象类的属性中标注校验注解，在处理方法对应的入参前添加 @Valid，Spring MVC 就会实施校验并将校验结果保存在被校验入参对象之后的 BindingResult 或Errors 入参中。 • 常用方法： – FieldError getFieldError(String field) – List< FieldError> getFieldErrors() – Object getFieldValue(String field) – Int getErrorCount()

在页面上显示错误

• Spring MVC 除了会将表单/命令对象的校验结果保存到对应的 BindingResult 或 Errors 对象中外，还会将所有校验结果保存到 “隐含模型” • 即使处理方法的签名中没有对应于表单/命令对象的结果入参，校验结果也会保存在 “隐含对象” 中。 • 隐含模型中的所有数据最终将通过 HttpServletRequest 的属性列表暴露给 JSP 视图对象，因此在 JSP 中可以获取错误信息 • 在 JSP 页面上可通过 < form:errors path=“userName”> 显示错误消息例子（前面基础上）：

///springmvc/WebRoot/WEB-INF/views/input.jsp <form:errors path="*"></form:errors> <br> <c:if test="${employee.id == null }">  LastName: <form:input path="lastName"/> <form:errors path="lastName"></form:errors> </c:if>

提示消息的国际化

• 每个属性在数据绑定和数据校验发生错误时，都会生成一个对应的 FieldError 对象。 • 当一个属性校验失败后，校验框架会为该属性生成 4 个消息代码，这些代码以校验注解类名为前缀，结合modleAttribute、属性名及属性类型名生成多个对应的消息代码：例如 User 类中password 属性标准了一个@Pattern 注解，当该属性值不满足 @Pattern 所定义的规则时, 就会产生以下 4 个错误代码： – Pattern.user.password – Pattern.password – Pattern.java.lang.String – Pattern • 当使用 Spring MVC 标签显示错误消息时，Spring MVC 会查看WEB 上下文是否装配了对应的国际化消息，如果没有，则显示默认的错误消息，否则使用国际化消息。 • 若数据类型转换或数据格式转换时发生错误，或该有的参数不存在，或调用处理方法时发生错误，都会在隐含模型中创建错误消息。其错误代码前缀说明如下： – required：必要的参数不存在。如@RequiredParam(“param1”) 标注了一个入参，但是该参数不存在 – typeMismatch：在数据绑定时，发生数据类型不匹配的问题 – methodInvocation：Spring MVC 在调用处理方法时发生了错误例子（在前面的基础上）： /springmvc/src/i18n.properties

///springmvc/src/springmvc.xml添加  <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource"> <property name="basename" value="i18n"></property> </bean>

处理 JSON

架包例子（在前面的基础之上）

///springmvc/WebRoot/index.jsp添加 //head中 <script type="text/javascript" src="https://cdn.staticfile.org/jquery/1.10.2/jquery.min.js"></script> <script type="text/javascript"> $(function(){ $("#testJson").click(function(){ var url = this.href; var args = {}; $.post(url, args, function(data){ for(var i = 0; i < data.length; i++){ var id = data[i].id; var lastName = data[i].lastName; alert(id + ": " + lastName); } }); return false; }); }) </script> //body中 <a href="testJson" id="testJson">Test Json</a> <br><br> / ///springmvc/src/springmvc/test/SpringMVCTest.java @ResponseBody @RequestMapping("/testJson") public Collection<Employee> testJson(){ return employeeDao.getAll(); }

HttpMessageConverter

• HttpMessageConverter< T> 是 Spring3.0 新添加的一个接口，负责将请求信息转换为一个对象（类型为 T），将对象（类型为 T）输出为响应信息 • HttpMessageConverter< T>接口定义的方法： – Boolean canRead(Class<?> clazz,MediaType mediaType): 指定转换器可以读取的对象类型，即转换器是否可将请求信息转换为 clazz 类型的对象，同时指定支持 MIME 类型(text/html,applaiction/json等) – Boolean canWrite(Class<?> clazz,MediaTypemediaType):指定转换器是否可将 clazz 类型的对象写到响应流中，响应流支持的媒体类型 MediaType 中定义。 – LIst< MediaType> getSupportMediaTypes()：该转换器支持的媒体类型。 – T read(Class<? extends T> clazz,HttpInputMessage inputMessage)：将请求信息流转换为 T 类型的对象。 – void write(T t,MediaTypecontnetType,HttpOutputMessgae outputMessage):将T类型的对象写到响应流中，同时指定相应的媒体类型为 contentType。实现类

使用 HttpMessageConverter< T>

• 使用 HttpMessageConverter< T> 将请求信息转化并绑定到处理方法的入参中或将响应结果转为对应类型的响应信息，Spring 提供了两种途径： – 使用 @RequestBody / @ResponseBody 对处理方法进行标注 – 使用 HttpEntity< T>/ResponseEntity< T> 作为处理方法的入参或返回值 • 当控制器处理方法使用@RequestBody/@ResponseBody 或HttpEntity< T>/ResponseEntity< T> 时, Spring 首先根据请求头或响应头的Accept 属性选择匹配的HttpMessageConverter, 进而根据参数类型或泛型类型的过滤得到匹配的 HttpMessageConverter, 若找不到可用的 HttpMessageConverter 将报错 • @RequestBody 和 @ResponseBody 不需要成对出现. 例子（在前面基础上）：

///springmvc/WebRoot/index.jsp增加 <form action="testHttpMessageConverter" method="POST" enctype="multipart/form-data"> File: <input type="file" name="file"/> Desc: <input type="text" name="desc"/> <input type="submit" value="Submit"/> </form> <br><br> ///springmvc/src/springmvc/test/SpringMVCTest.java增加 @ResponseBody @RequestMapping("/testHttpMessageConverter") public String testHttpMessageConverter(@RequestBody String body){ System.out.println(body); return "helloworld! " + new Date(); }

HttpEntity、ResponseEntity

//springmvc/WebRoot/index.jsp增加 <a href="testResponseEntity">Test ResponseEntity</a> /// ///springmvc/src/springmvc/test/SpringMVCTest.java增加 @RequestMapping("/testResponseEntity") public ResponseEntity<byte[]> testResponseEntity(HttpSession session) throws IOException{ byte [] body = null; ServletContext servletContext = session.getServletContext(); InputStream in = servletContext.getResourceAsStream("/index.jsp"); body = new byte[in.available()]; in.read(body); HttpHeaders headers = new HttpHeaders(); headers.add("Content-Disposition", "attachment;filename=abc.txt"); HttpStatus statusCode = HttpStatus.OK; ResponseEntity<byte[]> response = new ResponseEntity<byte[]>(body, headers, statusCode); return response; }

国际化概述

• 默认情况下，SpringMVC 根据 Accept-Language 参数判断客户端的本地化类型。 • 当接受到请求时，SpringMVC 会在上下文中查找一个本地化解析器（LocalResolver），找到后使用它获取请求所对应的本地化类型信息。 • SpringMVC 还允许装配一个动态更改本地化类型的拦截器，这样通过指定一个请求参数就可以控制单个请求的本地化类型。代码在前面的基础上前面说道加上相应的资源文件 2.在配置文件中配置相

///springmvc/WebRoot/index.jsp增加  <br><br> <a href="i18n">I18N PAGE</a> <br><br> /springmvc/WebRoot/WEB-INF/views/i18n.jsp <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <fmt:message key="i18n.user"></fmt:message> <br><br> <a href="i18n2">I18N2 PAGE</a> </body> </html> /// ///springmvc/WebRoot/WEB-INF/views/i18n2.jsp <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <fmt:message key="i18n.password"></fmt:message> <br><br> <a href="i18n">I18N PAGE</a> </body> </html> / ///springmvc/src/springmvc.xml增加 <mvc:view-controller path="/i18n" view-name="i18n"/> <mvc:view-controller path="/i18n2" view-name="i18n2"/> <-- 2. 可以在 bean 中获取国际化资源文件 Locale 对应的消息解决: 2. 在 bean 中注入 ResourceBundleMessageSource 的示例, 使用其对应的 getMessage 方法即可--> ///springmvc/src/springmvc/test/SpringMVCTest.java增加 @Autowired private ResourceBundleMessageSource messageSource; @RequestMapping("/i18n") public String testI18n(Locale locale){ String val = messageSource.getMessage("i18n.user", null, locale); System.out.println(val); return "i18n"; }

SessionLocaleResolver & LocaleChangeInterceptor 工作原理

代码在前面的基础上

<--3. 可以通过超链接切换 Locale, 而不再依赖于浏览器的语言设置情况解决: 3. 配置 LocalResolver 和 LocaleChangeInterceptor --> /// ///springmvc/WebRoot/WEB-INF/views/i18n.jsp增加 <br><br> <a href="i18n?locale=zh_CH">中文</a> <br><br> <a href="i18n?locale=en_US">英文</a> ///springmvc/src/springmvc.xml增加  <bean id="localeResolver" class="org.springframework.web.servlet.i18n.SessionLocaleResolver"></bean> <mvc:interceptors>  <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean> </mvc:interceptors> <mvc:view-controller path="/i18n" view-name="i18n"/> <mvc:view-controller path="/i18n2" view-name="i18n2"/>

本地化解析器和本地化拦截器

• AcceptHeaderLocaleResolver：根据 HTTP 请求头的 Accept-Language 参数确定本地化类型，如果没有显式定义本地化解析器， SpringMVC 使用该解析器。 • CookieLocaleResolver：根据指定的 Cookie 值确定本地化类型 • SessionLocaleResolver：根据 Session 中特定的属性确定本地化类型 • LocaleChangeInterceptor：从请求参数中获取本次请求对应的本地化类型。

文件上传

• Spring MVC 为文件上传提供了直接的支持，这种支持是通过即插即用的 MultipartResolver 实现的。Spring 用Jakarta Commons FileUpload 技术实现了一个MultipartResolver 实现类：CommonsMultipartResovler • Spring MVC 上下文中默认没有装配MultipartResovler因此默认情况下不能处理文件的上传工作，如果想使用 Spring 的文件上传功能，需现在上下文中配置 MultipartResolver • defaultEncoding: 必须和用户 JSP 的 pageEncoding 属性一致，以便正确解析表单的内容 • 为了让 CommonsMultipartResovler 正确工作，必须先将Jakarta Commons FileUpload 及 Jakarta Commons io的类包添加到类路径下。代码在前面的基础上

///springmvc/src/springmvc.xml增加  <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="defaultEncoding" value="UTF-8"></property> <property name="maxUploadSize" value="1024000"></property> </bean> ///springmvc/src/springmvc/test/SpringMVCTest.java @RequestMapping("/testFileUpload") public String testFileUpload(@RequestParam("desc") String desc, @RequestParam("file") MultipartFile file) throws IOException{ System.out.println("desc: " + desc); System.out.println("OriginalFilename: " + file.getOriginalFilename()); System.out.println("InputStream: " + file.getInputStream()); return "success"; } ///springmvc/WebRoot/index.jsp <form action="testFileUpload" method="POST" enctype="multipart/form-data"> File: <input type="file" name="file"/> Desc: <input type="text" name="desc"/> <input type="submit" value="Submit"/> </form> <br><br>

自定义拦截器

• Spring MVC也可以使用拦截器对请求进行拦截处理，用户可以自定义拦截器来实现特定的功能，自定义的拦截器必须实现HandlerInterceptor接口 – preHandle()：这个方法在业务处理器处理请求之前被调用，在该方法中对用户请求 request 进行处理。如果程序员决定该拦截器对请求进行拦截处理后还要调用其他的拦截器，或者是业务处理器去进行处理，则返回true；如果程序员决定不需要再调用其他的组件去处理请求，则返false。 – postHandle()：这个方法在业务处理器处理完请求后，但是DispatcherServlet 向客户端返回响应前被调用，在该方法中对用户请求request进行处理。 – afterCompletion()：这个方法在DispatcherServlet 完全处理完请求后被调用，可以在该方法中进行一些资源清理的操作。代码在前面的基础上

///springmvc/src/springmvc.xml更新 <mvc:interceptors>  <bean class="org.springframework.web.servlet.i18n.LocaleChangeInterceptor"></bean>  <bean class="springmvc.interceptors.FirstInterceptor"></bean>  <mvc:interceptor> <mvc:mapping path="/emps"/> <bean class="springmvc.interceptors.SecondInterceptor"></bean> </mvc:interceptor><--SecondInterceptor省略--> </mvc:interceptors> //springmvc/src/springmvc/interceptors/FirstInterceptor.java package springmvc.interceptors; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import org.springframework.web.servlet.HandlerInterceptor; import org.springframework.web.servlet.ModelAndView; public class FirstInterceptor implements HandlerInterceptor{ /** * 该方法在目标方法之前被调用. * 若返回值为 true, 则继续调用后续的拦截器和目标方法. * 若返回值为 false, 则不会再调用后续的拦截器和目标方法. * * 可以考虑做权限. 日志, 事务等. */ @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { System.out.println("[FirstInterceptor] preHandle"); return true; } /** * 调用目标方法之后, 但渲染视图之前. * 可以对请求域中的属性或视图做出修改. */ @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { System.out.println("[FirstInterceptor] postHandle"); } /** * 渲染视图之后被调用. 释放资源 */ @Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception { System.out.println("[FirstInterceptor] afterCompletion"); } }

异常处理

• Spring MVC 通过 HandlerExceptionResolver 处理程序的异常，包括 Handler 映射、数据绑定以及目标方法执行时发生的异常。 • SpringMVC 提供的 HandlerExceptionResolver 的实现类

HandlerExceptionResolver

• 主要处理 Handler 中用 @ExceptionHandler 注解定义的方法。 • @ExceptionHandler 注解定义的方法优先级问题：例如发生的是NullPointerException，但是声明的异常有RuntimeException 和 Exception，此候会根据异常的最近继承关系找到继承深度最浅的那个 @ExceptionHandler注解方法，即标记了 RuntimeException 的方法 • ExceptionHandlerMethodResolver 内部若找不到@ExceptionHandler 注解的话，会找 @ControllerAdvice 中的@ExceptionHandler 注解方法

///springmvc/src/springmvc/test/SpringMVCTest.java /** * 1. 在 @ExceptionHandler 方法的入参中可以加入 Exception 类型的参数, 该参数即对应发生的异常对象 * 2. @ExceptionHandler 方法的入参中不能传入 Map. 若希望把异常信息传导页面上, 需要使用 ModelAndView 作为返回值 * 3. @ExceptionHandler 方法标记的异常有优先级的问题. 最高精确为主 * 4. @ControllerAdvice: 如果在当前 Handler 中找不到 @ExceptionHandler 方法来出来当前方法出现的异常, * 则将去 @ControllerAdvice 标记的类中查找 @ExceptionHandler 标记的方法来处理异常. * 被测试目标方法省略 */ @ExceptionHandler({ArithmeticException.class}) public ModelAndView handleArithmeticException(Exception ex){ System.out.println("出异常了: " + ex); ModelAndView mv = new ModelAndView("error"); mv.addObject("exception", ex); return mv; } ///springmvc/src/springmvc/test/SpringMVCTestExceptionHandler.java import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.servlet.ModelAndView; @ControllerAdvice public class SpringMVCTestExceptionHandler { @ExceptionHandler({ArithmeticException.class}) public ModelAndView handleArithmeticException(Exception ex){ System.out.println("----> 出异常了: " + ex); ModelAndView mv = new ModelAndView("error"); mv.addObject("exception", ex); return mv; } }

ResponseStatusExceptionResolver

• 在异常及异常父类中找到 @ResponseStatus 注解，然后使用这个注解的属性进行处理。 • 定义一个 @ResponseStatus 注解修饰的异常类 • 若在处理器方法中抛出了上述异常：若ExceptionHandlerExceptionResolver 不解析述异常。由于触发的异常 UnauthorizedException 带@ResponseStatus 注解。因此会被ResponseStatusExceptionResolver 解析到。最后响应HttpStatus.UNAUTHORIZED 代码给客户端。HttpStatus.UNAUTHORIZED 代表响应码401，无权限。关于其他的响应码请参考 HttpStatus 枚举类型源码。代码在之前的基础上

//springmvc/src/springmvc/test/UserNameNotMatchPasswordException.java import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.ResponseStatus; @ResponseStatus(value=HttpStatus.FORBIDDEN, reason="用户名和密码不匹配!") public class UserNameNotMatchPasswordException extends RuntimeException{ private static final long serialVersionUID = 1L; } springmvc/src/springmvc/test/SpringMVCTest.java //目标请略 .//@ResponseStatus(reason="测试",value=HttpStatus.NOT_FOUND) @RequestMapping("/testResponseStatusExceptionResolver") public String testResponseStatusExceptionResolver(@RequestParam("i") int i){ if(i == 13){ throw new UserNameNotMatchPasswordException(); } System.out.println("testResponseStatusExceptionResolver..."); return "success"; }

DefaultHandlerExceptionResolver

• 对一些特殊的异常进行处理，比如NoSuchRequestHandlingMethodException、HttpRequestMethodNotSupportedException、HttpMediaTypeNotSupportedException、HttpMediaTypeNotAcceptableException 等。

SimpleMappingExceptionResolver

• 如果希望对所有异常进行统一处理，可以使用SimpleMappingExceptionResolver，它将异常类名映射为视图名，即发生异常时使用对应的视图报告异常代码在前面的基础

///springmvc/src/springmvc.xml配置文件目标方法省略  <bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver"> <property name="exceptionAttribute" value="ex"></property> <property name="exceptionMappings"> <props> <prop key="java.lang.ArrayIndexOutOfBoundsException">error</prop> </props> </property> </bean> springmvc/WebRoot/WEB-INF/views/error.jsp ${requestScope.exception }

springmvc运行流程

二者同时使用，否则requestmapping无效总体结构下一篇

Processed: 0.020, SQL: 9