SpringMVC笔记（一）：导入部分与请求参数的获取

*Soo_Young*

于 2023-10-12 15:23:56 发布

阅读量172

点赞数 7

文章标签：笔记 java web spring mvc

本文链接：https://blog.csdn.net/weixin_74895237/article/details/133791670

版权

一、SpringMVC 框架简介

1.什么是 MVC

MVC（Model-View-Controller）是一种软件设计模式，它将应用程序的控制逻辑、数据和表示逻辑分离，以便于管理、测试和扩展。
在MVC模式中，应用程序通常被划分为三个部分：模型（Model）、视图（View）和控制器（Controller）。

模型：模型是应用程序中的数据和业务逻辑。它处理应用程序中的数据，并响应控制器的请求。
视图：视图是应用程序中的用户界面。它将模型的数据呈现给用户，并接收用户的输入。
控制器：控制器是应用程序中的逻辑控制部分。它接收用户的输入，并调用模型和视图来处理请求。

通过将应用程序的控制逻辑、数据和表示逻辑分离，MVC模式可以使应用程序更易于管理、测试和扩展。例如，可以独立地修改模型、视图和控制器，而不会影响到其他部分。此外，MVC模式还可以提高应用程序的可重用性和可维护性。

1）JavaBean：

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

2）MVC 的工作流程

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

3）我们为什么需要 SpringMVC？

Spring MVC（Spring Web MVC）是Spring框架中的一个模块，它提供了一种基于MVC（Model-View-Controller）设计模式的、请求驱动类型的、轻量级Web框架。Spring MVC的主要功能包括：

分离了控制器（Controller）、模型（Model）和视图（View）的职责，使得应用程序更易于管理、测试和扩展。
提供了强大的数据绑定功能，可以将请求参数绑定到模型对象上。
提供了强大的URL映射功能，可以根据URL来匹配控制器的方法。
提供了强大的视图解析功能，可以将模型数据解析成视图。
提供了强大的错误处理功能，可以自定义错误页面。

Spring MVC是一种轻量级的Web框架，它的设计目标是简单、易用和可扩展。Spring MVC非常适合构建复杂的Web应用程序，特别是那些需要处理大量请求的Web应用程序。

二、框架引入

1.开发环境

IDE：idea 2019.2
构建工具：maven3.5.4
服务器：tomcat7
Spring版本：5.3.1

2.创建一个 Maven 工程

Maven是一种软件项目管理工具，它提供了一种集中式的、一致的、可重复的构建过程。Maven的主要功能包括：

提供了一个项目对象模型（Project Object Model，POM）来描述项目的信息，包括项目的目标、依赖项、构建步骤等。
提供了一个项目生命周期（Project Lifecycle）来定义项目构建过程中的各个阶段和步骤，包括编译、测试、部署等。
提供了一个仓库（Repository）来管理项目的依赖项，可以自动下载和更新依赖项。
提供了一个插件系统（Plugin System）来扩展Maven的功能，可以自定义构建过程和任务。

Maven是一种强大的项目管理工具，它可以极大地提高开发效率和代码质量。Maven可以帮助开发人员进行代码版本控制、依赖项管理、构建自动化等任务，从而更好地管理复杂的项目。

先创建一个 web 模块
- 在 main 包下面创建一个文件夹，取名为 webapp
- 在项目结构的部署描述符中加入 Web 木块部署描述符

配置 maven 工程的依赖和打包方式

在 pom.xml 中添加依赖

<dependencies>
    <!-- SpringMVC -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>5.3.1</version>
    </dependency>

    <!-- 日志 -->
    <dependency>
        <groupId>ch.qos.logback</groupId>
        <artifactId>logback-classic</artifactId>
        <version>1.2.3</version>
    </dependency>

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

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

设置打包方式

<!--在 version 标签下面添加一个 packaging 标签来输入打包方式-->
    <artifactId>SpringMVC_demo01</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>

