Spring中@RestController和@Controller的使用及区别

2025-03-22 14:50
文章标签 spring restcontroller controller 区别 使用 java

本文主要是介绍Spring中@RestController和@Controller的使用及区别，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《Spring中@RestController和@Controller的使用及区别》：本文主要介绍Spring中@RestController和@Controller的使用及区别,具有很好的参考价...

Spring中@RestController和@Controller使用及区别

@RestController 是 Spring Web 提供的一个用来开发 RESTful Web 服务的关键注解，它是 @Controller 和 @ResponseBody 的组合注解。通过 @RestController，我们可以实现处理 HTTP 请求并直接返回 JSON、XML 或其他格式的数据，而不是返回视图页面。

以下是对 @RestController 注解的详细解析：

1. 基本定义

@RestController 的作用

  • 它是一个 标记类 的注解，标识该类是一个 Spring MVC 控制器，且所有方法的返回值会直接作为 HTTP 响应体（Response Body）。
  • 可以用来简化 RESTful API 的开发。

注解的来源

@RestController 是 Spring 4.0 引入的，属于 org.springframework.web.bind.annotation 包。

组合关系

它相当于 @Controller 和 @ResponseBody 的组合：

@Target(value=TYPE)
@Retention(value=RUNTIME)
@Documented
@Controller
@ResponseBody
public @interface RestController {
}

@Controller：

  • 标识当前类是一个 Spring MVC 控制器，用于处理 HTTP 请求。

@ResponseBody：

  • 方法的返回值不会被解析为视图名称，而是直接写入 HTTP 响应体中。

2. 使用场景

@RestController 一般用于开发 RESTful 风格的服务接口，如前后端分离的项目中，前端通过 AJAX 或其他 Http 客户端调用后端接口，获取 JSON 或 XML 数据。

与 @Controller 的区别在于：

  • @RestController 专注于返回数据（如 JSON、XML）。
  • @Controller 通常用于返回视图页面（如 html、JSP）。

3. 使用示例

示例 1：创建一个简单的 RESTful API

import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/api/users")
public class UserController {

    // GET 请求，获取用户信息
    @GetMapping("/{id}")
    public String getUserById(@PathVariable("id") Long id) {
        return "User ID: " + id;
    }

    // POST 请求，创建新用户
    @PostMapping
    public String createUser(@RequestBody String user) {
        return "User created: " + user;
    }
}

请求说明：

  1. @RestController 标注了 UserController 这个类是 RESTful 控制器。
  2. 返回值直接写入响应体，不需要额外使用 @ResponseBody。
  3. 示例中实现了两个接口：
    • 获取用户信息（GET /api/users/{id}）。
    • 创建用户（POST /api/users）。

4. 与 @Controller 的对比

特性@RestController@Controller
主要用途处理 RESTful Web 服务请求，返回 JSON 或 XML返回视图页面（如 Thymeleaf、JSP 等）。
是否需要使用 @ResponseBody不需要，默认应用于所有方法返回值。需要单独为每个方法标注 @ResponseBody。
返回内容数据（JSON、XML、文本等）。视图名称（如 Html 文件）。
使用场景前后端分离的项目。传统 Web 应用（如返回 HTML 页面）。

示例对比：

@R编程estController 示例：

@RestController
@Requeswww.chinasem.cntMapping("/api")
public class ApiController {
    @GetMapping("/greeting")
    public String greeting() {
        return "Hello, World!";
    }
}

返回结果：Hello, World! 作为纯文本响应。

@Controller 示例：

@Controller
@ReHgVAEquestMapping("/web")
public class WebController {
    @GetMapping("/greeting")
    public String greeting() {
        return "greeting"; // 返回视图名称
    }
}

返回结果：渲染名为 greeting.html 的视图。

5. 常用注解配合使用

5.1 配合 @RequestMapping

@RequestMapping 用于指定类或方法的请求路径。可以与 @RestController 配合使用，设置 RESTful API 的基础路径。

示例：

@RestController
@RequestMapping("/api")
public class MyController {
    @GetMapping("/hello")
    public String sayHello(www.chinasem.cn) {
        return "Hello, API!";
    }
}

