Spring MVC 学习笔记（二）

6. 视图和视图解析器

 ❤  Spring MVC如何解析视图

                              

 

• 请求处理方法执行完成后，最终返回一个ModelAndView对象。对于那些返回String，View或ModeMap等类型的处理方法，spring MVC 都会在内部将它们装配成一个ModelAndView对象，它包含了逻辑名和模型对象的视图

• Spring MVC 借助视图解析器（ViewResolver）得到最终的视图对象（View），最终的视图可以是JSP也可是Excell、

JFreeChart等各种表现形式的视图

• 对于最终究竟采取何种视图对象对模型数据进行渲染，处理器并不关心，处理器工作重点聚焦在生产模型数据的工作上，从而实现MVC 的充分解耦

 

 ❤  视图

• 视图的作用是渲染模型数据，将模型里的数据以某种形式呈现给客户。

• 为了实现视图模型和具体实现技术的解耦，Spring 在org.springframework.web.servlet包中定义了一个高度抽象的View接口

• 视图对象由视图解析器负责实例化。由于视图是无状态的，所以他们不会有线程安全的问题

 

  常用的视图实现类

 

  

 

 ❤  视图解析器（将逻辑视图转为物理视图）

• SpringMVC为逻辑视图名的解析提供了不同的策略，可以在Spring WEB上下文中配置一种或多种解析策略，并指定他们之间的先后顺序。每一种映射策略对应一个具体的视图解析器实现类。

• 视图解析器的作用比较单一：将逻辑视图解析为一个具体的视图对象。

• 所有的视图解析器都必须实现ViewResolver接口：

                            

 

  常用的视图解析器实现类

 

• 程序员可以选择一种视图解析器或混用多种视图解析器

• 每个视图解析器都实现了Ordered 接口并开放出一个order属性，可以通过order 属性指定解析器的优先顺序，order 越小优先级越高。

    • SpringMVC会按视图解析器顺序的优先顺序对逻辑视图名进行解析，直到解析成功并返回视图对象，则抛出ServletException异常

 

 ❤  InternalResourceViewResolver

• JSP 是最常见的视图技术，可以使用InternalResourceViewResolver作为视图解析器：

 

1. <!-- 配置视图解析器：如何把handler方法返回值解析为实际的物理视图-->
2. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
3. <property name="prefix" value="/WEB-INF/views/"></property>
4. <property name="suffix" value=".jsp"></property>
5. </bean>

 

• 若项目中使用了JSTL，则SpringMVC会自动把视图由InternalResourceView转为JstlView

• 若使用JSTL 的fmt标签则需要在SpringMVC的配置文件中配置国际化资源文件

 

1. <!--  配置国际化资源文件 -->
2. <bean id="messageSource"
3. class="org.springframework.context.support.ResourceBundleMessageSource">
4. <property name="basename" value="i18n"></property>
5. </bean> <span style="font-family:微软雅黑;background-color: inherit; line-height: 1.875;">
6. </span>

• 若希望直接响应通过SpringMVC渲染的页面，可以使用mvc:view-controller标签实现

 

1. <!-- 配置直接转发的页面 -->
2. <!-- 可以直接相应转发的页面, 而无需再经过 Handler 的方法.  -->
3. <mvc:view-controller path="/success" view-name="success"/>
4. <!-- 在实际开发中通常都需配置 mvc:annotation-driven 标签，  之前的页面才不会因为配置了直接转发页面而受到影响 -->
5. <mvc:annotation-driven></mvc:annotation-driven>

 

 

 ❤ Excel 视图

• 若希望使用Excel 展示数据列表，仅需要扩展SpringMVC提供的AbstractExcelView或AbstractJExcelView 即可。实现buildExcelDocument()方法，在方法中使用模型数据对象构建Excel 文档就可以了。

• AbstractExcelView基于POI API，而AbstractJExcelView是基于JExcelAPI的。

• 视图对象需要配置IOC 容器中的一个Bean，使用BeanNameViewResolver作为视图解析器即可

• 若希望直接在浏览器中直接下载Excel 文档，则可以设置响应头Content-Disposition的值为attachment;filename=xxx.xls

 

 ❤ 关于重定向

• 一般情况下，控制器方法返回字符串类型的值会被当成逻辑视图名处理

• 如果返回的字符串中带forward:或redirect:前缀时，SpringMVC会对他们进行特殊处理：将forward: 和redirect: 当成指示符，其后的字符串作为URL 来处理

– redirect:success.jsp：会完成一个到success.jsp的重定向的操作

