[Spring] SpringMVC 简介（一）

Varitall

已于 2023-10-12 20:07:52 修改

阅读量373

点赞数 2

分类专栏： Spring 文章标签： spring java 后端

于 2023-10-11 20:53:27 首次发布

本文链接：https://blog.csdn.net/joyride_run/article/details/133635596

版权

Spring 专栏收录该内容

15 篇文章 0 订阅

订阅专栏

2、在 web.xml 中配置前端控制器 DispatcherServlet

1、@RequestMapping 注解的功能

2、@RequestMapping 注解的位置

3、@RequestMapping 的 value 属性

4、@RequestMapping 的 method 属性

5、SpringMVC 支持 ant 风格的路径

6、@RequestMapping 中的占位符（@PathVariable 重点）

一、SpringMVC 简介

1、什么是 MVC

记住一句话：SpringMVC 封装了 Servlet。

（1）MVC

M：Model，模型层，指工程中的JavaBean，作用是处理数据

JavaBean分为两类：

一类称为实体类Bean：专门存储业务数据的，如 Student、User 等
一类称为业务处理 Bean：指 Service 或 Dao 对象，专门用于处理业务逻辑和数据访问。

V：View，视图层，指工程中的html或jsp等页面，作用是与用户进行交互，展示数据

C：Controller，控制层，指工程中的servlet，作用是接收请求和响应浏览器

（2）工作流程

用户通过视图层发送请求到服务器，在服务器中请求被 Controller 接收，Controller 调用相应的 Model 层处理请求，处理完毕将结果返回到 Controller，Controller 再根据请求处理的结果找到相应的 View 视图，渲染数据后最终响应给浏览器。

2、什么是 SpringMVC

（1）三层架构

我们通过浏览器访问前端页面，前端页面通过异步提交的方式，发送请求到后端服务器，后端服务器采用 web层（servlet）、业务层（service）、数据层（dao）的三层架构形式进行开发，其中数据的交互使用 json 来传输。

我们最开始在数据层使用的是 Jdbc 技术，而 MyBatis 就是对 Jdbc 技术的又一层封装，也可以称之为数据层框架。
现在所讲的 SpringMVC，在 web 层中与 servlet 的关系，就好比 Jdbc 与 MyBatis 的关系，也就是一个表现层的框架。

（2）SpringMVC 是一种基于 Java 实现 MVC 模型的轻量级 Web 框架

框架：半成品软件，加速开发过程。
相比较 Servlet，使用更简单，开发更便捷，更灵活

3、SpringMVC 实现原理

（1）用户发送请求到前端控制器 DispatcherServlet

DispatcherServlet的作用：接收请求，调用其它组件处理请求，响应结果，相当于转发器、中央处理器，是整个流程控制的中心

（2）DispatcherServlet 收到请求后调用处理器映射器 HandlerMapping

处理器映射器 HandlerMapping 找到 Controller 的具体方法（可以根据 xml 配置或注解进行查找），并将该方法返回给 DispatcherServlet；

（3）DispatcherServlet 调用处理器适配器 HandlerAdapter

（3-1）HandlerAdapter 经过适配调用具体的 Controller 的方法；(Controller--> service --> Dao --> 数据库)

Controller 执行完成后返回 ModelAndView；
Model：模型数据，即 Controller 处理的结果，是一个 Map
View：逻辑视图名，即负责展示结果的 html 页面的名字

（3-2）HandlerAdapter 将 Controller 执行的结果 ModelAndView 返回给 DispatcherServlet

（4）DispatcherServlet 将执行的结果 ModelAndView 传给视图解析器 ViewReslover

视图解析器 ViewReslover 根据逻辑视图 View 解析后返回具体 html 页面

（5）DispatcherServlet 根据 Model 对 View 进行渲染（将模型数据填充至视图中）

DispatcherServlet 将填充了数据的网页响应给用户

4、SpringMVC 的特点

Spring 家族原生产品，与 IOC 容器等基础设施无缝对接
基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行统一处理（不在需要自己编写 Servlet 处理请求）
代码清新简洁，大幅度提升开发效率
内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可
性能卓著，尤其适合现代大型、超大型互联网项目要求

二、简单案例

1、引入依赖

即将使用 Thymeleaf 视图模板技术，因此引入了相关依赖。

<dependencies>
    <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>javax.servlet-api</artifactId>
        <version>3.1.0</version>
        <scope>provided</scope>
    </dependency>
    <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.1</version>
    </dependency>

    <!-- Spring5和Thymeleaf整合包 -->
    <dependency>
        <groupId>org.thymeleaf</groupId>
        <artifactId>thymeleaf-spring5</artifactId>
        <version>3.0.12.RELEASE</version>
    </dependency>
</dependencies>

2、在 web.xml 中配置前端控制器 DispatcherServlet