请求路径：GET /api/hello

5.2 配合 @GetMapping、@PostMapping

  • @GetMapping：用于处理 HTTP GET 请求。
  • @PostMapping：用于处理 HTTP POST 请求。

示例：

@RestController
@RequestMapping("/users")
public class UserController {

    // GET 请求
    @GetMapping("/{id}")
    public String getUser(@PathVariable Long id) {
        return "User ID: " + id;
    }

    // POST 请求
    @PostMapping
    public String createUser(@RequestBody String user) {
        return "Created User: " + user;
    }
}

5.3 配合 @RequestBody

@RequestBody 将 JSON 请求体转换为 Java 对象。

示例：

@RestController
@RequestMapping("/books")
public class BookController {

    @PostMapping
    public String createBook(@RequestBody Book book) {
        return "Created Book: " + book.getTitle();
    }
}
class Book {
    private String title;
    private String author;
    // Getter and Setter
}

请求数据：

{
    "title": "Spring in Action",
    "author": "Craig Walls"
}

5.4 配合 @PathVariable 和 @RequestParam

  • @PathVariable：从请求路径中获取变量。
  • @RequestParam：从查询参数中获取值。

示例：

@RestController
@RequestMapping("/products")
public class ProductController {

    @GetMapping("/{id}")
    public String getProduct(@PathVariable Long id, @RequestParam String name) {
        return "Product ID: " + id + ", Name: " + name;
    }
}
  • 请求路径：GET /products/123?name=Phone
  • 返回结果：Product ID: 123, Name: Phone

6. 返回 JSON 数据

@RestController 默认将返回值序列化为 JSON 格式（如果依赖的 Jackson 库存在）。

示例：

@RestController
@RequestMapping("/users")
public class UserController {

    @GetMapping("/{id}")
    public User getUser(@PathVariable Long id) {
        return new User(id, "John");
    }
}
class User {
    private Long id;
    private String name;
    // Constructor, Getter, Setter
}

返回结果：

{
    "id": 1,
    "name": "John"
}

7. 常见问题

7.1 返回值无法序列化

  • 如果返回的对象没有提供 getter 或没有无参构造函数，可能导致 JSON 序列化失败。
  • 解决方法：确保返回的对象有正确的 getter 和无参构造器。

7.2 404 Not Found 错误

  • 检查请求路径是否正确。
  • 确保控制器类和方法的 @RequestMapping 路径匹配。

7.3 415 Unsupported Media Type 问题

  • 如果使用 @RequestBody，确保请求头中有 Content-Type: application/json。

8. 特性总结

特性描述
组合注解是 @Controller 和 @ResponseBody 的组合。
返回数据格式默认返回 JSON 数据（需要依赖 Jackson 库）。
适用场景RESTful API 开发，前后端分离项目接口开发。
简化开发不需要额外为每个方法添加 @ResponseBody。

总结

  • @RestController 是 Spring Web 提供的一个便捷注解，专用于处理 RESTful API 请求。
  • 它简化了传统的 @Controller + @ResponseBody 的开发方式。
  • 配合其他注解（如 @RequestMapping、@GetMapping、@RequestBody 等HgVAE）可以快速开发健壮的 RESTful 服务。
  • 在前后端分离的应用中，@RestController 是必不可少的工具之一。

以上为个人经验，希望能给大家一个参考，也希望大家多多支持China编程(www.chinasem.cn)。

这篇关于Spring中@RestController和@Controller的使用及区别的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1153882。

相关文章

Spring 请求之传递 JSON 数据的操作方法

Spring 请求之传递 JSON 数据的操作方法

《Spring请求之传递JSON数据的操作方法》JSON就是一种数据格式,有自己的格式和语法,使用文本表示一个对象或数组的信息,因此JSON本质是字符串,主要负责在不同的语言中数据传递和交换,这... 目录jsON 概念JSON 语法JSON 的语法JSON 的两种结构JSON 字符串和 Java 对象互转
阅读更多...
Python使用getopt处理命令行参数示例解析(最佳实践)

