SpringMVC(二）@RequestMapping注解

最新推荐文章于 2025-05-27 20:24:09 发布

原创

最新推荐文章于 2025-05-27 20:24:09 发布 · 1k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#spring

这篇博客详细介绍了SpringMVC中@RequestMapping注解的使用，包括注解的功能、位置、value、method、params、headers属性，以及ant风格路径和占位符的使用。讲解了如何通过注解建立请求与控制器方法的映射关系，以及处理不同请求方式、参数条件和请求头匹配的方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

我们先新建一个Module。

我们的依赖如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.rgf</groupId>
    <artifactId>Spring_mvc_demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>war</packaging>
    

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    </properties>

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

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


</project>

通过此处我们来进行导入web.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">

    <!--配置SpringMVC的前端控制器DispatcherServlet
    SpringMVC的配置文件默认的位置和名称：
    位置：WEB-INF下
    名称：<servlet-name>-servlet.xml,当前配置下的配置文件名为SpringMVC-servlet.xml
    url-pattern中/和/*的区别：
    /：匹配浏览器向服务器发送的所有请求（不包括.jsp)
    /*：匹配浏览器向服务器发送的所有请求（包括.jsp)

    -->
    <servlet>
        <servlet-name>SpringMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--设置servlet的初始化参数-->
        <!--设置SpringMVC配置文件的位置和名称-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <!--将DispatcherServlet的初始化时间提前到服务器启动时。（默认为servlet在第一次访问时进行执行-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <!--  <url-pattern>/</url-pattern>可以写/*,也可以写*.do（为后缀匹配），/无法·匹配jsp的请求的，但是/*可以匹配任意请求-->
        <servlet-name>SpringMVC</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    <!--   The mappings for the JSP servlet
    <servlet-mapping>
        <servlet-name>jsp</servlet-name>
        <url-pattern>*.jsp</url-pattern>
        <url-pattern>*.jspx</url-pattern>
    </servlet-mapping>
    在tomcat里面的的web.xml已经配置了servlet专门来处理.jsp的请求，即所有的.jsp的请求通过JspServlet来进行处理
    <servlet-name>jsp</servlet-name>
    <servlet-class>org.apache.jasper.servlet.JspServlet</servlet-class>
    -->
</web-app>

之后我们来进行创建配置文件：springmvc-config.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/c"
       xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">

    <!--扫描控制层组件-->
    <context:component-scan base-package="com.rgf.controller"></context:component-scan>

    <!--配置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">
                        <!--/WEB-INF/templates/index.html-->
                        <!--视图前缀+逻辑视图+视图后缀就是我们完整的物理视图，即访问index.html，不用完整路径，即index即可进行访问-->
                        <!--视图前缀-->
                       <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>
</beans>

我们创建的controller如下所示：

package com.rgf.controller;

import org.springframework.stereotype.Controller;

@Controller
public class TestRequestMappingController {

}

package com.rgf.controller;

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

@Controller
public class ProtalController {
    @RequestMapping("/")
    public  String  protal(){
        return  "index";
    }
}

之后根据web.xml的配置文件，我们将该目录创建出来：且该目录下的文件为index.html

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

完成之后，我们来进行配置：

3.1 @RequestMapping注解的功能

从注解名称上我们可以看到，@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系。

SpringMVC接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。

3.2@RequestMapping注解的位置

@RequestMapping标识一个类：设置映射请求的请求路径的初始信息

@RequestMapping标识一个方法：设置映射请求请求路径的具体信息

@Target:当前注解能够标识的位置

当我们标记到方法的时候：
package com.rgf.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@RequestMapping("/test")
@Controller
public class TestRequestMappingController {
    @RequestMapping("/hello")
    public  String hello(){
        return  "success";
    }

}
我们可以根据该具体方法，跳转到具体方法标识的具体页面：
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>首页</title>
</head>
<body>
<h1>success.html</h1>
</body>
</html>
我们将该注解放到类里面的时候：
package com.rgf.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@RequestMapping("/test")
@Controller
public class TestRequestMappingController {
    @RequestMapping("/hello")
    public  String hello(){
        return  "success";
    }

}
此时我们再进行部署运行的时候，发现它无法进行跳转：

此时的路径为类里面的路径和方法里面的路径进行拼接起来的路径。

当我们在两个控制层下面没有在类的里面采用注解区分相同的路径的方法时则会直接报错
package com.rgf.controller;

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

/**
 * @RequestMapping注解的位置
 * @RequestMapping标识一个类：设置映射请求的请求路径的初始信息
 * @RequestMapping标识一个方法：设置映射请求请求路径的具体信息
 */
//@RequestMapping("/test")
@Controller
public class TestRequestMappingController {
    //此时控制器方法所匹配的请求的请求路径为/test/hello
    @RequestMapping("/hello")
    public  String hello(){
        return  "success";
    }
}