注：由于 Maven 的传递性，不必将所有需要的包全部配置依赖，而是配置最顶端的依赖，其他靠传递性导入。

3.配置 web.xml

先来总结一下 web.xml 文件中可以配置什么内容（不需要全部掌握）

Web应用程序的名称和描述
Web应用程序的ContextPath
Web应用程序的监听器（Listener）
Web应用程序的Servlet和Servlet Mapping
Web应用程序的Filter和Filter Mapping
Web应用程序的Multipart解析器
Web应用程序的Welcome文件
Web应用程序的错误页面
Web应用程序的安全管理器

之前在开发 JavaWeb 的时候，很多 servlet 要自己去写，但是 SpringMVC 引入了中央控制器，DispatcherServlet，我们只需要配置这一个 servlet 就可以实现接受客户端发送的请求并且集中处理。

1）配置中央处理器与 SpringMVC 项目的配置文件的位置

maven 工程中的项目配置文件都是在 resource 下统一管理的，因此需要调整配置文件的位置，其次，由于其核心组件的性质，会有大量的初始化工作要做，所以将其初始化的工作放在服务器启动时，否则会大大影响第一次响应的速度。

<!-- 配置SpringMVC的前端控制器，对浏览器发送的请求统一进行处理 -->
<servlet>
    <servlet-name>springMVC</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <!-- contextConfigLocation为固定值 -->
        <param-name>contextConfigLocation</param-name>
        <!-- 使用classpath:表示从类路径查找配置文件，例如maven工程中的src/main/resources -->
        <param-value>classpath:springMVC.xml</param-value>
    </init-param>
    <!-- 
 		作为框架的核心组件，在启动过程中有大量的初始化操作要做
		而这些操作放在第一次请求时才执行会严重影响访问速度
		因此需要通过此标签将启动控制DispatcherServlet的初始化时间提前到服务器启动时
	-->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>springMVC</servlet-name>
    <!--
        设置springMVC的核心控制器所能处理的请求的请求路径
        /所匹配的请求可以是/login或.html或.js或.css方式的请求路径
        但是/不能匹配.jsp请求路径的请求
    -->
    <url-pattern>/</url-pattern>
</servlet-mapping>

注：

