SpringMVC - 入门篇

SpringMVC - 入门篇

---

---

1 入门程序

1.1 创建Maven项目

创建项目并补齐目录结构

1.2 pom.xml文件添加依赖和插件

<packaging>war</packaging>

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.2.13.RELEASE</version>
    </dependency>
    <!-- springmvc底层还是servlet，所以必须添加servlet依赖 -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>4.0.0</version>
        <!-- 插件运行的时候没有范围插件启动会失败 -->
        <scope>provided</scope>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.0</version>
	          <!-- 编码和编译和JDK版本 -->
            <configuration>
                <target>1.8</target>
                <source>1.8</source>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.tomcat.maven</groupId>
            <artifactId>tomcat7-maven-plugin</artifactId>
            <version>2.2</version>
            <configuration>
                <path>/</path>
                <port>8080</port>
            </configuration>
        </plugin>
    </plugins>
</build>

1.3 创建Spring和SpringMVC的配置文件

• 我们一般将除了Controller之外的所有Bean注册到Spring容器中，而将Controller注册到SpringMVC容器中。所以我们在resources目录下添加applicationContext.xml作为spring的配置，添加springmvc.xml作为SpringMVC的配置文件。

1.3.1 创建Spring配置文件applicationContext.xml文件

<?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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       https://www.springframework.org/schema/context/spring-context.xsd">

    <!-- Spring配置文件：除了控制器之外的Bean对象都在这里扫描 -->
    <context:component-scan base-package="com.murphy.dao,com.murphy.service"/>

</beans>

1.3.2 创建SpringMVC的配置文件springmvc.xml

<?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
       https://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       https://www.springframework.org/schema/mvc/spring-mvc.xsd">

    <!-- SpringMVC的配置文件：控制器的Bean对象都在这里扫描 -->
    <context:component-scan base-package="com.murphy.controller"/>

    <mvc:annotation-driven/>

    <!-- 配置视图解析器 -->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

1.4 在web.xml中进行Spring和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_4_0.xsd"
         version="4.0">

    <!-- Spring配置 -->
    <context-param>
        <!-- 用以说明Spring配置文件的位置 -->
	      <!-- contextConfigLocation：表示用于加载Bean的配置文件 -->
        <param-name>contextConfigLocation</param-name>
      	<!-- 
						 指定spring配置文件的位置
						 这个配置文件也有一些默认规则，它的配置文件名默认就叫applicationContext.xml，
						 如果将这个配置文件放在 WEB-INF 目录下，那么这里就可以不用 指定配置文件位置， 只需要指定监听器就可以。
             这段配置是Spring集成Web环境的通用配置；
						 一般用于加载除控制器层的Bean(如 dao、service等)，以便于与其他任何Web框架集成。
				-->
        <param-value>classpath:applicationContext.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

    <!-- SpringMVC的前端/核心/中央控制器 -->
  	<!--
				前端控制器：所有的请求都会经过此控制器，然后通过此控制器分发到各个分控制器
				前端控制器本质上还是一个Servlet，因为SpringMVC底层就是使用Servlet编写的
		-->
    <servlet>
        <servlet-name>dispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <!-- 默认查询 dispatcherServlet-servlet.xml，所以需要指定classpath -->
          	<!-- 创建前端控制器的时候读取springmvc配置文件启动ioc容器 -->
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <!-- 1 - 立即创建，数字越小，优先级越大 ｜ 小于1，现用现创建 -->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcherServlet</servlet-name>
      	<!-- 配置拦截路径url，所有以.do结尾的请求都会被前端控制器拦截处理 -->
        <url-pattern>*.do</url-pattern>
    </servlet-mapping>
</web-app>

<!-- 
SpringMVC的配置解析:
1. servlet-class:前端控制器的完全限定名，在spring-webmvc-5.2.5.RELEASE.jar包中的org.springframework.web.servlet下
2. load-on-startup:标记是否在Web服务器(这里是Tomcat)启动时会创建这个 Servlet 实 例，即是否在 Web 服务器启动时调用执行该 Servlet的init()方法，而不是在真正访问时才创建。 要求取值是整数。
		值大于0：表示容器在启动时就加载并初始化这个servlet，数值越小，该Servlet的优先级就越高，其被创建的也就越早
		值小于0或者省略：表示该Servlet在真正被使用时才会去创建。
	  值相同：容器会自己选择创建顺序
