Spring MVC使用入门级SSM框架整合

前言&准备

SpringMVC是一套轻量级web开发框架，可以容易的和Spring整合，简单易用，其底层依然基于Servlet。使用SpringMVC之前，首先需要引入相关的Jar包，这里使用Maven包管理工具实现。

需要的Jar包

<dependencies>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.1.9.RELEASE</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>servlet-api</artifactId>
            <version>2.5</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet.jsp</groupId>
            <artifactId>jsp-api</artifactId>
            <version>2.2</version>
        </dependency>
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>jstl</artifactId>
            <version>1.2</version>
        </dependency>
    </dependencies>

引入之后为项目添加框架支持

添加框架支持
配置本地tomcat

配置本地tomcat
将项目中用到的依赖添加到WEB-INF/lib下

image.png

使用SpringMVC

在真正使用SpringMVC框架开发之前，先回忆一下，在JavaWeb中，我们利用Servlet进行开发，只要编写好一个实现Servlet接口的类，实现对应的方法，然后在web.xml配置好<servlet>和<servlet-mapping>后，访问特定路经，请求就会自动跳转到其对应的Servlet进行处理，这样其实也不算复杂，但是随着需求的增加，就需要配置大量的Servlet，为此SpringMVC给我们提供了一个好的解决方法，它内置了一个DispatcherServlet类,其继承结构如下

DispatcherServlet

可以看到其本质还是一个Servlet，但是它并不直接处理业务逻辑，而是提供一个转发功能，为某个url下的所有子路径，找到一个对应的处理对象中某个处理方法，而这个处理对象，我们将其以Bean的形式加入Spring容器中，由Spring容器托管。因此配置SpringMVC的核心，就是配置这个DispatcherServlet和Spring的容器。

在web.xml中配置DispatcherServlet

<?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">
    <servlet>
        <servlet-name>springmvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-servlet.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>springmvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

可以看见我们现在只需要配置一个DispatcherServlet即可，<url-pattern>/<url-pattern>指明了匹配除了静态资源以为的所有请求，也就是说现在所有的请求都由SpringMVC框架来管理。重点关注DispatcherServlet 种的contextConfigLocation参数，由于所有进行实际请求处理的controller（即MVC模式中的控制器层）都会被注入一个Spring容器中，contextConfigLocation便指明了这个Spring容器配置文件的路径，我们可以通过注解或xml的方式把Controller注入到容器中。

配置springmvc-servlet.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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
    <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"></bean>
    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"></bean>
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>
    <bean id="/hello" class="com.spmvc.controller.HelloController">
    </bean>
</beans>

这里需要关注的地方有2点，一个是InternalResourceViewResolver（内置视图解析器），在非前后端分离的模式下，通常controller会返回一个String，我们要做的是将其转化成对应的视图名称，InternalResourceViewResolver配置了前缀/WEB-INF/jsp/，和后缀.jsp,当Controller返回一个hello字符串时，该视图解析器会将其转换成/WEB-INF/jsp/hello.jsp，然后SpringMVC框架会去把这个位置的资源返回给游览器。BeanNameUrlHandlerMapping是一个在非注解形式下才会用到的Bean，收到的请求url和配置在该容器中对应id的Controller匹配，假若我们这里访问localhost:8080/hello，则就会匹配到 id=/hello的HelloController。

以非注解的形式编写一个Controller

public class HelloController implements Controller {
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        ModelAndView modelAndView = new ModelAndView();
        modelAndView.addObject("msg", "HelloWorld");
        modelAndView.setViewName("hello");
        return modelAndView;
    }
}

这种方式不经常使用，主要是实现一个Controller接口，其中方法会返回一个ModelAndView对象，这个对象包含了2大部分内容，即视图的名称，比如xxx.jsp还有需要传递的数据（以键值对的形式存在)。

WEB-INF/jsp/hello.jsp

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

利用注解配置`Controller`

之前实现Controller接口的方式和Servlet似乎大同小异，但是如果使用注解就方便多了。

利用注解配置

@Controller
public class HelloController {
    @RequestMapping("/hello")
    public String hello(Model model){
        model.addAttribute("msg", "Hello world~!");
        return "hello"; // 被view解析器处理
    }
}

只要在一个类上添加@Controller便可以，然后在具体方法上添加@RequestMapping("/hello")表明所有访问/hello的请求都会被该方法处理，也就是说从原来的一个请求对应一个实现类，变成一个请求对应一个方法。Model是一个Springmvc管理的类，通过对其设置键值对的方式可以传递数据给对应的view,光有注解不够，我需要配置Spring容器来扫描识别注解

配置springmvc-servlet.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">
    
    <context:component-scan base-package="com.spmvc.controller"></context:component-scan>
    <mvc:default-servlet-handler/>
    <mvc:annotation-driven/>

    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

</beans>

至此，就可以简单的使用SpringMVC框架了。