<url-pattern>标签中使用/和/*的区别：

/所匹配的请求可以是/login或.html或.js或.css方式的请求路径，但是/不能匹配.jsp请求路径的请求

因此就可以避免在访问jsp页面时，该请求被DispatcherServlet处理，从而找不到相应的页面

/*则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用/*的写法

4.创建请求控制器

虽然前端控制器对接受来的请求做了统一的处理，但不同的请求是由不同的业务处理流程的，因此需要创建具体处理需求的类，即请求控制器，控制器需要指定自己处理的请求和其他信息。
因为 SpringMVC 的控制器是由一个普通的 Java 类来担任的，因此需要通过 @Controller 注解将其标识为一个控制组件，将其交给 SpringIoC 的容器来管理，这时候 SpringMVC 才能识别到控制器的存在。

// 先将其交给 IoC 管理，设置具体接收请求的在后面进行
@Controller
public class HelloController {}

5.创建 SpringMVC 的配置文件

还是先来看 SpringMVC 配置文件中可以配置的内容

SpringMVC 的组件扫描：可以通过扫描指定的包或类来自动创建SpringMVC的控制器、服务和数据访问对象等组件。
SpringMVC 的数据源配置：可以配置数据源的连接池、驱动程序、URL、用户名和密码等属性。
SpringMVC 的视图解析器配置：可以配置视图解析器的前缀、后缀、视图名称、模板路径等属性。
SpringMVC 的错误处理配置：可以配置错误处理的错误码、错误页面、错误消息等属性。
SpringMVC 的静态资源处理配置：可以配置静态资源的映射、缓存、内容类型等属性。
SpringMVC 的AOP配置：可以配置AOP的切面、连接点、通知、引入、环绕等属性。
SpringMVC 的事务管理配置：可以配置事务管理器、事务定义、事务属性等属性。

<!-- 自动扫描包 -->
<context:component-scan base-package="com.atguigu.mvc.controller"/>

<!-- 配置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"/>
                    <property name="templateMode" value="HTML5"/>
                    <property name="characterEncoding" value="UTF-8" />
                </bean>
            </property>
        </bean>
    </property>
</bean>

视图前缀和视图后缀：
视图前缀是指模板文件的名称前面的部分，它通常用于标识模板文件的源位置或模板文件的类型。例如，如果视图前缀为“/WEB-INF/views/”，则模板文件的名称可能为“/WEB-INF/views/home.html”。
视图后缀是指模板文件的名称后面的部分，它通常用于标识模板文件的文件扩展名。例如，如果视图后缀为“.html”，则模板文件的名称可能为“home.html”。
因为存放于 WEB-INF 是不能也不需要让用户直接访问到的，且通过客户端重定向也无法访问到，因此我们使用 ThymeLeaf 负责视图的渲染和跳转。

6.测试 HelloWorld

1）实现对首页的访问

在请求控制器中设置请求方法

// @RequestMapping注解：处理请求和控制器方法之间的映射关系
// @RequestMapping注解的value属性可以通过请求地址匹配请求，/表示的当前工程的上下文路径
// localhost:8080/springMVC/
@RequestMapping("/")
public String index() {
    //设置视图名称
    return "index";
}

2）通过超链接实现页面的跳转

在 index.html 中设置超链接

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
    <h1>首页</h1>
    <a th:href="@{/hello}">HelloWorld</a><br/>
</body>
</html>

使用 th:href=“@{/hello}” 会自动填充上下文，在Spring 中，当HTML页面中的标签使th:href="@{/hello}"时，会将此标签的href属性设置为服务器的URL+“/hello”，并在点击该标签时，将浏览器的URL设置为服务器的URL+“/hello”，服务器的 url 可以在 tomcat 的配置中查看。

3）在处理器中处理请求

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

这个 target 经过视图处理的渲染后将转到 /WEB-INF/templates/target.html 页面

三、@RequestMapping

@RequestMapping 注解是 Spring MVC 中一个非常重要的注解，用于定义请求映射，即将URL与Controller的方法进行映射。，可以用于定义 HTTP 请求的映射，例如 GET、POST、PUT、DELETE等，也可以用于定义HTTP方法之外的其他HTTP方法，例如OPTIONS、TRACE等。

1.@RequestMapping注解的位置

通过查看源码可以发现，这个注解可以放在类上也可以放在类方法上。
@Target({ElementType.TYPE, ElementType.METHOD})
标识一个类：设置映射请求的请求路径的初始信息
标识一个方法：设置映射请求请求路径的具体信息

2.@RequestMapping 的属性

1）value 属性

value属性通过请求的请求地址匹配请求映射，value 是一个字符串类型的数组，可以在里面防止多个请求地址，表示该请求映射能够匹配多个请求地址所对应的请求，这个属性必须设置，至少通过请求地址匹配请求映射。

@RequestMapping(
        value = {"/testRequestMapping", "/test"}
)
public String testRequestMapping(){
    return "success";
}

这就表示可以通过两个请求地址来访问这个方法。

2）method 属性

method属性通过请求的请求方式（get或post）匹配请求映射
method属性是一个RequestMethod类型的数组，表示该请求映射能够匹配多种请求方式的请求
若当前请求的请求地址满足请求映射的value属性，但是请求方式不满足method属性，则浏览器报错405：Request method ‘POST’ not supported，进一步限制了请求的信息。

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

根据这些属性，RequestMapping 还有一些派生的注解

处理get请求的映射–>@GetMapping

处理post请求的映射–>@PostMapping

处理put请求的映射–>@PutMapping

处理delete请求的映射–>@DeleteMapping

3）@RequestMapping注解的params属性（了解）

4）@RequestMapping注解的headers属性（了解）

5）SpringMVC 支持 ant 风格的路径

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

注意：在使用**时，只能使用 /**/xxx 的方式，这两个星号前后是不能有元素的，否则会被认为是普通的星号。

