初识Spring MVC并使用Maven搭建SpringMVC

原 作者 李猛 | 发表于 | 分类于 2016级

Spring MVC基于MVC模式（模型(Model)-视图(View)-控制器(Controller)）实现，能够帮助你构建像Spring框架那样灵活和松耦合的Web应用程序。

核心类与接口

  • DispatcherServlet 前置控制器
  • HandlerMapping 处理器映射
  • Controller 控制器
  • ViewResolver 视图解析器
  • View 视图处理

Spring MVC的请求流向

myMVC

  1. 当用户在浏览器中点击链接或提交表单的时候，就会产生HttpRequest。
  2. 请求首先会来到DispatcherServlet，DispatcherServlet会查询一个或多个处理器映射来确定将该请求发给哪一个控制器，根据请求所携带的URL信息来进行决策。如果没有找到合适的控制器，通过defaultHandler返回Response给浏览器。
  3. 在对应的控制器中，控制器开始处理请求、创建模型数据并将模型数据打包并标示出用于渲染输出的View名称，接着把模型和视图名发送回DispatcherServlet。
  4. DispatcherServlet使用视图解析器将控制器返回的视图名匹配为一个特定的而视图实现，并将模型数据传递给该视图。
  5. 视图使用模型数据进行渲染，并把视图传给DispatcherServlet。
  6. DispatcherServlet将视图作为HttpResponse响应给浏览器。

使用Maven搭建Spring MVC

  1. 在IDEA中使用Maven建立一个webapp，并完成基本配置，这里不在详细说明。（不会参照我的博文：在Linux的IEDA下用Maven建立简单的Web程序 ）
  2. 配置pom.xml文件，在<dependencies>标签中添加如下配置：
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>

    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>

    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>

    <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>jsp-api</artifactId>
      <version>2.1</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context</artifactId>
      <version>5.0.5.RELEASE</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.0.5.RELEASE</version>
    </dependency>

接下来我们建立一个基于Spring MVC的helloworld。

首先，有两种方式来配置Spring MVC

方法一：使用XML来配置

配置web.xml

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

        <display-name>HelloWorldSpring</display-name>

        <servlet>
            <servlet-name>spring-mvc</servlet-name>
            <servlet-class>
                org.springframework.web.servlet.DispatcherServlet
            </servlet-class>
            <load-on-startup>1</load-on-startup>
        </servlet>

        <servlet-mapping>
            <servlet-name>spring-mvc</servlet-name>
            <url-pattern>/</url-pattern>
        </servlet-mapping>

        <!-- Other XML Configuration -->
        <!-- Load by Spring ContextLoaderListener -->
        <context-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>/WEB-INF/root-context.xml</param-value>
        </context-param>


        <!-- Spring ContextLoaderListener -->
        <listener>
            <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
        </listener>
</web-app>

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

    <context:component-scan base-package="org.Xiyou"/>

    <context:annotation-config/>

    <bean
            class="org.springframework.web.servlet.view.InternalResourceViewResolver">

        <property name="prefix">
            <value>/</value>
        </property>

        <property name="suffix">
            <value>.jsp</value>
        </property>
    </bean>

</beans>

配置root-context.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">

    <!-- Empty -->

</beans>

方法二：使用JavaConfig来配置

创建配置类

HelloWorldConfiguration.java

package org.XiyouLinux.configuration;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.ViewResolver;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.view.InternalResourceViewResolver;
import org.springframework.web.servlet.view.JstlView;

@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "org.XiyouLinux")
public class HelloWorldConfiguration {
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver viewResolver = new InternalResourceViewResolver();
        viewResolver.setViewClass(JstlView.class);
        viewResolver.setPrefix("/WEB-INF/views/");
        viewResolver.setSuffix(".jsp");

        return viewResolver;
    }

}

HelloWorldInitializer.java

package org.XiyouLinux.configuration;

import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;

public class HelloWorldInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

    @Override
    protected Class<?>[] getRootConfigClasses() {
        return new Class[] { HelloWorldConfiguration.class };
    }

    @Override
    protected Class<?>[] getServletConfigClasses() {
        return null;
    }

    @Override
    protected String[] getServletMappings() {
        return new String[] { "/" };
    }

}

最后创建控制器和视图

创建Controller来处理相应的请求的

package org.Xiyou;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorldController {

    @RequestMapping("/hello")
    public String hello(Model model) {

        model.addAttribute("greeting", "Hello Spring MVC, I am so tired to do this !");

        return "helloworld";//标示用于渲染输出的视图名

    }

}

创建helloworld.jsp来渲染model

<%@ page language="java" contentType="text/html; charset=UTF-8"  pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <title>Spring4 MVC -HelloWorld</title>
</head>
<body>
<h1 align="center"> ${greeting}</h1>
</body>
</html>

测试

sucess

若遇到一些问题请检查

  1. JDK版本与Spring版本是否匹配
    JDK版本与Spring
    error
    选择降低JDK版本，或者用更高版本的Spring。而且不要在一个pom.xml中出现不同版本的Spring，即只可以有一个版本的Spring依赖。

  2. 是否在pom.xml中缺少相关依赖

如缺少jstl
error
找不到JSTL库中类，即有可能没有添加jstl，加上即可

    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>

参考

  1. Spring实战(第4版)
  2. Spring官方网站
  3. Spring MVC易百教程