<servlet>
    <servlet-name>DispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>DispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

（1）标签中使用 / 和 /* 的区别

/：匹配浏览器向服务器发送的所有请求，不包括 jsp；
/*：匹配浏览器向服务器发送的所有请求，包括 jsp；

JSP 是通过 Tomcat 的 JspServlet 来处理的，然后 JspServlet 将响应结果回传给页面，所以 DispatcherServlet 处理不了 jsp 页面。

因此 DispatcherServlet 要使用 /，而不能用 /*。
在使用过滤器时，若需要对所有请求进行过滤，就需要使用 /* 的写法。

3、创建 SpringMVC 的配置文件

（1）SpringMVC 的配置文件的默认地址和名称：

地址：在 WEB-INF 目录下；
名称：<servlet-name>-servlet.xml；（<servlet-name> 是 web.xml 内 DispatcherServlet 的值，比如 DispatcherServlet-servlet.xml）

但实际开发中，通常将 SpringMVC 的配置文件放在 resource 目录下。

（2）Thymeleaf 模板文件路径

物理视图：视图前缀 + 逻辑视图 + 视图后缀；
逻辑视图：把物理视图中的视图前缀和视图后缀去掉，得到的就是逻辑视图；

我们通常在 WEB-INF 目录下建立一个 templates 目录，用来存放视图模板。而访问 WEB-INF 目录下的资源，需要服务器端进行请求转发，所以逻辑视图就被用上了。

（3）配置文件

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

    <!-- 配置Thymeleaf视图解析器 -->
    <bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
        <property name="order" value="1"/> <!-- 优先级 -->
        <property name="characterEncoding" value="UTF-8"/>
        <property name="templateEngine"> <!-- 模板引擎 -->
            <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
                <property name="templateResolver"> <!-- 模板解析器 -->
                    <bean class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
                        <!-- 视图前缀 -->
                        <property name="prefix" value="/WEB-INF/templates/"/>
                        <!-- 视图后缀 -->
                        <property name="suffix" value=".html"/>

                        <!-- 以 html5 作为模板 -->
                        <property name="templateMode" value="HTML5"/>
                        <property name="characterEncoding" value="UTF-8" />
                    </bean>
                </property>
            </bean>
        </property>
    </bean>

</beans>

4、创建请求控制器

（1）@Controller

由于 DispatcherServlet 已经对浏览器发送的请求进行了统一的处理，所以我们不需要自己创建 Servlet 去处理请求。

但是具体的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器。

package com.demo.controller;

import org.springframework.stereotype.Controller;

@Controller
public class HelloController {

}

SpringMVC 的控制器由一个 POJO（普通的Java类）担任，因此需要通过 @Controller 注解将其标识为一个控制层组件，交给 Spring 的 IOC 容器管理，此时 SpringMVC 才能够识别控制器的存在。

（2）@RequestMapping

请求映射：把浏览器发送的请求，映射到具体方法去处理。

（2-1）其中的 value 属性值，填写的是方法的路径：

/：代表该路径为绝对路径；
/ 由服务器解析：代表 http://ip:port/工程名；
/ 由浏览器解析：代表当前服务器路径，http://ip:port；

当 value 的值，与浏览器发送的请求路径是一样的，说明这个方法就是用来处理该请求的方法。

（2-2）方法返回值

前面我们说到，服务器端进行请求转发需要用到逻辑视图，那么怎么用呢？

其实我们返回的字符串，就是所谓的逻辑视图。紧接着 web.xml 中配置的视图解析器，就会将这个返回值用视图前缀和视图后缀组装起来，最终形成了请求转发的地址。

package com.demo.controller;

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

@Controller
public class HelloController {
    @RequestMapping("/")
    public String index() {
        System.out.println("index");
        // 返回逻辑视图
        return "index";
    }

    @RequestMapping("/hello")
    public String hello() {
        return "hello";
    }

}

5、测试页面

注意：测试页面使用了 Thymeleaf 的语法。

（1）index.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1> index 页面 </h1>
    <a th:href="@{/hello}"> 测试 SpringMVC </a>
    <br/>
    <a href="/hello"> 测试绝对路径</a>
</body>
</html>

（2）hello.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <h1> hello </h1>
</body>
</html>

（3）项目结构

6、访问不到 Controller

SpringMVC 访问不到 Controller，网上有很多解决方法，如果再尝试之后都没有办法解决（比如我），那么可以尝试删除当前工件，新建一个该项目的工件。

有关更多项目结构问题，可以查看：https://www.bilibili.com/video/BV1Ry4y1574R?p=15

按照其中的步骤，设置 web 目录即可。

7、修改项目结构

将 DispatcherServlet-servlet.xml 文件，放到 resource 目录下，然后在 web.xml 文件中作如下修改：

<servlet>
    <servlet-name>DispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:SpringMVC.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>DispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

（1）contextConfigLocation

这是正常项目中 Spring 配置文件放置在 resource 目录下的写法。

（2）<load-on-startup>

由于 DispatcherServlet 需要初始化的内容非常地多，因此将其放在服务器启动期间去初始化，可以节省页面访问的时间。

三、@RequestMapping

1、@RequestMapping 注解的功能

@RequestMapping 注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系。
SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。

2、@RequestMapping 注解的位置

@RequestMapping 仅仅标识了方法，那么可以直接访问到这个方法；
@RequestMapping 标识了类，那么想要访问方法，请求路径就必须添加标识类上面写的路径；

如下面代码所示：

@Controller
@RequestMapping("/manager")
public class ManagerController {
    @RequestMapping("/user")
    public String user() {
        return "user";
    }
}

请求路径为：

http://ip:port/工程路径/manager/user

而如果在两个不同的 Controller 里面有相同的 @RequestMapping，那么会直接报错。
但是对于同一个资源，只要请求路径不同，那么就不会报错，比如：/manager/hello 和 /hello，都可以访问到 hello.html。

3、@RequestMapping 的 value 属性

一个 Servlet 可以处理多个请求（在 url-pattern 中设置），同样的，value 属性值为数组的时候，就可以接收多个请求。

@Controller
@RequestMapping("/manager")
public class ManagerController {
    @RequestMapping({"/hello", "/also_hello"})
    public String hello() {
        return "hello";
    }
}

4、@RequestMapping 的 method 属性

method 属性通过请求的请求方式（get 或 post）匹配请求映射。
method 属性是一个 RequestMethod 类型的数组，表示该请求映射能够匹配多种请求方式的请求。

若当前请求的请求地址满足请求映射的 value 属性，但是请求方式不满足 method 属性，则浏览器报错 405。

@RequestMapping(
        value = {"/hello"},
        method = {RequestMethod.GET, RequestMethod.POST}
)
public String hello() {
    return "hello";
}

（1）对于处理指定请求方式的控制器方法，SpringMVC中提供了@RequestMapping的派生注解

处理get请求的映射–>@GetMapping
处理post请求的映射–>@PostMapping
处理put请求的映射–>@PutMapping
处理delete请求的映射–>@DeleteMapping

（2）常用的请求方式有get，post，put，delete

但是目前浏览器只支持 get 和 post，若在 form 表单提交时，为 method 设置了其他请求方式的字符串（put 或 delete），则按照默认的请求方式 get 处理
若要发送 put 和 delete 请求，则需要通过 spring 提供的过滤器 HiddenHttpMethodFilter，在 RESTful 部分会讲到

5、SpringMVC 支持 ant 风格的路径

ant 风格的路径是指：

？：表示任意的单个字符
*：表示任意的0个或多个字符
**：表示任意的一层或多层目录

在 @RequestMapping 中，value 属性值可以包含上面三种格式。

@RequestMapping("/a?a/test/ant")
public String testAnt() {
    return "hello";
}
@RequestMapping("/a?a/*/ant")
public String testAnt2() {
    return "hello";
}
@RequestMapping("**ant")
public String testAnt3() {
    return "hello";
}

