2. SpringMVC

1. SpringMVC介绍

1.1 简介

• 传统处理请求的方式需要实现Servlet接口或继承HTTPServlet，SpringMVC通过一套MVC注解，让POJO（普通Java对象）称为处理请求的控制器，无须实现任何接口
• SpringMVC支持REST风格的URL请求
• SpringMVC所有的功能都是由组件完成的，比其他MVC框架更具扩展性和灵活性

1.2 基本使用步骤

• 导入相关依赖，相较于Spring要多导入spring-web、spring-webmvc
• 在web.xml中配置DispatcherServlet（前端控制器），指定SpringMVC配置文件所在位置，以及前端控制器的拦截范围
• 拦截范围使用/和/*都是拦截所有请求，/*还会拦截*.jsp请求，一旦拦截jsp页面就无法显示
• Tomcat的xml文件中配置的JspServlet会处理*.jsp和*.jspx文件（项目中的xml配置会继承Tomcat中的xml配置）
• Tomcat的xml文件中配置的DefaultServlet会处理静态资源（除jsp和servlet以外的所有资源都是静态资源），DefaultServlet的路径是/，若SpringMVC的前端控制器也使用/拦截请求，静态资源将无法访问（如html页面）

<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        // 设置SpringMVC配置文件所在位置&文件名，默认为：前端控制器名-servlet.xml
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    // 服务器启动时创建对象，值越小优先级越高
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    // 设置拦截器拦截的请求范围
    <url-pattern>/</url-pattern>
</servlet-mapping>

• 在SpringMVC的配置文件中配置视图解析器，对业务方法返回的字符串进行前后拼接

<context:component-scan base-package="hello"></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>

• 编写处理请求的处理器，并进行标识，/表示从当前项目开始，可以省略

@Controller
public class HelloWorld {
    @RequestMapping("/hello")
    public String hello() {
        System.out.println("hello!");
        // 经过拼接后转发到view目录下的success.jsp页面
        return "success";
    }
}

• 编写页面视图

1.3 SpringMVC执行流程

• 客户端点击链接发送请求
• 来到Tomcat服务器
• SpringMVC前端控制器收到所有请求
• 根据请求地址查看与@RequestMapping的哪个标注匹配，找到对应类中的方法
• 通过反射执行该方法，方法的返回值根据SpringMVC配置文件进行拼串
• 前端控制器将请求转发到拼串后的地址

2. SpringMVC请求和响应

2.1 @RequestMapping映射请求
2.1.1 通过URL映射请求

• @RequestMapping注解指定控制器可以处理哪些URL请求，可在类或方法上标注
• 在类上标注时，提供初步的请求映射信息，相对于WEB应用的根目录
• 在方法上标注时，提供进一步细分的映射信息
• DispatcherServlet截获请求后，通过控制器上@RequestMapping提供的映射信息确定请求对应的处理方法

2.1.2 @RequestMapping中的其他参数

• @RequestMapping中的value、method、params、heads参数分别表示：请求URL、请求方式（GET或POST）、请求参数、请求头的映射条件
• params和heads支持简单的表达式。param1表示必须包含名为param1的请求参数，!param1表示不能包含名为param1的请求参数
• 参数的值支持Ant风格的通配符：① ? 匹配文件名中的一个字符；② * 匹配文件名中任意字符；③ ** 匹配多层路径

2.2 获取请求数据
以下注解都是放在业务方法的形参前，获取请求中的数据并传入该形参，供方法使用：

• @PathVariable获取URL上的占位符

@RequestMapping("/pathVariable/{id}")
public String pathVariable(@PathVariable("id") Integer id) {
    System.out.println(id);
    return "success";
}

• @RequestParam获取请求参数：该注解中的value为请求参数名；required表示该参数是否必需，默认为true；defaultValue 设置请求参数的默认值

@RequestMapping("/requestParam")
public String requestParam(@RequestParam(value = "id", required = false, defaultValue = "0") int id) {
    System.out.println("requestParam:" + id);
    return "success";
}

• @RequestHeader获取请求头信息：请求头包含了若干属性，服务器可通过该注解获取客户端中某个请求头的属性值
• @CookieValue获取请求中的某个cookie值
• 使用POJO对象作为形参：如果请求参数是POJO，SpringMVC会按照请求参数名和形参对象的属性名进行自动匹配（此时形参前没有注解），自动为该对象填充属性值，且支持级联属性
• 使用Servlet API作为形参：可以直接将Servlet的原生API作为形参传入方法，可以传入的类型有：HttpServletRequest、HttpServletResponse、HttpSession、java.security.Principal、Locale、InputStream、OutputStream、Reader、Writer

解决数据乱码：

• GET请求乱码：在Tomcat的server.xml文件中，在8080端口所在的标签中加入URIEncoding=“UTF-8”
• POST请求乱码：在第一次获取请求参数之前设置request.setCharacterEncoding(“UTF-8”)。有些方法没有获取请求参数，可以用一个Filter设置编码，SpringMVC提供了CharacterEncodingFilter用于设置编码，该Filter需要在xml文件中最先配置
• 响应乱码：SpringMVC提供的Filter同样可以解决响应乱码

<filter>
    <description>字符编码过滤器</description>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    // 解决Post请求乱码
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    // 解决响应乱码
    <init-param>
        <param-name>forceEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

2.3 处理响应数据
除了在业务方法形参传入request和session外，SpringMVC还提供了以下几种途径输出响应数据：

• ModelAndView：当业务方法返回值类型为ModelAndView时，方法体可通过该对象添加Map类型数据，添加的数据会存入request域中
• Model、ModelMap、Map：当形参为这3中类型时，方法返回时，Map中的数据会自动添加到request域中
• @SessionAttributes：在类上使用该注解可以临时给Session域中保存数据，以便多个请求之间可以共享该属性。该注解的value属性会把request域中指定的key-value在Session域中也放一份（该注解只能在类上使用，可能产生异常，尽量不用）
• @ModelAttribute：方法上加该注解后，该方法会在所有业务方法之前执行，且将该方法的返回值放入Map中，可通过注解的value属性指定key，若没有指定则以返回值类型首字母小写为key。形参上加该注解后，会从request域中取出key对应的对象（有MyBatis后弃用）

@Controller
@RequestMapping("/mvc")
@SessionAttributes(value = {"name"})
public class HelloWorld {
    @ModelAttribute
    public void getUser(Map<String, Object> map) {
        User user = new User(1, "Jerry", "eat");
        map.put("user", user);
    }

    @RequestMapping("/modelAndView")
    public ModelAndView modelAndView(Map<String, String> map, @ModelAttribute("user") User user) {
        System.out.println(user);
        map.put("name", "Mary");
        ModelAndView modelAndView = new ModelAndView("success");
        modelAndView.addObject("time", new Date());
        return modelAndView;
    }
}

2.4 业务方法传入POJO类型的形参

• 确定key值：若形参上加了@ModelAttribute注解，则以注解中的值为key；否则以类名首字母小写作为key
• 在request域中查找是否有该key，若有则将key对应的value赋值给POJO对象，若没有则到session域中查找
• 若session域中有该key，则将key对应的value赋值给POJO对象，若没有则通过反射创建POJO对象，且将对应的key-value存入request域
• 通过反射将请求传递过来的参数使用POJO中对应的set方法给对象的属性赋值

3. SpringMVC执行细节

3.1 请求处理的流程

• DispatcherServlet收到所有请求，调用doDispatch()方法进行以下处理
• getHandler()方法根据当前请求地址，在HandlerMapping中找到能处理这个请求的目标方法处理器类（Handler）/控制器（Controller）
• getHandlerAdapter()方法根据当前处理器类获取到能执行这个处理器方法的适配器（Adapter）
• 使用获取到的适配器执行目标方法
• 目标方法执行后返回一个ModelAndView对象
• 根据ModelAndView的信息转发到具体的页面，并可以在请求域中取出模型数据

3.2 SpringMVC的9大组件
DispatchServlet中有9个引用类型的属性，称为SpringMVC的组件，SpringMVC在工作时，关键位置由这些组件完成。9大组件都是接口，在ioc容器启动时初始化：

• MultipartResolver：文件上传解析器
• LocaleResolver：区域信息解析器（国际化）
• ThemeResolver：主题解析器（主题效果更换）
• List<HandlerMapping>：Handler映射信息
• LIst<HandlerAdapter>：Handler适配器
• List<HandlerExceptionResolver>：异常解析器
• RequestToViewNameTranslator：将目标方法返回值转为ModelAndView
• FlashMapManager：运行重定向携带数据的功能
• List<ViewResolver>：视图解析器

4. REST

4.1 介绍

• REST即表现层状态转化（Representational State Transfer），是目前最流行的一种互联网软件架构
• 以前对服务器中的资源进行CRUD操作需要不同的地址，REST风格中对相同资源进行CRUD操作时URL地址相同，仅改变请求方式
• HTTP协议中，四种请求方式对应四种基本操作：GET获取资源、POST新建资源、PUT更新资源、DELETE删除资源

4.2 使用
浏览器的form表单只支持GET和POST请求，Spring中有一个过滤器HiddenHttpMethodFilter可以将其他类型的请求转为标准的Http方法：

• 在web.xml中配置HiddenHttpMethodFilter

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

• 使用表单发送请求时，添加一行：<input type="hidden" name="_method" value="delete">

<form action="mvc/rest/1" method="post">
    <input type="hidden" name="_method" value="delete">
    <input type="submit" value="rest delete">
</form>

• 在接收请求的方法上加上注解

@RequestMapping(value = "/rest/{id}", method = RequestMethod.DELETE)
public String rest(@PathVariable("id") Integer id) {
    System.out.println("delete" + id);
    return "success";
}

5. 视图解析

5.1 视图和视图解析器

• 业务方法执行完后，无论返回的是什么类型数据，SpringMVC内部都会将其装配成一个ModelAndView对象，该对象包含了逻辑名和模型对象的视图
• SpringMVC框架中有两个重要的接口：View（视图）和ViewResolver（视图解析器）
• 视图的作用是渲染数据，将模型里的数据以某种形式呈现出来，所有类型的视图都要实现View接口
  
• 视图解析器负责将逻辑视图解析为一个具体的视图对象，所有的视图解析器都必须实现ViewResolver接口。所有配置好的视图解析器都会尝试根据视图名得到视图对象，若能得到就返回，否则换下一个进行解析，通过视图解析器的order属性指定解析顺序
  
• SpringMVC借助视图解析器得到最终的视图对象，最终的视图可以是JSP、Excel、JFreeChart等各种表现形式

5.2 注意事项

• 若项目中使用了JSTL，则SpringMVC会自动把视图由InternalResourceView 转为JstlView
• 若使用JSTL的<fmt>标签，则需要在SpringMVC的配置文件中配置国际化资源文件

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

• 若想直接通过链接到达页面，而不经过业务方法（不使用Controller），需要在SpringMVC配置文件中对直达的链接进行以下配置

<mvc:view-controller path="/success" view-name="success"/>
<mvc:annotation-driven></mvc:annotation-driven>

• 一般情况下，业务方法返回字符串类型的值会被当做逻辑视图名处理。若返回的字符串前缀为“forward:”或“redirect:”时，SpringMVC对前缀后的字符串进行转发或重定向操作