Python使用getopt处理命令行参数示例解析(最佳实践)

《Python使用getopt处理命令行参数示例解析(最佳实践)》getopt模块是Python标准库中一个简单但强大的命令行参数处理工具,它特别适合那些需要快速实现基本命令行参数解析的场景,或者需要... 目录为什么需要处理命令行参数？getopt模块基础实际应用示例与其他参数处理方式的比较常见问http
阅读更多...
JAVA保证HashMap线程安全的几种方式

JAVA保证HashMap线程安全的几种方式

《JAVA保证HashMap线程安全的几种方式》HashMap是线程不安全的,这意味着如果多个线程并发地访问和修改同一个HashMap实例,可能会导致数据不一致和其他线程安全问题,本文主要介绍了JAV... 目录1. 使用 Collections.synchronizedMap2. 使用 Concurren
阅读更多...
Java Response返回值的最佳处理方案

Java Response返回值的最佳处理方案

《JavaResponse返回值的最佳处理方案》在开发Web应用程序时,我们经常需要通过HTTP请求从服务器获取响应数据,这些数据可以是JSON、XML、甚至是文件,本篇文章将详细解析Java中处理... 目录摘要概述核心问题：关键技术点：源码解析示例 1：使用HttpURLConnection获取Resp
阅读更多...
C 语言中enum枚举的定义和使用小结

C 语言中enum枚举的定义和使用小结

《C语言中enum枚举的定义和使用小结》在C语言里,enum（枚举）是一种用户自定义的数据类型,它能够让你创建一组具名的整数常量,下面我会从定义、使用、特性等方面详细介绍enum,感兴趣的朋友一起看... 目录1、引言2、基本定义3、定义枚举变量4、自定义枚举常量的值5、枚举与switch语句结合使用6、枚
阅读更多...
Java的栈与队列实现代码解析

Java的栈与队列实现代码解析

《Java的栈与队列实现代码解析》栈是常见的线性数据结构,栈的特点是以先进后出的形式,后进先出,先进后出,分为栈底和栈顶,栈应用于内存的分配,表达式求值,存储临时的数据和方法的调用等,本文给大家介绍J... 目录栈的概念（Stack）栈的实现代码队列（Queue）模拟实现队列(双链表实现)循环队列（循环数组
阅读更多...
使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)

《使用Python从PPT文档中提取图片和图片信息(如坐标、宽度和高度等)》PPT是一种高效的信息展示工具,广泛应用于教育、商务和设计等多个领域,PPT文档中常常包含丰富的图片内容,这些图片不仅提升了... 目录一、引言二、环境与工具三、python 提取PPT背景图片3.1 提取幻灯片背景图片3.2 提取
阅读更多...
Java中Switch Case多个条件处理方法举例

Java中Switch Case多个条件处理方法举例

《Java中SwitchCase多个条件处理方法举例》Java中switch语句用于根据变量值执行不同代码块,适用于多个条件的处理,：本文主要介绍Java中SwitchCase多个条件处理的相... 目录前言基本语法处理多个条件示例1：合并相同代码的多个case示例2：通过字符串合并多个case进阶用法使用
阅读更多...
Java中的Lambda表达式及其应用小结

Java中的Lambda表达式及其应用小结

《Java中的Lambda表达式及其应用小结》Java中的Lambda表达式是一项极具创新性的特性,它使得Java代码更加简洁和高效,尤其是在集合操作和并行处理方面,：本文主要介绍Java中的La... 目录前言1. 什么是Lambda表达式？2. Lambda表达式的基本语法例子1：最简单的Lambda表
阅读更多...
Java中Scanner的用法示例小结

Java中Scanner的用法示例小结

《Java中Scanner的用法示例小结》有时候我们在编写代码的时候可能会使用输入和输出,那Java也有自己的输入和输出,今天我们来探究一下,对JavaScanner用法相关知识感兴趣的朋友一起看看吧... 目录前言一 输出二 输入Scanner的使用多组输入三 综合练习：猜数字游戏猜数字前言有时候我们在
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2