6）SpringMVC支持路径中的占位符（重点）

原始方式：/deleteUser?id=1
rest方式：/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，就可以在相应的 @RequestMapping 注解的 value 属性中通过占位符{xxx}表示传输的数据，在通过@PathVariable注解，将占位符所表示的数据赋值给控制器方法的形参。

@RequestMapping("/testRest/{id}/{username}")
public String testRest(@PathVariable("id") String id, @PathVariable("username") String username){
    System.out.println("id:"+id+",username:"+username);
    return "success";
}
//最终输出的内容为-->id:1,username:admin

在 RequestMapping 中这样写，可以再去解析传进来的 id 和 username，然后在下面配合 PathVariable 注解来获取到需要的元素。

四、SpringMVC获取请求参数

在 SpringMVC 由于 DispacherServlet 的存在，获取请求参数的方法不只是使用 Servlet 的 API，还有了更多其他更简单的方法。

1.通过ServletAPI获取

通过 getParameter 的方法去从 request 中拿取参数，是较为原始的方法

@RequestMapping("/testParam")
public String testParam(HttpServletRequest request){
    String username = request.getParameter("username");
    String password = request.getParameter("password");
    System.out.println("username:"+username+",password:"+password);
    return "success";
}

2.通过控制器方法的形参请求参数

在控制器方法的形参位置，设置和请求参数同名的形参，注意名称必须相同，但是数据类型不一定为字符串，中央控制器会对其做集中处理。当浏览器发送请求，匹配到请求映射时，在DispatcherServlet 中就会通过反射等操作将请求参数赋值给相应的形参，无需我们自己获取。

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

如果传入的是多个同名的请求参数，比如复选框中的选项就有多个参数会返回，这样我们可以在方法的参数列表中设置数组或者字符串去接收数据。
设置的是数组则每个下标标识一个数据，设置的是字符串则接收多个数据，中间用逗号隔开。

3.@RequestParam

这个标签可以对传入的参数进行判断或者设置默认值，或者对参数和传入的参数做映射关系处理。

通过查看源码发现：@RequestParam 总共有三个参数：
```
    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

    String defaultValue() default "\n\t\t\n\t\t\n\ue000\ue001\ue002\n\t\t\t\t\n";
```
value 指定为参数赋值的属性名称

required：默认是 true，表示这个参数必须传入值，否则会报错

defaultValue：是设置如果没有传入值的默认值，如果有该属性则即使没有传入参数也不会报错

4、@RequestHeader

@RequestHeader是将请求头信息和控制器方法的形参创建映射关系

@RequestHeader注解一共有三个属性：value、required、defaultValue，用法同@RequestParam

5、@CookieValue

@CookieValue是将cookie数据和控制器方法的形参创建映射关系

@CookieValue注解一共有三个属性：value、required、defaultValue，用法同@RequestParam

6.通过 pojo 来获取参数

可以在接收参数的位置设置一个实体的变量来接收参数，数据库一个表中也可以有一个对象来接受，此时如果服务器传进来的值与这个实体的属性相同的情况下，会自动为其赋值。

@RequestMapping("/testpojo")
public String testPOJO(User user){
    System.out.println(user);
    return "success";
}
//最终结果-->User{id=null, username='张三', password='123', age=23, sex='男', email='123@qq.com'}

7.解决中文请求乱码的问题

请求乱码的根本原因就是字符编码的不符合，回顾我们在写 SpringMVC 配置文件设置的内容时，我们需要提前设置请求的编码，那么比中央控制器更早接触到 request 的是什么？是过滤器 filter ，我们可以通过配置编码过滤器的方式去设置编码。

<!--配置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>