Spring MVC
1、Spring MVC概述
Spring MVC框架围绕DispatcherServlet这个核心展开，DispatcherServlet负责截获请求并将其分配给响应的处理器处理。Spring MVC框架包括注解驱动控制器、请求及响应的信息处理、视图解析、本地化解析、上传文件解析、异常处理以及表单标签绑定等内容。
2、注解驱动的控制器
2.1、使用@RequestMapping映射请求
- 通过请求URL进行映射
@RequestMapping("/user/register")
@RequestMpping不但支持标准的URL，还支持Ant风格（即?、和*的字符）的和带{xxx}占位符的URL，可以通过@ParhVariable将URL中的占位符参数绑定到控制器处理方法的入参中。
- 通过请求参数、请求方法或请求头进行映射
@RequestMapping(value="/delete", method=RequestMethod.POST, params="userId", headers="content-type=text/*")
2.2、请求处理方法签名
- 使用@RequestParam绑定请求参数值
public String handle(@RequestParam(value="userName", required=false))
- 使用@CookieValue绑定请求中的Cookie值
public String handle(@CookieValue(value="sessionId", required=false))
- 使用@RequestHeader绑定请求报文头的属性值
public String handle(@RequestHeader("Accept-Encoding") String encoding, @RequestHeader("Keep-Alive")long keepAlive)
- 使用命令/表单对象绑定请求参数值
/handle.html?userName=tom&userAge=12
Public String handle(User user)
- 使用Servlet API对象作为入参
public void handle(HttpServletRequest req, HttpServletResponse resp)
- 使用Spring MVC自定义的可代理Servlet原生API类的接口
public String handle(WebRequest req)
- 使用IO对象作为入参
Spring MVC可以获取ServletRequest的InputStream/Reader或者ServletRespons的OutputStream/Writer，然后传给控制器的处理方法
public void handle(OutputStream os)
2.3、使用HttpMessageConverter<T>
HttpMessageConverter<T>是Spring 3.0新添加的一个重要的接口，它负责将请求信息转换为一个对象（类型为T），将对象（类型为T）输出为响应信息。
如果在Spring web容器中显式定义了一个AnnotationMethodHandlerAdapter，则Spring MVC将使用它覆盖默认的AnnotationMethodHandlerAdapter。
使用途径：
1、使用@RequestBody/@ResponseBody对处理方法进行标注；
2、使用@HttpEntity<T>/ResponsEntity<T>作为处理方法的入参或者返回值；
2.4、处理模型数据
Spring MVC提供了多种途径将模型数据暴露给视图
- ModelAndView：处理方法返回值类型为ModelAndView时，方法体即可通过该对象添加模型数据；
- @ModelAttribute：方法入参标注该注解后，入参的对象就会放到数据模型中；
- Map 及 Model：入参为org.springframework.ui.Model、org.springframework.ui.ModelMap或java.util.Map时，处理方法返回时，Map中的数据会自动添加到模型中；
- @SessionAttributes：将模型中的某个属性暂存到HttpSession中，以便多个请求之间共享这个属性；
控制器方法返回字符串类型的值会被当成逻辑视图名处理。当字符串带"forward"或"redirect"前缀时，redirect会让浏览器发起一个新的请求，而forward所到的目标地址位于当前请求中。
3、处理方法的数据绑定
Spring MVC会根据请求方法签名的不同，将请求消息中的消息以一定的方式转换并绑定到请求方法的入参中。在请求消息到达真正调用处理方法的这一段时间内，Spring MVC还完成了很多工作，包括数据转换、数据格式化及数据校验等。
3.1、数据转换
//自定义转换器 <userName>:<password>:<realName> -> UserObject
public class StringToUserConverter implements Converter<String, User >{...}
//将StringToUserConverter安装到Spring上下文中
<beans ...>
<mvc:annotation-drever conversion-service="conversionService">
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactorybean">
<property name="converters"><list>
<bean class="...StringToUserConverter"/>
</list></property>
</bean>
</beans>
//使用StringToUserConverter
@ReqquestMapping(value="")
public String handle(@RequestParam("user") User user)
//url
xxx.html?user=tom:1234:jacktion
3.2、数据格式化
//将FormattingConversionServiceFactoryBean安装到Spring上下文中
org.springframework.format.support.FormattingConversionServiceFactoryBean
//使用注解驱动格式化功能
@DateTimeFormat(pattern="yyyy-MM-dd")
private Date birthday;
Spring 提供了注解驱动的属性对象格式化功能：在Bean属性设置、Spring MVC处理方法入参数据绑定、模型数据输出时自动通过注解应用格式化的功能。
3.3、数据校验
JSR 303是Java为Bean数据合法性校验所提供的标准框架，它已经包含在Java EE6.0中。
- Spring校验框架 LocalValidatorFactoryBean即实现了Spring的Validator接口，也实现了JSR303的Validator接口。
- Spring MVC数据校验,在表单/命令对象标注JSR303注解
@Pattern(regexp="");//正则表达式
private String userName;
@Length(min=2, max=100)//字符串长度
@DecimalMin //数值最小值
- 校验结果保存，前一个表单/命令对象的校验结果保存在其后的入参中，这个校验结果的入参必须是一个BindingResult和Errors类型
public String handle(@Valid @ModelAtterbute("user") User user, BindingResult bindingResult, @Valid Dept dept, Errors depErrors)
{if(bindingResult.hasError()) return ...}
- 页面显示错误
Spring MVC除了会将表单/命令对象的校验结果保存在对应的BindingResult或Errors中，还会将所有校验结果保存到“隐含模型”中。
<form:errors path="*"/> //显示表单对象所有的错误信息
<form:errors path="userName" cssClass="errorClass"/> //显示userName属性的错误
4、视图和视图解析器
请求方法执行完以后，最中返回一个ModelAndView对象，对于那些返回String、View或ModelMap等类型的处理方法，Spring MVC也会在内部将他们装配成一个ModelAndView对象，它包含了视图逻辑名和模型对象的信息。可以通过orderNo属性指定解析器的优先顺序，orderNo值越小优先级越高。
4.1、视图解析器
视图解析器工作内涵：根据逻辑视图名和本地化对象得到一个视图对象。
4.2、JSP和JSTL
jsp是最常见的视图技术，使用InternalResourceViewResolver作为视图解析器。
4.3、 模板视图
Spring Web上下文装配FreeMarker的基础设施和FreeMark视图解析器：
<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
4.4、Excel
扩展Spring的AbstractExcelView 或 AbstractJExcelView，使用BeanNameViewResolver视图解析器。
4.5、PDF
扩展AbstractOdfView，使用BeanNameViewResolver视图解析器。
4.6、输出XML
使用MarshallingView视图解析器，注入XStreamMarshaller，将模型数据转化为XML。
4.7、 输出JSON
Spring MVC的MappingJacksonJsonView借助Jackson框架的ObjectMapper将模型数据转化为JSON格式输出。
4.8、混合使用多种视图技术
ContentNegotiatingViewResolver根据请求所要求的MIME类型决定由哪个视图解析器负责解析，一般将其的优先级设置为最高。
5、本地化解析
- AcceptHeaderLocaleResolver：根据HTTP报文头的Accept-Language参数确定本地化类型；
- CookieLocaleResolver：根据指定的Cookie值确定本地化类型；
- SessionLocaleResolver：根据Session中特定的属性值确定本地化类型；
- LocaleChangeInterceptor：从请求参数中获取本次请求对应的本地化类型；
6、文件上传
Spring MVC通过Jakarta Commons FileUpload技术实现了一个Multipartresolver实现类：CommonsMultipartResolver。
7、杂项
7.1、静态资源处理
- 采用<mvc:default-servlet-handler/>将静态资源的处理经由Spring MVC框架交回Web应用服务器处理；
- <mvc:resources mapping="" location=""/> 由Spring MVC框架自己处理静态资源，并添加有用的附加值功能；
7.2、装配拦截器
<mvc:interceptors></mvc:interceptors>
7.3、异常处理
Spring MVC通过HandlerExceptionResolver处理程序的异常，包括处理器映射、数据绑定以及处理器执行时的异常。
- DeaufaultHandlerExceptionResolver 会将Spring MVC框架的异常转换为相应的相应状态码；
- AnnotationMethodHandlerExceptionResolver 允许通过@ExceptionHandler的注解指定处理特定异常的方法；
- SimpleMappingExceptionResolver 将异常类名映射为视图名，即发生异常时使用对应的视图报告异常；
