SpringMVC教程(万字图文全面详解)

SpringMVC定义

Spring MVC是一个Java框架，用于构建Web应用程序，遵循Model-View-Controller设计模式。

 

SpringMVC模型

Spring MVC 基于 MVC 模式，如下图所示：

1.模型(Model)：模型封装了数据及对数据的操作，可以直接对数据库进行访问。

2.视图(View)：只负责展示，没有具体的程序逻辑。

3.控制器(Controller)：用于控制程序的流程，将模型中的数据展示到视图中。

 

SpringMVC核心组件

SpringMVC五大组件，如下图所示：

1.前端控制器 DispatcherServlet：DispatcherServlet本质上是一个Servlet，相当于一个中转站，所有的访问都会走到这个Servlet中。

2.处理器映射器 HandlerMapping：HandlerMapping本质上就是一段映射关系。

3.处理器适配器 HandlerAdapter：本质上是一个适配器，可以根据要求找到对应的Handler来运行。

4.视图解析器(ViewResolver)：前端控制器调用处理器适配完成后得到model和view，将view信息传给视图解析器得到真正的view。

5.视图渲染(View)：实现类支持不同的View类型（jsp、freemarker、pdf…）。

SpringMVC五大组件关系如下图所示：

 

SpringMVC入门案例

1.创建工程

在idea中从原型创建Maven工程，选择org.apache.maven.archetypes:maven-archetype-webapp，如下图所示：

在pom.xml中添加如下的坐标：

<!-- 版本锁定 -->
<properties>
    <spring.version>5.2.6.RELEASE</spring.version>
</properties>
<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency>
    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

2.创建源码和配置文件目录

在src/main目录下创建java和resources两个目录，java目录用来存放Java源码，resources用来存放配置文件。

这样创建的目录是普通目录，编译时不能被正确识别，此时还需要进行如下操作：

• 在java目录上右键–>Make Directory as–>Sources root；
• 在resources目录上右键–>Make Directory as–>Resources Root；

设置好后，目录会变成如下形式：

3.编写SpringMVC的配置文件

在resources目录下新建springmvc.xml,详细配置如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       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
                http://www.springframework.org/schema/mvc
                http://www.springframework.org/schema/mvc/spring-mvc.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context.xsd">
    <!-- 配置spring创建容器时要扫描的包 -->
    <context:component-scan base-package="org.codeaction"></context:component-scan>
    <!-- 配置视图解析器 -->
    <bean id="viewResolver"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>
    <!-- 配置spring开启注解mvc的支持-->
    <mvc:annotation-driven></mvc:annotation-driven>
</beans>

4.配置核心控制器

在web.xml中配置如下：

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >

<web-app>
  <display-name>Archetype Created Web Application</display-name>
  <!-- SpringMVC的核心控制器 -->
  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置Servlet的初始化参数，读取springmvc的配置文件，创建spring容器 -->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 配置servlet启动时加载对象 -->
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

5.编写控制器类

ackage org.codeaction.controller;

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

@Controller
public class HelloController {
    @RequestMapping("/hello")
    public String hello() {
        System.out.println("hello...");
        return "success";
    }
}

6.编写相关页面

index.jsp，在webapp目录下

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<body>
<h2>Hello World!</h2>
<a href="${pageContext.request.contextPath}/hello">to hello</a>
</body>
</html>

这里有一个超链接，用来访问控制器类。

在WEB-INF目录下创建pages目录，编写success.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>success</title>
</head>
<body>
Hello World!
</body>
</html>

7.启动服务器测试

在idea中配置tomcat服务器，运行。

在地址栏输入http://localhost:8080/start/index.jsp，点击弹出页面中的超链接，页面显示Hello World!。

 

SpringMVC常用注解

1.@Controller注解

一个类上添加@Controller注解，表明了这个类是一个控制器类，类似Struts2中的Action。