以上代码，下面三种请求路径都能访问到 hello.html：

6、@RequestMapping 中的占位符（@PathVariable 重点）

@RequestMapping 修饰的方法想要使用请求参数的方法有很多，其中一种就是在 @RequestMapping 的 value 属性中使用“占位符{ }”。

（1）书写格式

假设请求路径 /func 可以访问到目标方法，通常我们添加参数，请求路径会这么写：

/func?id=1&name=admin

而如果使用 @RequestMapping，那么应该这么写：

/func/1/admin

（2）对应地，在代码中要怎么获取到这两个参数呢？

@RequestMapping("/func/{id}/{name}")
public String func(@PathVariable("id") String id, @PathVariable("name") String name) {
    System.out.println("id: " + id);
    System.out.println("name: " + name);
    return "index";
}

（3）请求路径：

（4）输出结果：

四、SpringMVC 获取请求参数

1、通过 ServletAPI 获取

如果要使用 servlet 相关的方法，那么给方法的参数列表添加 request 等参数即可。

（1）测试代码

（1-1）controller（success.html 可以自己写）

@RequestMapping("/login")
public String login(HttpServletRequest req) {
    System.out.println("username: " + req.getParameter("username"));
    System.out.println("password: " + req.getParameter("password"));
    return "success"; // return 相当于请求转发
}

（1-2）index.html

<form th:action="@{/login}" method="post">
    <input type="text" name="username"/> <br/>
    <input type="password" name="password"/> <br/>
    <input type="submit" value="submit"/>
</form>

（2）输出结果

2、通过设置方法形参名与请求参数名一致

在控制器方法的形参位置，设置和请求参数同名的形参，当浏览器发送请求，匹配到请求映射时，在DispatcherServlet中就会将请求参数赋值给相应的形参。

