SpringMVC Day02 : 请求方式

前言

欢迎阅读 Spring MVC 系列教程的第二篇文章！在上一篇文章中，我们介绍了 Spring MVC 的基本概念和使用方法。今天，我们将深入探讨 Spring MVC 中不同的请求方式，以及如何在你的应用程序中正确地处理它们。

在 Web 开发中，客户端向服务器发送请求时，可以使用不同的请求方式来表达不同的操作意图。常见的请求方式包括 GET、POST、PUT、DELETE 等。每种请求方式都有其特定的语义和用途，因此在开发过程中，我们需要根据实际需求选择合适的请求方式，并在服务器端进行相应的处理。

Spring MVC 提供了强大而灵活的机制来处理各种类型的请求方式。无论你是构建一个简单的表单提交页面还是创建一个 RESTful API，Spring MVC 都能够满足你的需求。在本文中，我们将详细介绍 Spring MVC 中处理不同请求方式的方法，并提供实际示例来帮助你更好地理解和应用这些概念。

如果你是一个初学者，或者对 Spring MVC 的请求方式处理机制感到困惑，别担心！本文将从基础知识开始，逐步引导你了解每种请求方式的特点和用途。我们将涵盖 GET 和 POST 请求的处理，以及如何通过注解和配置文件来定义请求映射和处理方法。

一、前期准备

1、新建项目，结构如下

2、添加依赖

    <dependencies>
    
        <!-- springmvc 依赖，会将spring的核心包一并添加进来 -->
        <!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-webmvc</artifactId>
            <version>5.3.23</version>
        </dependency>
     
 
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.30</version>
        </dependency>
 
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.4.5</version>
        </dependency>
 
 
 
    </dependencies>

3、在 jsp 包下新建一个 index.jsp 页面


<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<h1>welcome to springmvc</h1>
</body>
</html>

简单的输出一句话即可。

4、配置 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">

    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <!-- 所有的请求都经过核心控制器，但是不处理 static 是无感知的 -->
        <url-pattern>/</url-pattern>
    </servlet-mapping>

</web-app>

通过以上配置，当有请求到达应用的根路径时，DispatcherServlet 将会接收到该请求，并根据配置的映射规则将请求分发给相应的 Controller 进行处理。这样就实现了请求的转发和处理。

需要注意的是，这段配置只是 Spring MVC 的一部分，还需要进一步配置和编写 Controller等组件来完整地搭建一个可用的 Spring MVC 应用。

5、新建 dispatcher-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="edu.nf.ch02"/>
    <!-- 启用注解处理器 -->
    <mvc:annotation-driven/>
    <!-- 视图解析器 -->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <property name="suffix" value=".jsp"/>
    </bean>

</beans>

这是一个典型的 Spring MVC 配置文件，它使用 XML 格式来定义 Spring MVC 的相关配置。让我逐行解释一下每个元素的作用：

context、mvc：命名空间的别名，简化了后续元素的引用。
<context:component-scan>：指定要扫描的基础包路径，用于自动注册 Spring Bean。
<mvc:annotation-driven>：启用注解处理器，用于处理带有注解的控制器类和方法。
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">：定义视图解析器，用于将逻辑视图名解析为具体的视图对象。
prefix 属性：指定 JSP 文件的前缀路径，通常是 /WEB-INF/jsp/。
suffix 属性：指定 JSP 文件的后缀，通常是 .jsp。

通过这个配置文件，Spring MVC 将能够自动扫描指定包路径下的控制器类，并根据注解进行请求映射和处理。同时，它还配置了视图解析器，使得在控制器方法中返回的逻辑视图名能够正确解析为对应的 JSP 视图。

二、get 请求，使用 `@RequestMapping 注解`

1、在 controller 包下，新建一个 RequestMapController 控制器


@Controller
public class RequestMapController {

    @RequestMapping(value = "/getUser")
    public ModelAndView getUser() {
        return new ModelAndView("index");
    }

}

具体来说，这段代码的作用如下：

@Controller 注解标识这个类是一个控制器类，它告诉 Spring 这个类需要被扫描和管理。

@RequestMapping 注解用于将请求映射到处理方法上。在这里，value = "/getUser" 表示当请求路径为 "/getUser" 时，会调用该方法进行处理。你可以根据实际需求修改映射的路径。

getUser() 方法返回一个 ModelAndView 对象，用于指定要渲染的视图和模型数据。在这里，new ModelAndView("index") 表示要渲染名为 "index" 的视图。你可以根据实际需求修改要返回的视图名称。

通过以上代码，当有请求路径为 "/getUser" 的请求到达时，Spring MVC 将会调用 getUser() 方法进行处理，并将返回的视图名称 "index" 渲染给客户端。

2、`@RequestMapping 注解的第二种使用方式`

@Controller
public class RequestMapController {

    @RequestMapping(value = "/getUser", method = RequestMethod.GET)
    public ModelAndView getUser() {
        return new ModelAndView("index");
    }

}

