Spring框架-6（SpringMvc)

Spring系列文章

Spring框架-1(基础)
Spring框架-2(IOC上)
Spring框架-3(IOC下)
Spring框架-4(AOP)
Spring框架-5(JDBC模板&Spring事务管理)
Spring框架-6（SpringMvc)
Spring框架-7（搭建SSM）
Spring框架-8（SpringMVC2）

在不懂javaWeb前，一直听到做javaWeb的朋友们说什么ssm，ssh。今天这篇文章就主要讲解ssm中的一个s-->SpringMvc。

先看下这篇文章的结构：

导航.png
入门程序.png
SpringMvc架构.png

先附上Demo地址

SpringMvc介绍

SpringMvc是什么？

介绍

1. 总所周知Mvc是我们再开发中常用的架构，无论是再web开发还是其他开发都非常常见，springMvc是依赖与Sping对webMvc封装的一个框架。使用springMvc开发十分的简洁的快速。

2. Spring web mvc和Struts2都属于表现层的框架,它是Spring框架的一部分,我们可以从Spring的整体结构中看得出来：

   
   Spring结构.png

   springMvc:是一个表现层框架
   作用:就是从请求中接收传入的参数,将处理后的结果数据返回给页面展示

SpringMvc处理流程

处理流程.png

入门程序

使用IDEA创建一个Spring+SpingMvc+web工程

创建.png

创建好了以后，打开project
structure你会发现有两个问题，这个地方应该是IDEA创建问题，你运行起来，这里还有两个jar包没有加入到tomcat中。所以运行就会报错。我们需要解决这两个问题就好了

创建后的问题.png

创建测试controller

创建一个controller然后指定hello的请求。返回一段字符串。

@Controller
public class TestController {

    @RequestMapping("/hello")//注解为控制器指定可以处理哪些 URL 请求
    @ResponseBody//
    public String firstTest() {
        return "hello world";
    }
    
}

配置前端控制器和SpringMvc配置文件

web.xml是项目创建后自动生成的文件，配置Springmvc的核心控制器

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <!-- 如果没有指定springMvc核心配置文件那么默认会去找/WEB-INF/+<servlet-name>中的内容 +   -servlet.xml配置文件 -->
    <!-- 指定springMvc核心配置文件位置 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>
    <!-- spirngMvc前端控制器 -->
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- tomcat启动的时候就加载这个servlet -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <!-- spirngMvc拦截.action结尾的请求 -->
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>*.action</url-pattern>
    </servlet-mapping>
</web-app>

配置springmvc我们需要配置两个核心类 注解的处理器映射器 和 注解的处理器适配器，你可以手动配置，但是一般都是直接配一个注解驱动。注解驱动等于自动配置好了注解处理器映射器，注解处理器适配器

<?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.xsd http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--Spring注解扫描-->
    <context:component-scan base-package="com.zhong.demo1"/>

    <!-- 配置springmvc我们需要配置两个核心类 注解的处理器映射器 和 注解的处理器适配器-->
    <!-- 注解的处理器映射器 -->
    <!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"></bean> -->
    <!-- 注解的处理器适配器 -->
    <!--<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"></bean> -->
    <!-- 配置springmvc我们需要配置两个核心类 注解的处理器映射器-->

    <!-- 注解驱动:作用:替我们自动配置最新版的注解的处理器映射器和处理器适配器-->
    <mvc:annotation-driven/>
</beans>

运行测试

到这里我们就配置好Tomcat直接运行起来。然后访问http://localhost:8080/hello.action

结果浏览器页面显示出：hello world  

注意：由于我们再前面配置了spirngMvc拦截.action。所以我们的请求必须在后面加上.action

到这里我们的入门程序就完成了。

分析

以上出现的注解

@Controller 负责注册一个bean 到spring 上下文中

@RequestMapping 注解为控制器指定可以处理哪些 URL 请求

SpringMvc常用注解

• @Controller

负责注册一个bean 到spring 上下文中

• @RequestMapping

注解为控制器指定可以处理哪些 URL 请求,
该注解支持URI模板变量中使用正则表达式。语法是{varName:regex}，其中第一部分定义了变量名，第二 部分就是你所要应用的正则表达式。比如下面的代码样例

@RequestMapping("/spring-web/{symbolicName:[a-z-]+}-{version:\\d\\.\\d\\.\\d}{extension:\\.[a-z]+}") 
public void handle(@PathVariable String version, @PathVariable String extension) { 
// 代码部分省略... 
}

当一个URL同时匹配多个模板（pattern）时
URI模板变量的数目和通配符数量的总和最少的那个路径模板更准确.
如果两个模板的URI模板数量和通配符数量总和一致，则路径更长的那个模板更准确。
如果两个模板的数量和长度均一致，则那个具有更少通配符的模板是更加准确的

• @RequestBody

该注解用于读取Request请求的body部分数据，使用系统默认配置的HttpMessageConverter进行解析，然后把相应的数据绑定到要返回的对象上 ,再把HttpMessageConverter返回的对象数据绑定到 controller中方法的参数上.

• @ResponseBody

该注解用于将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区, 会根据HTTP请求头的contentType或者appect的内容自动转换返回类型,例如xml或者json.
用此注解或者ResponseEntity等类似类, 会导致response header含有accept-charset这个字段,而这个字段对于响应头是没有用的,以下方法可以关掉

<mvc:annotation-driven>
        <mvc:async-support default-timeout="3000"/>
        <!-- utf-8编码 -->
        <mvc:message-converters register-defaults="true">
            <bean class="org.springframework.http.converter.StringHttpMessageConverter">
                <constructor-arg value="UTF-8"/>
                <property name="writeAcceptCharset" value="false"/>
            </bean>
        </mvc:message-converters>
    </mvc:annotation-driven>

