SpringMVC——Controller配置总结，@RequestMapping

最新推荐文章于 2025-02-02 12:51:47 发布

原创最新推荐文章于 2025-02-02 12:51:47 发布 · 1.6k 阅读

1 ·

CC 4.0 BY-SA版权

SpringMVC 专栏收录该内容

9 篇文章

订阅专栏

本文详细介绍了SpringMVC中两种定义Controller的方法：实现Controller接口和使用@Controller注解。探讨了@RequestMapping注解的使用，如何配置视图解析器，以及如何通过自动扫描组件来管理Controller。

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

SpringMVC——Controller配置总结

一、实现Controller的方式

我们在SpringMVC中定义Controller有两种方式，一种是实现接口，另一种是使用注解。

1.实现接口的方式：

新建类实现Controller接口
（注意导包问题：是org.springframework.web.servlet.mvc.Controller包下，接口中只有一个handleRequest()方法）

package com.muhan.controller;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class HelloController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse) throws Exception {
        ModelAndView mv = new ModelAndView();
        mv.addObject("msg","hello SpringMVC！");
        mv.setViewName("hello");
        return mv;
    }
}

在handleRequest里面我们就可以做一些处理，我们可以看到这个方法的返回值是ModelAndView，所以我们需要new 一个ModelAndView对象，让这个视图模型对象去携带参数。

导入Jar包
一般需要这几个jar包：

    <!-- Spring MVC 及 Spring系列包 -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>4.3.24.RELEASE</version>
    </dependency>
    <!--Servlet核心-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
    </dependency>
    <!-- JSTL -->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>

在web.xml中配置DispatcherServlet

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
         http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
         id="WebApp_ID" version="3.0">

  <!--1.注册DispatcherServlet-->
  <servlet>
    <servlet-name>springmvc</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!--关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc-servlet.xml</param-value>
    </init-param>
    <!--启动级别-1-->
    <load-on-startup>1</load-on-startup>
  </servlet>

  <!--/ 匹配所有的请求；（不包括.jsp）-->
  <!--/* 匹配所有的请求；（包括.jsp）-->
  <servlet-mapping>
    <servlet-name>springmvc</servlet-name>
    <!--这里使用 / ，不要用 /*-->
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

然后再配置springmvc-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"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">


    <!--注册自己写的Controller-->
    <bean id="/hello" class="com.muhan.controller.HelloController"/>

    <!--视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

在WEB-INF/jsp下编写hello.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
	//获取ModelAndView传来的msg
    ${msg}
</body>
</html>

启动Tomcat测试
在这里插入图片描述
方式一总结：实现Controller接口的这种方式定义Controller控制器的这种方式比较老。它是有很大的弊端的，只能定义一个方法。如果我们像定义多个方法就必须去写多个Controller。所以是非常麻烦的。

2.使用注解@Controller定义控制器

@Controller注解就是spring中用于声明控制器的注解，之前我们还用过@Component，@Repository，@Service这三个注解，实际的作用都是一样的，但是一般我们@Controller是用来声明Controller控制器的，规范来说一般我们SpringMVC中的控制器要使用@Controller
在这里插入图片描述
使用了@Controller后我们就必须在springmvc-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
        http://www.springframework.org/schema/context/spring-context-4.3.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd">


    <!-- 自动扫描指定的包，下面所有注解类交给IOC容器管理 -->
    <context:component-scan base-package="com.muhan.controller"/>

    <!--视图解析器-->
    <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
        <!--前缀-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--后缀-->
        <property name="suffix" value=".jsp"/>
    </bean>
</beans>

然后我们就可以修改我们自定义的Controller类了

package com.muhan.controller;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloController{
	//@RequestMapping("/hello2")的参数表示的是请求的url，就是说在网页上请求hello2才会走我们的Controler处理
    @RequestMapping("/hello2")
    public String hello(Model model){
        model.addAttribute("msg","hello SpringMVC2!");
        //返回视图位置，在返回的时候会经过我们在springmvc-servlet.xml中的视图解析器，给我们hello加上前缀和后缀
        return "hello";
    }
}

然后启动Tomcat，测试
在这里插入图片描述

二、@RequestMapping

在上面的@Controller注解实现Controller控制器中，我们使用到了@RequestMapping注解。
@RequestMapping注解用于映射url到控制器类或者一个特定的处理程序方法。可以使用到类上或者方法上。作用到类上时表示类中所有的响应请求的方法都应该以该地作为父路经。

@RequestMapping使用在方法上：

@Controller
public class HelloController{
    @RequestMapping("/test1")
    public String hello(Model model){
        return "hello";
    }
}

我们启动Tomcat测试，注意观察访问路径
在这里插入图片描述
@RequestMapping使用在类上：

@Controller
@RequestMapping("/all")
public class HelloController{
    @RequestMapping("/test1")
    public String hello(Model model){
        return "hello";
    }
}