JAVA语言Spring MVC框架详述

最新推荐文章于 2025-04-23 08:30:00 发布

勤奋好学额小伙

最新推荐文章于 2025-04-23 08:30:00 发布

阅读量479

点赞数

文章标签： mvc spring java

本文链接：https://blog.youkuaiyun.com/weixin_68138130/article/details/125702045

版权

本文详细介绍了Spring MVC框架，包括其在项目中的作用、开发环境配置、如何接收和响应请求，以及@RequestMapping注解的使用。重点讲解了如何通过@Controller和@ResponseBody注解处理请求和响应正文，并提供了@RestController的源代码解析，帮助开发者更好地理解和应用Spring MVC。

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

Spring MVC的作用：

Spring MVC框架主要解决了接收请求、响应结果的相关问题。

1.开发环境

在使用Spring MVC框架时，需要在项目中添加`spring-webmvc`的依赖项。

如果使用的是Spring Boot工程，只需要添加`spring-boot-starter-web`依赖项即可。

> 说明：在`spring-boot-starter-web`依赖项中，包含了`spring-boot-starter`，所以，在Spring Boot项目中，只需要将原有`spring-boot-starter`改为`spring-boot-starter-web`即可。

2.简单的接收请求

通常，会使用“控制器”组件来接收请求，这类组件通常使用`Controller`作为类名的后缀，例如类名为`CategoryController`、`BrandController`等。

控制器组件必须添加`@Controller`注解才会被框架视为控制器，才可以用于接收请求、响应结果。

在Spring MVC中，当需要接收请求时，只需要在控制器中：

- 自定义处理请求的方法
- 在方法上使用`@RequestMapping`系列注解配置请求路径

关于处理请求的方法：

- 访问权限：应该是`public`
- 返回值类型：当返回值类型为`String`时，表示返回“视图”的名称，这不是前后端分离的做法；当使用了“响应正文”的模式后，返回的字符串将作为“正文”响应到客户端，这是前后端分离的做法
- 方法名称：自定义

3.关于响应正文

当处理请求的方法是响应正文的，则方法的返回值会响应到客户端。

在处理请求的方法上添加`@ResponseBody`，则此方法响应的方式就是响应正文的。

在控制器类上添加`@ResponseBody`，则此**控制器类中所有方法**响应的方式都是响应正文的。

更**推荐**在控制器类上使用`@RestController`，它同时使用`@Controller`和`@ResponseBody`作为元注解，所以，同时具有这2个注解的效果！

> 附：`@RestController`源代码：
> ```java
> @Target(ElementType.TYPE)
> @Retention(RetentionPolicy.RUNTIME)
> @Documented
> @Controller
> @ResponseBody
> public @interface RestController {
>
> /**
>   * The value may indicate a suggestion for a logical component name,
>   * to be turned into a Spring bean in case of an autodetected component.
>   * @return the suggested component name, if any (or empty String otherwise)
>   * @since 4.0.1
>   */
> @AliasFor(annotation = Controller.class)
> String value() default "";
>
> }
> ```

4.关于@RequestMapping

此注解的主要作用是配置“请求路径”与“处理请求的方法”的映射关系。

此注解还可以添加在控制器类上，例如：

```java
@RestController
@RequestMapping("/categories")
public class CategoryController {
}
```

则此类中任何一个处理请求的路径都必须以此为前缀，例如：

```java
@RestController
@RequestMapping("/categories")
public class CategoryController {

    // http://localhost:8080/categories/add-new
    @RequestMapping("/add-new")
    public String addNew() {
        System.out.println("CategoryController.addNew()");
        return "已经处理增加类别的请求";
    }

}
```

在配置路径时，其实，路径值并不需要使用`/`作为第1个字符，除非路径值只有`/`这1个字符，否则，配置值（字符串）两端的`/`都是可以无视的，最终拼接出来的完整URL会自动在中间添加`/`。

**推荐**每个配置值都使用`/`作为第1个字符（尽管可以不写）。

在`@RequestMapping`注解中，还有`method`属性，可以限制请求方式（GET / POST等），其语法大概是：

```java
@RequestMapping(value = "/add-new", method = RequestMethod.POST)
```

以上配置表示“只允许使用POST方式提交请求”，如果使用其它请求方式，将出现405错误！

在Spring MVC框架中，定义一系列的限制请求方式的注解，例如：

- `@GetMapping`：将请求方式限制为GET，除了不能添加在类上，其它用法与`@RequestMapping`相同
- `@PostMapping`：将请求方式限制为POST，除了不能添加在类上，其它用法与`@RequestMapping`相同
- 其它

在开发实践中，控制器类上使用`@RequestMapping`，在方法上使用`@GetMapping`或`@PostMapping`，通常，以“获取数据”为主要目的的请求应该使用`@GetMapping`（例如查看订单列表、查看商品详情），否则，使用`@PostMapping`。

在学习过程中，在没有调试手段之前，推荐全部`@RequestMapping`，以便于测试访问。