3. url-pattern:可以写为 /，可以写为*.do、*.action、*.mvc等形式，此处先写*.do，以后介绍不同写法的区别。 
4. init-param:表示了springmvc配置文件的名称和位置。
		如果没有配置，默认在项目的WEB-INF目录下找名称为Servlet名称-servlet.xml的配置文件。 
		如果没有配置，启用默认的规则:即如果配置文件放在 webapp/WEB-INF/ 目录下，并且配置文件的名字等于DispatcherServlet的名字+ -servlet(即这里的配置文件路径是 webapp/WEB-INF/dispatcherServlet-servlet.xml)，如果是这样的话，可以不用添加 init-param 参数，即不用手动配置 springmvc 的配置文件，框架会自动加载。
		而一般情况下，配置文件是放在类路径下，即 resources 目录下。所以，在注册前端控制器时， 还需要设置查找 SpringMVC 配置文件路径。
		其中contextConfigLocation属性:来自DispatcherServlet的父类FrameworkServlet，该类中的contextConfigLocation属性用来配置springmvc的路径和名称。
-->

1.5 创建控制器

/**
 * Controller
 *
 * @author murphy
 */
@Controller
public class UserController {

    @Autowired
    private UserService userService;

    @RequestMapping("/first.do")
    public ModelAndView add() {
        System.out.println("UserController - add---");
        userService.add();
        ModelAndView mv = new ModelAndView();
        // 相当于 request.setAttribute("","")
        mv.addObject("userName","murphy");
        // 未来经过SpringMVC的视图解析器处理，然后转换成物理资源路径，相当于 request.getDispatcher("index.jsp").forward(req,resp)
        mv.setViewName("index");
        // 经过InternalResourceViewResolver对象的处理之后加上前后缀就变为了 /jsp/index.jsp
        return mv;
    }
}

/**
 * Service
 *
 * @author murphy
 */
@Service
public class UserService {

    public void add() {
        System.out.println("UserService - add---");
    }
}

1.6 配置视图解析器

在springmvc.xml配置文件中添加视图解析器的配置

<!-- SpringMVC的配置文件：控制器的Bean对象都在这里扫描 -->
<context:component-scan base-package="com.murphy.controller"/>

<mvc:annotation-driven/>

<!-- 配置视图解析器 -->
<bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/jsp/"/>
    <property name="suffix" value=".jsp"/>
</bean>
<!--
annotation-driven是一种简写形式，也可以手动配置替代这种简写形式，简写形式可以让初学者快速应用默认配置方案。
该注解会自动注册DefaultAnnotationHandlerMapping与AnnotationMethodHandlerAdapter两个bean，是springMVC为@Controller分发用户请求所必须的，解决了@Controller注解使用的前提配置。 
同时它还提供了:数据绑定支持，@NumberFormatannotation支持，@DateTimeFormat支持，@Valid支持，读写XML的支持(JAXB，读写JSON的支持(Jackson)。
我们处理响应ajax请求时，就使用到了对json的支持(配置之后，在加入了jackson的core和mapper包之后，不写配置文件也能自动转换成json)。 
-->

1.7 编写index.jsp页面

webapp文件夹下面创建文件夹jsp，然后jsp文件夹中添加index.jsp页面

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>index</title>
</head>
<body>
    <h1>index - ${userName}</h1>
</body>
</html>

1.8 测试

Maven 配置 Tomcat 的运行方式：

将刚刚的地址复制到浏览器之后追加控制中add方法的访问路径first.do，看到如下页面表示运行成功！

1.9 解析

• 当 Spring 和 SpringMVC 同时出现，我们的项目中将存在两个容器，一个是Spring容器，另一个是SpringMVC容器，Spring容器通过 ContextLoaderListener来加载，SpringMVC容器则通过DispatcherServlet来加载，这两个容器不一样：

如图所示：

• ContextLoaderListener初始化的上下文加载的Bean是对于整个应用程序共享的，不管是使用什么表现层技术，一般如dao层、service层的bean；
• DispatcherServlet初始化的上下文加载的Bean是只对Spring Web MVC有效的 bean，如Controller、HandlerMapping、HandlerAdapter等等，该初始化上下文应该只加载Web相关组件。

1. Spring容器中不能扫描所有Bean嘛？
	 不可以。当用户发送的请求达到服务端后，会寻找前端控制器DispatcherServlet去处理，只在SpringMVC容器中找，所以Controller必须在SpringMVC容器中扫描。
2. SpringMVC容器中可以扫描所有Bean嘛？
	 可以。可以在SpringMVC容器中扫描所有Bean。但是实际开发中一般不会这么做，原因如下：
   (1)为了方便配置文件的管理
   (2)未来在 Spring+SpringMVC+Mybatis 组合中，要写的配置内容很多，一般都会根据功能分开编写

---