四、Spring——Spring MVC

时间：2024-01-18 00:05:20

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 将异常类名映射为视图名，即发生异常时使用对应的视图报告异常；

相关文章