在SpringMVC 中控制器Controller 负责处理由DispatcherServlet 分发的请求，它把用户请求的数据经过业务处理层处理之后封装成一个Model ，然后再把该Model 返回给对应的View 进行展示。

如下所示：

@Controller
public class UserCotroller {
  ......
}

 

2.@RestController注解

RestController注解可以直接返回一个对象，配合fastjson，可以将对象转换为json字符串返回给前端。

具体示例如下：

@RestController
@RequestMapping("/user")
public class UserController {

    @RequestMapping("/test")
    public Map addGoodsToCartList(Long itemId, Integer num) {
           Map map = new HashMap();
           map.put("success", true);
           map.put("message", "welcome");
           return map;
    }
}

 

3.@requestParam注解

@requestParam主要用于在SpringMVC后台控制层获取参数，类似一种是request.getParameter(“name”)。

用 @RequestParam 绑定 HttpServletRequest 请求参数到控制器方法参数，即在处理方法入参处使用该注解，可以把请求参数传递给请求方法。

如下所示：

@RequestMapping ( "requestParam" )
public String testRequestParam( @RequestParam(required=false) String name, @RequestParam ( "age" ) int age) {
return "requestParam" ;
}

在上面代码中利用@RequestParam 从HttpServletRequest 中绑定了参数name 到控制器方法参数name ，绑定了参数age 到控制器方法参数age 。

它有三个常用参数：defaultValue = “0”, required = false, value = “isApp”

• defaultValue：表示设置默认值；
• required：通过boolean设置是否是必须要传入的参数；
• value ：表示接受的传入的参数类型；

 

4.@RequestMapping注解

在SpringMVC 中使用 @RequestMapping 来映射请求，也就是通过它来指定控制器可以处理哪些URL请求，相当于Servlet中在web.xml中配置。

如下所示：

package com.springmvc.helloworld_1;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping(value="/example")
public class HelloWorld {
    
    @RequestMapping("/helloworld")
    public String hello(){
        System.out.println("hello world");
        
        return "success";
    }
}

上面代码在类定义处指定映射为”/example”，在hello()方法处指定为”/helloworld”，那么hello()方法的URL映射地址为：

http://localhost:8080/springMVC/example/helloworld

如果去掉类定义处的@RequestMapping(value=”/example”)，那么hello()方法的映射地址就变为了：

http://localhost:8080/springMVC/helloworld

 

5.@PathVariable注解

用于将请求URL中的模板变量映射到功能处理方法的参数上，即取出URL模板中的变量作为参数。

如下所示：

RequestMapping("user/get/mac/{macAddress}")

public String getByMacAddress(@PathVariable String macAddress){

　　//do something;

　　}

@PathVariable 绑定URL占位符到，比如：上面的例子绑定就是macAddress这个入参。

6.@ResponseBody注解

@responseBody注解的作用是将controller的方法返回的对象通过适当的转换器转换为指定的格式之后，写入到response对象的body区，通常用来返回JSON数据或者是XML数据。

具体示例如下：

@Controller
public class HelloWorld {
    @RequestMapping("/hello")
    @ResponseBody
    public String testSpringBoot() {
        return "Hello SpringBoot 2 !";
    }
}

 

SpringMVC工作原理

SpringMVC工作原理，一图胜千言，如下图示：

• DispatcherServlet 控制器入口 负责分发请求
• HandlerMapping 负责根据请求 找到对应的控制器
• Controller 真正处理请求的控制器
• ModelAndView 封装数据信息和视图信息的
• ViewResolver 视图处理器 通过处理找到对应的页面

一言概之，request请求到中央控制器——>传到映射处理器——>转发到指定controller——>获取数据和view ，组成成ModelAndView组件——>通过ViewResolver返回到特定的前台页面。

关于mikechen

mikechen睿哥，10年+大厂架构经验，资深技术专家，就职于阿里巴巴、淘宝、百度等一线互联网大厂。

关注「mikechen」公众号，获取更多技术干货！