– forward:success.jsp：会完成一个到success.jsp的转发操作

 

1. @Controller
2. @RequestMapping("springmvc")
3. //@SessionAttributes(value={"user"},types={String.class})
4. public class SpringMVCTest {
5. @RequestMapping(value="/testRedirect")
6. public String testRedirect(){
7. System.out.println("testRedirect...");
8. return "redirect:/index2.jsp";       //如果是转发就写为forward:
9. }}

 

 

7. RESTful SpringMVC CRUD

    需求:

    ①.显示所有员工信息（url:emps     请求方式：GET    显示效果如下）

    

 ②. 添加员工信息

      显示添加页面（url:emp     请求方式：GET    添加页面显示效果如下）

    添加后页面（url:emp     请求方式：POST    完成添加后重定向到list页面）

 ③. 删除（url:emp/{id}     请求方式：DELETE    对应记录从数据表中删除）

 ④. 修改，lastName不可修改

      显示修改页面（url:emp/{id}     请求方式：GET    回显表单）

    添加后页面（url:emp     请求方式：PUT       完成修改后重定向到list页面）

 

   实现:

 

1. @Controller
2. public class EmployeeHandler {
3. @Autowired
4. private EmployeeDao employeeDao;
5. @Autowired
6. private DepartmentDao departmentDao;
7. @RequestMapping("/emps")
8. public String list(Map<String,Object> map){
9. map.put("employees", employeeDao.getAll());
10. return "list";
11. }
12. @RequestMapping(value="emp",method=RequestMethod.GET)
13. public String input(Map<String,Object> map){
14. map.put("departments", departmentDao.getDepartments());
15. map.put("employee", new Employee());
16. return "input";
17. }
18. @RequestMapping(value="/emp",method=RequestMethod.POST)
19. public String save(Employee employee){
20. employeeDao.save(employee);
21. return "redirect:/emps";
22. }
23. @RequestMapping(value="/emp/{id}",method=RequestMethod.DELETE)
24. public String delete(@PathVariable("id") Integer id){
25. employeeDao.delete(id);
26. return "redirect:/emps";
27. }
28. @RequestMapping(value="/emp/{id}", method=RequestMethod.GET)
29. public String input(@PathVariable("id") Integer id, Map<String, Object> map){
30. map.put("employee", employeeDao.get(id));
31. map.put("departments", departmentDao.getDepartments());
32. return "input";
33. }
34. @RequestMapping(value="/emp", method=RequestMethod.PUT)
35. public String update(Employee employee){
36. employeeDao.save(employee);
37. return "redirect:/emps";
38. }
39. @ModelAttribute
40. public void getEmployee(@RequestParam(value="id",required=false) Integer id,
41. Map<String, Object> map){
42. if(id != null){
43. map.put("employee", employeeDao.get(id));
44. }
45. }    }
46. ————————————web.xml——————————————————————
47. <?xml version="1.0" encoding="UTF-8"?>
48. <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
49. xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
50. xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
51. id="WebApp_ID" version="2.5">
52. <!-- 配置 SpringMVC 的 DispatcherServlet -->
53. <servlet>
54. <servlet-name>springDispatcherServlet</servlet-name>
55. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
56. <init-param>
57. <param-name>contextConfigLocation</param-name>
58. <param-value>classpath:springmvc.xml</param-value>
59. </init-param>
60. <load-on-startup>1</load-on-startup>
61. </servlet>
62. <servlet-mapping>
63. <servlet-name>springDispatcherServlet</servlet-name>
64. <url-pattern>/</url-pattern>
65. </servlet-mapping>
66. <!-- 把post转为delete请求和put请求 -->
67. <filter>
68. <filter-name>HiddenHttpMethodFilter</filter-name>
69. <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
70. </filter>
71. <filter-mapping>
72. <filter-name>HiddenHttpMethodFilter</filter-name>
73. <url-pattern>/*</url-pattern>
74. </filter-mapping>
75. </web-app>
76. ————————————springmvc.xml————————————————————
77. <?xml version="1.0" encoding="UTF-8"?>
78. <beans xmlns="http://www.springframework.org/schema/beans"
79. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
80. xmlns:mvc="http://www.springframework.org/schema/mvc"
81. xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
82. http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
83. http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
84. <!-- 配置自动扫描的包 -->
85. <context:component-scan base-package="com.starfish.springmvc"></context:component-scan>
86. <!-- 配置视图解析器 -->
87. <!-- <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
88. p:prefix="/WEB-INF/views/"    p:suffix=".jsp"/>
89. </bean> -->
90. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
91. <property name="prefix" value="/views/"></property>
92. <property name="suffix" value=".jsp"></property>
93. </bean>
94. <mvc:default-servlet-handler/>
95. <mvc:annotation-driven></mvc:annotation-driven>
96. </beans>
97. ———————————————————list.jsp———————————————————————————
98. <html>
99. <head>
100. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
101. <title>Insert title here</title>
102. <!--
103. SpringMVC 处理静态资源:
104. 1. 为什么会有这样的问题:
105. 优雅的 REST 风格的资源URL 不希望带 .html 或 .do 等后缀
106. 若将 DispatcherServlet 请求映射配置为 /,
107. 则 Spring MVC 将捕获 WEB 容器的所有请求, 包括静态资源的请求, SpringMVC 会将他们当成一个普通请求处理,
108. 因找不到对应处理器将导致错误。
109. 2. 解决: 在 SpringMVC 的配置文件中配置 <mvc:default-servlet-handler/>
110. -->
111. <script type="text/javascript" src="scripts/jquery-1.9.1.min.js"></script>
112. <script type="text/javascript">
113. $(function(){
114. $(".delete").click(function(){
115. var href = $(this).attr("href");
116. $("form").attr("action", href).submit();
117. return false;
118. });
119. })
120. </script>
121. </head>
122. <body>
123. <form action="" method="POST">
124. <input type="hidden" name="_method" value="DELETE"/>
125. </form>
126. <c:if test="${empty requestScope.employees }">
127. 没有任何员工信息.
128. </c:if>
129. <c:if test="${!empty requestScope.employees }">
130. <table border="1" cellpadding="10" cellspacing="0">
131. <tr>
132. <th>ID</th>
133. <th>LastName</th>
134. <th>Email</th>
135. <th>Gender</th>
136. <th>Department</th>
137. <th>Edit</th>
138. <th>Delete</th>
139. </tr>
140. <c:forEach items="${requestScope.employees }" var="emp">
141. <tr>
142. <td>${emp.id }</td>
143. <td>${emp.lastName }</td>
144. <td>${emp.email }</td>
145. <td>${emp.gender == 0 ? 'Female' : 'Male' }</td>
146. <td>${emp.department.departmentName }</td>
147. <td><a href="emp/${emp.id}">Edit</a></td>
148. <td><a class="delete" href="emp/${emp.id}">Delete</a></td>
149. </tr>
150. </c:forEach>
151. </table>
152. </c:if>
153. <br><br>
154. <a href="emp">Add New Employee</a>
155. </body>
156. </html>
157. ————————————————input.jsp————————————————————————————————
158. <body>
159. <!--
160. 1. WHY 使用 form 标签呢 ?
161. 可以更快速的开发出表单页面, 而且可以更方便的进行表单值的回显
162. 2. 注意:
163. 可以通过 modelAttribute 属性指定绑定的模型属性,
164. 若没有指定该属性，则默认从 request 域对象中读取 command 的表单 bean
165. 如果该属性值也不存在，则会发生错误。
166. -->
167. <form:form action="${pageContext.request.contextPath }/emp" method="POST"
168. modelAttribute="employee">
169. <form:errors path="*"></form:errors>
170. <br>
171. <c:if test="${employee.id == null }">
172. <!-- path 属性对应 html 表单标签的 name 属性值 -->
173. LastName: <form:input path="lastName"/>
174. <form:errors path="lastName"></form:errors>
175. </c:if>
176. <c:if test="${employee.id != null }">
177. <form:hidden path="id"/>
178. <input type="hidden" name="_method" value="PUT"/>
179. <%-- 对于 _method 不能使用 form:hidden 标签, 因为 modelAttribute 对应的 bean 中没有 _method 这个属性 --%>
180. <%--
181. form标签有表单回显的作用，所以form标签中的path属性必须在modelAttribute中的bean有相应的属性
182. <form:hidden path="_method" value="PUT"/>  这样写的话bean中必须有_method属性
183. --%>
184. </c:if>
185. <br>
186. Email: <form:input path="email"/>
187. <form:errors path="email"></form:errors>
188. <br>
189. <%
190. Map<String, String> genders = new HashMap();
191. genders.put("1", "Male");
192. genders.put("0", "Female");
193. request.setAttribute("genders", genders);
194. %>
195. Gender:
196. <br>
197. <form:radiobuttons path="gender" items="${genders }" delimiter="<br>"/>
198. <br>
199. Department: <form:select path="department.id"
200. items="${departments }" itemLabel="departmentName" itemValue="id"></form:select>
201. <br>
202. <!--
203. 1. 数据类型转换
204. 2. 数据类型格式化
205. 3. 数据校验.
206. 1). 如何校验 ? 注解 ?
207. ①. 使用 JSR 303 验证标准
208. ②. 加入 hibernate validator 验证框架的 jar 包
209. ③. 在 SpringMVC 配置文件中添加 <mvc:annotation-driven />
210. ④. 需要在 bean 的属性上添加对应的注解
211. ⑤. 在目标方法 bean 类型的前面添加 @Valid 注解
212. 2). 验证出错转向到哪一个页面 ?
213. 注意: 需校验的 Bean 对象和其绑定结果对象或错误对象时成对出现的，它们之间不允许声明其他的入参
214. 3). 错误消息 ? 如何显示, 如何把错误消息进行国际化
215. -->
216. <%-- Birth: <form:input path="birth"/>
217. <form:errors path="birth"></form:errors>
218. <br>
219. Salary: <form:input path="salary"/> --%>
220. <br>
221. <input type="submit" value="Submit"/>
222. </form:form>
223. </body>

 

 

8.SpringMVC表单标签&处理静态资源

 

 

 ❤  使用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 指定分隔符  delimiter="<br>"

 

    • form:checkbox：复选框组件。用于构造单个复选框

    • form:checkboxs：用于构造多个复选框。使用方式同form:radiobuttons标签

    • form:select：用于构造下拉框组件。使用方式同form:radiobuttons标签

    • form:option：下拉框选项组件标签。使用方式同form:radiobuttons标签

    • form:errors：显示表单组件或数据校验所对应的错误

        –  <form:errorspath=“*” />：显示表单所有的错误

        – <form:errorspath= “ user*” />：显示所有以user 为前缀的属性对应的错误

        – <form:errorspath= “ username”/>：显示特定表单对象属性的错误

 

 

 ❤  处理静态资源

• 优雅的REST 风格的资源URL 不希望带.html 或.do 等后缀

• 若将DispatcherServlet请求映射配置为/，则Spring MVC 将捕获WEB 容器的所有请求，包括静态资源的请求，

SpringMVC会将他们当成一个普通请求处理，因找不到对应处理器将导致错误。

• 可以在SpringMVC的配置文件中配置<mvc:default-servlet-•handler/>的方式解决静态资源的问题：

–  <mvc:default-servlet-handler/> 将在SpringMVC上下文中定义一个DefaultServletHttpRequestHandler，它会对进入DispatcherServlet的请求进行筛查，如果发现是没有经过映射的请求，就将该请求交由WEB 应用服务器默认的Servlet 处理，如果不是静态资源的请求，才由DispatcherServlet继续处理

–  一般WEB 应用服务器默认的Servlet 的名称都是default。若所使用的–WEB 服务器的默认Servlet 名称不是default，则需要通过default-servlet-name 属性显式指定

 

9.数据转换&数据格式化&数据校验

 

 ❤ 数据绑定流程

• 1. Spring MVC主框架将ServletRequest对象及目标方法的入参实例传递给WebDataBinderFactory实例，以创建DataBinder实例对象

• 2. DataBinder调用装配在Spring MVC上下文中的ConversionService组件进行数据类型转换、数据格式化工作。将Servlet 中的请求信息填充到入参对象中

• 3. 调用Validator组件对已经绑定了请求消息的入参对象进行数据合法性校验，并最终生成数据绑定结果BindingData对象

• 4. Spring MVC抽取BindingResult中的入参对象和校验错误对象，将它们赋给处理方法的响应入参

• Spring MVC通过反射机制对目标处理方法进行解析，将请求消息绑定到处理方法的入参中。数据绑定的核心部件是DataBinder，运行机制如下：

 ❤  数据转换

• Spring MVC 上下文中内建了很多转换器，可完成大多数Java 类型的转换工作。

• ConversionServiceconverters =

– java.lang.Boolean  ->  java.lang.String:

org.springframework.core.convert.support.ObjectToStringConverter@f874ca

– java.lang.Character-> java.lang.Number: CharacterToNumberFactory@f004c9

– java.lang.Character-> java.lang.String: ObjectToStringConverter@68a961

– java.lang.Enum-> java.lang.String: EnumToStringConverter@12f060a

– java.lang.Number-> java.lang.Character: NumberToCharacterConverter@1482ac5

– java.lang.Number-> java.lang.Number: NumberToNumberConverterFactory@126c6f

– java.lang.Number-> java.lang.String: ObjectToStringConverter@14888e8

– java.lang.String-> java.lang.Boolean: StringToBooleanConverter@1ca6626

– java.lang.String-> java.lang.Character: StringToCharacterConverter@1143800

– java.lang.String-> java.lang.Enum: StringToEnumConverterFactory@1bba86e

– java.lang.String-> java.lang.Number: StringToNumberConverterFactory@18d2c12

– java.lang.String-> java.util.Locale: StringToLocaleConverter@3598e1

– java.lang.String-> java.util.Properties: StringToPropertiesConverter@c90828

– java.lang.String-> java.util.UUID: StringToUUIDConverter@a42f23

– java.util.Locale-> java.lang.String: ObjectToStringConverter@c7e20a

– java.util.Properties-> java.lang.String: PropertiesToStringConverter@367a7f

– java.util.UUID-> java.lang.String: ObjectToStringConverter@112b07f ......

自定义类型转换器

• ConversionService是Spring 类型转换体系的核心接口。

• 可以利用ConversionService FactoryBean在Spring 的IOC 容器中定义一个ConversionService. Spring 将自动识别出IOC 容器中的ConversionService，并在Bean 属性配置及Spring MVC 处理方法入参绑定等场合使用它进行数据的转换

• 可通过ConversionServiceFactoryBean的converters属性注册自定义的类型转换器

 

1. ——————————将字符串转换为employee对象  jsp——————————————————
2. <form action="testConversionServiceConverer" method="POST" >
3. <!-- lastname-email-gender-department.id 例如: GG-gg@atguigu.com-0-105 -->
4. Employee: <input type="text" name="employee"/>
5. <input type="submit" value="Submit"/>
6. </form>
7. ————————————————action————————————————————————
8. @RequestMapping("/testConversionServiceConverer")
9. public String testConverter(@RequestParam("employee") Employee employee){
10. System.out.println("save: " + employee);
11. employeeDao.save(employee);
12. return "redirect:/emps";
13. }
14. ————————————转换器————————————————————————————
15. @Component
16. public class EmployeeConverter implements Converter<String, Employee> {
17. @Override
18. public Employee convert(String source) {
19. if(source != null){
20. String [] vals = source.split("-");
21. //GG-gg@atguigu.com-0-105
22. if(vals != null && vals.length == 4){
23. String lastName = vals[0];
24. String email = vals[1];
25. Integer gender = Integer.parseInt(vals[2]);
26. Department department = new Department();
27. department.setId(Integer.parseInt(vals[3]));
28. Employee employee = new Employee(null, lastName, email, gender, department);
29. System.out.println(source + "--convert--" + employee);
30. return employee;
31. }
32. }
33. return null;
34. }
35. }
36. —————————————————springmvc.xml————————————————————————————
37. <!-- 配置 ConversionService -->
38. <bean id="conversionService"
39. class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
40. <property name="converters">
41. <set>
42. <ref bean="employeeConverter"/>
43. </set>
44. </property>
45. </bean>
46. <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>

 

 

 Spring 支持的转换器

• Spring 定义了3 种类型的转换器接口，实现任意一个转换器接口都可作为自定义转换器注册到ConversionServiceFactory     

中：

– Converter<S,T>：将S 类型对象转为T 类型对象

– ConverterFactory：将相同系列多个“同质”Converter 封装在一起。如果希望将一种类型的对象转换为另一种类型及其子类的对象（例如将String转换为Number 及Number 子类（Integer、Long、Double 等）对象）可使用该转换器工厂类

– GenericConverter：会根据源类对象及目标类对象所在的宿主类中的上下文信息进行类型转换

 

• <mvc:annotation-driven conversion-service=“conversionService”/>会将自定义的ConversionService注册到Spring MVC 的上下文中

 

 ❤ 关于mvc:annotation-driven

• <mvc:annotation-driven/>会自动注册RequestMappingHandlerMapping、RequestMappingHandlerAdapter

与ExceptionHandlerExceptionResolver三个bean。

• 还将提供以下支持：

– 支持使用ConversionService实例对表单参数进行类型转换（不加的话就没有ConversionService）

– 支持使用@NumberFormat、@DateTimeFormat注解完成数据类型的格式化

– 支持使用@Valid注解对JavaBean 实例进行JSR 303验证

– 支持使用@RequestBody和@ResponseBody注解

 ❤ @InitBinder

• 由@InitBinder标识的方法，可以对WebDataBinder对象进行初始化。WebDataBinder是DataBinder的子类，用于完成由表单字段到JavaBean 属性的绑定

• @InitBinder方法不能有返回值，它必须声明为void。

• @InitBinder方法的参数通常是WebDataBinder

 

1. //lastName不进行赋值，（不自动绑定对象中的lastName属性，另行处理）    user的角色赋值的时候可能会用到
2. @InitBinder
3. public void initBinder(WebDataBinder binder){
4. binder.setDisallowedFields("lastName");
5. }

 

 ❤ 数据格式化

• 对属性对象的输入/输出进行格式化，从其本质上讲依然属于“类型转换”的范畴。

• Spring 在格式化模块中定义了一个实现ConversionService接口的FormattingConversionService实现类，该实现类扩展了GenericConversionService，因此它既具有类型转换的功能，又具有格式化的功能

• FormattingConversionService拥有一个FormattingConversionServiceFactroyBean工厂类，后者用于在Spring 上下文中构造前者

• FormattingConversionServiceFactroyBean内部已经注册了:

– NumberFormatAnnotationFormatterFactroy：支持对数字类型的属性使用@NumberFormat注解

– JodaDateTimeFormatAnnotationFormatterFactroy：支持对日期类型的属性使用@DateTimeFormat注解

• 装配了FormattingConversionServiceFactroyBean后，就可以在Spring MVC 入参绑定及模型数据输出时使用注解驱动了。<mvc:annotation-driven/> 默认创建的ConversionService 实例即为 FormattingConversionServiceFactroyBean

1. <mvc:annotation-driven></mvc:annotation-driven>

 日期格式化

• @DateTimeFormat注解可对java.util.Date、java.util.Calendar、java.long.Long时间类型进行标注：

– pattern 属性：类型为字符串。指定解析/格式化字段数据的模式，如：”yyyy-MM-ddhh:mm:ss”

– iso属性：类型为DateTimeFormat.ISO。指定解析/格式化字段数据的ISO模式，包括四种：ISO.NONE（不使用）-- 默认、ISO.DATE(yyyy-MM-dd) 、ISO.TIME(hh:mm:ss.SSSZ)、ISO.DATE_TIME(yyyy-MM-ddhh:mm:ss.SSSZ)

– style 属性：字符串类型。通过样式指定日期时间的格式，由两位字符组成，第一位表示日期的格式，第二位表示时间的格式：S：短日期/时间格式、M：中日期/时间格式、L：长日期/时间格式、F：完整日期/时间格式、-：忽略日期或时间格式

 

 数值格式化

• @NumberFormat可对类似数字类型的属性进行标注，它拥有两个互斥的属性：

– style：类型为NumberFormat.Style。用于指定样式类型，包括三种：Style.NUMBER（正常数字类型）、Style.CURRENCY（货币类型）、Style.PERCENT（百分数类型）

– pattern：类型为String，自定义样式，如patter="#,###"；

 

格式化示例

 

1. @DateTimeFormat(pattern="yyyy-MM-dd")
2. private Date birth;
3. @NumberFormat(pattern="#,###,###.#")
4. private Float salary;
5. @RequestMapping("/handle")
6. pubic String  handle(@ModelAttribute("user") User user){
7. user.setId(10000);
8. return "success";
9. }

 

 ❤ 数据校验

• 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 接口

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

• 在表单/命令对象类的属性中标注校验注解，在处理方法对应的入参前添加@Valid，Spring MVC 就会实施校验并将校验结果保存在被校验入参对象之后的BindingResult或Errors 入参中。

• 常用方法：

– FieldErrorgetFieldError(String field)

– List<FieldError> getFieldErrors()

– Object getFieldValue(String field)

– Int getErrorCount()

 

 

 在页面上显示错误

• Spring MVC 除了会将表单/命令对象的校验结果保存到对应的BindingResult或Errors 对象中外，还会将所有校验结果保存到“隐含模型”

• 即使处理方法的签名中没有对应于表单/命令对象的结果入参，校验结果也会保存在“隐含对象”中。

• 隐含模型中的所有数据最终将通过HttpServletRequest的属性列表暴露给JSP 视图对象，因此在JSP 中可以获取错误信息

• 在JSP 页面上可通过<form:errorspath=“userName”> 显示错误消息

 

  提示消息的国际化

• 每个属性在数据绑定和数据校验发生错误时，都会生成一个对应的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 在调用处理方法时发生了错误–注册国际化资源文件