• @ModelAttribute

在方法定义上使用 @ModelAttribute 注解：Spring MVC 在调用目标处理方法前，会先逐个调用在方法级上标注了@ModelAttribute 的方法。在方法的入参前使用 @ModelAttribute 注解：可以从隐含对象中获取隐含的模型数据中获取对象，再将请求参数 –绑定到对象中，再传入入参将方法入参对象添加到模型中

• @RequestParam

在处理方法入参处使用 @RequestParam 可以把请求参 数传递给请求方法

• @CookieValue

关于Coookie的注解, 类似,肯定还有关于session的注解.

• @PathVariable

绑定 URL 占位符到入参, 例如

@RequestMapping(value = "/person/profile/{id}")  
public String porfile(@PathVariable("id") int uid) { ... }

• @ExceptionHandler

注解到方法上，出现异常时会执行该方法

• @ControllerAdvice

使一个Contoller成为全局的异常处理类，类中用@ExceptionHandler方法注解的方法可以处理所有Controller发生的异常

SpringMvc架构

架构结构图

SpringMvc详细框架结构.png

架构流程

1. 用户发送请求至前端控制器DispatcherServlet
2. DispatcherServlet收到请求调用HandlerMapping处理器映射器。
3. 处理器映射器根据请求url找到具体的处理器，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet。
4. DispatcherServlet通过HandlerAdapter处理器适配器调用处理器
5. 执行处理器(Controller，也叫后端控制器)。
6. Controller执行完成返回ModelAndView
7. HandlerAdapter将controller执行结果ModelAndView返回给DispatcherServlet
8. DispatcherServlet将ModelAndView传给ViewReslover视图解析器
9. ViewReslover解析后返回具体View
10. DispatcherServlet对View进行渲染视图（即将模型数据填充至视图中）。
11. DispatcherServlet响应用户

组件说明

1. DispatcherServlet：前端控制器

用户请求到达前端控制器，它就相当于mvc模式中的c，dispatcherServlet是整个流程控制的中心，由它调用其它组件处理用户的请求，dispatcherServlet的存在降低了组件之间的耦合性。

2. HandlerMapping：处理器映射器

HandlerMapping负责根据用户请求找到Handler即处理器，springmvc提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。

3. Handler：处理器

Handler 是继DispatcherServlet前端控制器的后端控制器，在DispatcherServlet的控制下Handler对具体的用户请求进行处理。

由于Handler涉及到具体的用户业务请求，所以一般情况需要程序员根据业务需求开发Handler。

4. HandlAdapter：处理器适配器

通过HandlerAdapter对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。

5. View Resolver：视图解析器

View Resolver负责将处理结果生成View视图，View Resolver首先根据逻辑视图名解析成物理视图名即具体的页面地址，再生成View视图对象，最后对View进行渲染将处理结果通过页面展示给用户。

6. View：视图

springmvc框架提供了很多的View视图类型的支持，包括：jstlView、freemarkerView、pdfView等。我们最常用的视图就是jsp。
一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。

注解映射器和适配器

组件扫描器

使用组件扫描器省去在spring容器配置每个controller类的繁琐。使用<context:component-scan>自动扫描标记@controller的控制器类，配置如下：

<!-- 扫描controller注解,多个包中间使用半角逗号分隔 -->
<context:component-scanbase-package="com.zhong.demo1"/>

RequestMappingHandlerMapping 注解式处理器映射器

注解式处理器映射器，对类中标记@ResquestMapping的方法进行映射，根据ResquestMapping定义的url匹配ResquestMapping标记的方法，匹配成功返回HandlerMethod对象给前端控制器，HandlerMethod对象中封装url对应的方法Method。

从spring3.1版本开始，废除了DefaultAnnotationHandlerMapping的使用，推荐使用RequestMappingHandlerMapping完成注解式处理器映射。

配置如下：

<!--注解映射器 -->
    <beanclass="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping"/>

注解描述：

@RequestMapping：定义请求url到处理器功能方法的映射

RequestMappingHandlerAdapter处理器适配器

注解式处理器适配器，对标记@ResquestMapping的方法进行适配。

从spring3.1版本开始，废除了AnnotationMethodHandlerAdapter的使用，推荐使用RequestMappingHandlerAdapter完成注解式处理器适配。

配置如下：

<!--注解适配器 -->
    <beanclass="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter"/>

<mvc:annotation-driven> 自动配置最新版的注解的处理器映射器和处理器适配器

springmvc使用<mvc:annotation-driven>自动加载RequestMappingHandlerMapping和RequestMappingHandlerAdapter，可用在springmvc.xml配置文件中使用<mvc:annotation-driven>替代注解处理器和适配器的配置。

视图解析器

在springmvc.xml文件配置如下：

<beanclass="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <propertyname="viewClass"
            value="org.springframework.web.servlet.view.JstlView"/>
        <propertyname="prefix"value="/WEB-INF/jsp/"/>
        <propertyname="suffix"value=".jsp"/>
    </bean>

InternalResourceViewResolver：支持JSP视图解析
viewClass：JstlView表示JSP模板页面需要使用JSTL标签库，所以classpath中必须包含jstl的相关jar 包。此属性可以不设置，默认为JstlView。
prefix 和suffix：查找视图页面的前缀和后缀，最终视图的址为：

前缀+逻辑视图名+后缀，逻辑视图名需要在controller中返回ModelAndView指定，比如逻辑视图名为hello，则最终返回的jsp视图地址 “WEB-INF/jsp/hello.jsp”