（1）测试代码

（1-1）controller

@RequestMapping("/login/param")
public String loginParam(String username, String password) {
    System.out.println("username: " + username);
    System.out.println("password: " + password);
    return "success";
}

（1-2）index.html（改了 action）

<form th:action="@{/login/param}" method="post">
    <input type="text" name="username"/> <br/>
    <input type="password" name="password"/> <br/>
    <input type="submit" value="submit"/>
</form>

（2）输出结果

（3）@RequestParam

如果在请求参数名和方法参数名不一致，那么就会导致方法获取不到值，值为 null。

为了保证一定能获取到对应值，可以使用 @RequestParam：

public String loginParam(@RequestParam(value = "username", required = true) String username, String password)

value = "userName"：设置从 userName 请求参数获取值，并且方法参数名不再需要与请求参数名一致；
required = true：设置没有该请求参数，则不能发送请求；（默认就是 true）
required = false：设置可以不传该请求参数，若不传递，则值为 null；
defaultValue：设置未传递参数时的默认值；（与 required 无关）

（4）@RequestHeader

将请求头信息与控制器方法的参数进行绑定，当为方法参数加上 @RequestHeader，那么该参数就不再对应请求参数，而是对应请求头信息。

用法与 @RequestParam 一致。

@RequestMapping("/login/param")
public String loginParam(@RequestParam(value = "username") String name,
                         String password,
                         @RequestHeader(value = "referer") String refer) {
    System.out.println("username: " + name);
    System.out.println("password: " + password);
    System.out.println("referer: " + refer);
    return "success";
}

（5）@CookieValue

将 cookie 数据与控制器方法的参数进行绑定，因为一开始还没有 JSESSIONID 的 cookie，因此需要先调用一次 request.getSession() 来创建 JSESSIONID 的 cookie。

用法与 @RequestParam 一致。

@RequestMapping("/login")
public String login(HttpServletRequest req) {
    HttpSession session = req.getSession();
    System.out.println("创建 JSESSIONID: " + session.getId());
    return "index"; // return 相当于请求转发
}

@RequestMapping("/login/param")
public String loginParam(@RequestParam(value = "username") String name,
                         String password,
                         @RequestHeader(value = "referer") String refer,
                         @CookieValue(value = "JSESSIONID") String sessionId) {
    System.out.println("username: " + name);
    System.out.println("password: " + password);
    System.out.println("referer: " + refer);
    System.out.println("JSESSIONID: " + sessionId);
    return "success";
}

（5-1）先访问 /login，使服务器创建 JSESSIONID

（5-2）输入 username、password，点击登录，观察控制台输出

3、通过 POJO 获取请求参数

通常情况下，我们会有非常多的方法参数需要设置/获取请求参数值，如果都用 @RequestParam 这几个注解来获取，也非常麻烦。

（1）解决方法

我们可以用一个 pojo 类当作方法的参数，让这个 pojo 类的成员变量名，与请求参数名一致，就可以将请求参数值，封装到 pojo 类的成员变量。

@RequestMapping("/login/pojo")
public String pojo(User user) {
    System.out.println(user);
    return "success";
}

（2）输出结果

4、解决中文乱码

因为没有 request 和 response，所以无法用这两个变量设置。

并且就算使用 request 和 response，其实也无法设置，因为其他参数都是已经从请求中获取到了，再设置也没有用了。

注意：

Tomcat 7.0 的 get 和 post 请求都有乱码；Tomcat 8.0 以上 get 请求没有乱码，post 请求会乱码。

（1）解决方法

解决获取请求参数的乱码问题，可以使用 SpringMVC 提供的编码过滤器 CharacterEncodingFilter，再所有 servlet 处理之前，拦截所有请求，然后设置编码。

需要注意的是，CharacterEncodingFilter 必须在 web.xml 中进行注册：

init-param 设置 encoding = utf-8，相当于 request.CharacterSetEncoding("UTF-8")；
init-param 设置 forceEncoding = true，会把 request 和 response 都设置成 encoding（前面那个）；

（2）web.xml 配置文件

<!--配置springMVC的编码过滤器-->
<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceResponseEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

（3）输出结果

Varitall

关注

2
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
[Spring] SpringMVC 简介（一）

SpringMVC 封装了 Servlet。（1）MVCM：Model，模型层，指工程中的JavaBean，作用是处理数据一类称为实体类Bean：专门存储业务数据的，如 Student、User 等一类称为业务处理 Bean：指 Service 或 Dao 对象，专门用于处理业务逻辑和数据访问。V：View，视图层，指工程中的html或jsp等页面，作用是与用户进行交互，展示数据C：Controller，控制层，指工程中的servlet，作用是接收请求和响应浏览器（2）工作流程。
复制链接

扫一扫