通过添加 method = RequestMethod.GET 参数，进一步限定了请求的 HTTP 方法为 GET。

具体来说，这段代码的作用如下：

@RequestMapping 注解用于将请求映射到处理方法上。在这里，value = "/getUser" 表示当请求路径为 "/getUser" 时，会调用该方法进行处理。

method = RequestMethod.GET 参数指定了请求的 HTTP 方法为 GET。这意味着只有使用 GET 方法发送的请求才会被映射到该方法进行处理，其他 HTTP 方法（如 POST、PUT、DELETE 等）的请求将不会被处理。

通过以上代码，当有使用 GET 方法请求路径为 "/getUser" 的请求到达时，Spring MVC 将会调用相应的处理方法进行处理。

需要注意的是，RequestMethod.GET 是一个枚举类型，它定义了多种 HTTP 方法，包括 GET、POST、PUT、DELETE 等。你可以根据实际需求选择适合的方法。

3、运行结果

启动 jetty 服务器

启动服务器后，输入控制器的配置的 /getUser 回车访问，即可调用 getUser 方法，ModelAndView就会将返回的视图名称 "index" 渲染给客户端。

三、post 请求，使用 @RequestMapping 注解

1、第一种写法

 @RequestMapping(value = "/login")
    public ModelAndView login() {
        return new ModelAndView("index");
    }

当客户端发送到 "/login" 路径的请求时，将会调用 login() 方法进行处理，并返回一个名为 "index" 的视图进行渲染。

2、第二种写法

 @RequestMapping(value = "/login", method = {RequestMethod.POST, RequestMethod.GET})
    public ModelAndView login() {
        return new ModelAndView("index");
    }

login() 方法可以处理两种请求方式：POST 和 GET。

RequestMethod.POST 表示该方法可以处理 HTTP POST 请求。
RequestMethod.GET 表示该方法可以处理 HTTP GET 请求。

通过在 @RequestMapping 注解中指定 method 属性，并传入一个包含所支持的请求方式的数组，我们可以限制处理器方法只处理特定的请求方式。这样做的好处是可以提高应用程序的安全性和可靠性，确保只有符合预期的请求方式才能访问相应的处理器方法。

当客户端发送 POST 或 GET 请求到 "/login" 路径时，都会调用 login() 方法进行处理，并返回一个名为 "index" 的视图进行渲染。

3、运行结果

四、使用 @GetMapping 注解

从 springmvc 4.0 开始，提供了新的子注解来替换 @RequestMapping

1、什么是 @GetMapping 注解

在传统的 Spring MVC 中，我们可以使用 @RequestMapping 注解来定义请求映射规则，并通过指定请求方法为 GET 来限定处理器方法只能处理 GET 请求。但是，这种方式需要在注解中指定请求方法，并且代码的可读性较低。

为了简化代码编写和提高可读性，Spring MVC 4.3 版本引入了一系列的便捷注解，其中包括 @GetMapping。它是 @RequestMapping(method = RequestMethod.GET) 的缩写形式，表示该方法只能处理 HTTP GET 请求。

使用 @GetMapping 注解时，我们可以直接指定请求路径，而无需显式地指定请求方法。这样可以使代码更加简洁明了，同时也提高了代码的可读性和可维护性。

2、使用注解

 /**
     * @return
     * @GetMapping()：只用于 get 请求
     */
    @GetMapping("/getUser2")
    public ModelAndView getUser2() {
        return new ModelAndView("index");
    }

public ModelAndView getUser2() 是一个处理器方法，它返回一个 ModelAndView 对象。在这个例子中，该方法的作用是获取用户信息，并返回一个逻辑视图名为 "index" 的视图。

@GetMapping 是一个组合注解，它是 Spring MVC 4.3 版本引入的一个便捷注解，等价于 @RequestMapping(method = RequestMethod.GET)。它表示该方法只能处理 HTTP GET 请求。

通过使用 @GetMapping("/getUser2") 注解，我们可以将请求路径和请求方式（GET）直接绑定到 getUser2() 方法上，简化了代码的编写，并提高了可读性。

这段代码的含义是：当客户端发送 GET 请求到 "/getUser2" 路径时，将会调用 getUser2() 方法进行处理，并返回一个名为 "index" 的视图进行渲染。

3、运行结果

五、使用 @PostMapping 注解

1、什么是 @PostMapping 注解

@PostMapping 注解是 Spring MVC 提供的一个注解，用于将 HTTP POST 请求映射到处理方法上。它是 @RequestMapping 注解的一个特定版本，专门用于处理 POST 请求。

具体来说，@PostMapping 注解的作用如下：

@PostMapping 注解用于将 POST 请求映射到处理方法上。在这里，你可以指定一个或多个请求路径，当请求的路径匹配其中之一时，会调用该方法进行处理。

与 @RequestMapping 注解类似，@PostMapping 注解也支持通过 value 或 path 参数指定请求路径，例如：@PostMapping(value = "/login2") 或 @PostMapping(path = "/login2")。

通过 consumes 参数，你可以指定接受的请求内容类型（Content-Type）。例如：@PostMapping(value = "/login2", consumes = "application/json") 表示只接受 Content-Type 为 "application/json" 的请求。

通过 produces 参数，你可以指定响应的内容类型（Content-Type）。例如：@PostMapping(value = "/login2", produces = "application/json") 表示响应的 Content-Type 将为 "application/json"。

使用 @PostMapping 注解可以更加清晰地表达处理 POST 请求的意图，并提高代码的可读性和可维护性。

需要注意的是，@PostMapping 注解仅用于映射 HTTP POST 请求，如果需要处理其他 HTTP 方法的请求，可以使用 @GetMapping、@PutMapping、@DeleteMapping 等相应的注解。

2、使用 @PostMapping 注解

 /**
     * @PostMapping() : 只用于 post 请求
     * @return
     */
    @PostMapping("/login2")
    public ModelAndView login2() {
        return new ModelAndView("index");
    }

public ModelAndView login2() 是该方法的签名，它表示该方法的返回类型为 ModelAndView。ModelAndView 是 Spring MVC 中用于指定要渲染的视图和模型数据的对象。

return new ModelAndView("index") 表示该方法返回一个名为 "index" 的视图。在这里，"index" 是视图的名称，你可以根据实际需求修改要返回的视图名称。

当有使用 POST 方法请求路径为 "/login2" 的请求到达时，Spring MVC 将会调用该方法进行处理，并返回名为 "index" 的视图。

3、运行结果

HTTP 错误 405 "Request method 'GET' not supported" 意味着你发送了一个不支持的 HTTP 请求方法。

通常情况下，这个错误是因为你发送了一个 GET 请求到一个只支持 POST 请求的接口或方法上。根据你提供的代码示例来看，你的 login2() 方法使用了 @PostMapping 注解，指定该方法只能处理 POST 请求。

当你发送一个 GET 请求到 /login2 路径时，由于该方法不支持 GET 请求，服务器会返回 HTTP 405 错误。

要解决这个问题，你可以采取以下几种方式之一：

将请求方式改为 POST：根据你的代码示例，将请求方式改为 POST，以匹配 login2() 方法的注解。例如，在浏览器中使用表单提交或者使用 POST 请求工具发送请求。

修改方法注解：如果你希望该方法同时支持 GET 和 POST 请求，可以将 @PostMapping 注解改为 @RequestMapping(method = {RequestMethod.GET, RequestMethod.POST})，这样该方法就可以处理 GET 和 POST 请求了。

需要根据具体情况来选择适合的解决方案。

4、添加页面提交表单

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
<form method="post" action="../login2">
    <input type="submit" value="登录" >
</form>
</body>
</html>

写一个提交表单来请求这个 login2。

运行结果：

六、Spring MVC 中处理 GET 和 POST 请求的方式

使用注解 @RequestMapping：@RequestMapping 注解是 Spring MVC 中最常用的处理请求的注解。通过指定请求路径和请求方法，可以将一个方法映射到相应的 GET 或 POST 请求上。
使用注解 @GetMapping 和 @PostMapping：Spring 4.3 版本引入了更方便的注解 @GetMapping 和 @PostMapping，用于直接指定 GET 或 POST 请求。

七、GET 和 POST 请求方式的区别

GET 和 POST 是两种常见的 HTTP 请求方式，它们在以下几个方面存在区别：

数据传输方式：

GET：通过 URL 参数将数据附加在请求的 URL 中进行传输。数据以键值对的形式出现在 URL 的查询字符串中，例如 localhost:8080/login2?key1=value1&key2=value2。
POST：通过请求体将数据发送给服务器。数据以键值对的形式出现在请求体中，不会暴露在 URL 中。

安全性：

GET：由于数据附加在 URL 上，因此在网络传输过程中可能被拦截、缓存或保存在浏览器历史记录中。敏感数据不应该使用 GET 请求发送。
POST：数据包含在请求体中，相对于 GET 请求更安全，因为请求体的内容不容易被拦截或缓存。

缓存：

GET：可以被浏览器缓存，当再次发起相同的 GET 请求时，浏览器可以直接从缓存中获取响应结果，提高性能。
POST：默认情况下不会被浏览器缓存，每次都会向服务器发送请求。

请求体大小限制：

GET：由于数据附加在 URL 中，URL 的长度有限制，不同浏览器和服务器对 URL 长度的限制不同。通常情况下，GET 请求的数据大小限制较小。
POST：由于数据包含在请求体中，对数据大小的限制相对较大，一般取决于服务器的配置和网络环境。

幂等性：

GET：GET 请求是幂等的，即多次重复请求不会对服务器产生副作用。例如，多次请求同一个 URL，不会对服务器端数据产生变化。
POST：POST 请求一般不是幂等的，多次重复请求可能会对服务器产生副作用。例如，重复提交表单可能导致重复创建相同的数据。