spring mvc 创建restapi 笔记

java 复制代码
@RestController
@RequestMapping("/spittles")
public class SpittleController {

    // 示例:使用 @RequestBody 接收 JSON 并自动转换为 Spittle 对象
    @PostMapping
    public Spittle saveSpittle(@RequestBody Spittle spittle) {
        // 此时 Spring 已经把请求体中的 JSON/XML 解析成了 spittle 对象
        // 你可以直接使用 spittle 做保存、处理等操作
        return spittle; 
        // 这里返回的 spittle 会再次被自动转换为 JSON 并写到响应体中
    }
}

每个注解都是什么意思? 有什么作用?

首先知道,一个流程,例如我们一个请求过来,格式是json格式。并且是url过来。

@RestController:@Controller + @ResponseBody

类中所有方法生效,这意味着该控制器的所有方法返回值默认都直接写到 HTTP 响应体,而非去渲染一个视图(JSP、Thymeleaf 等)

这个是为前后端分离项目后,不需要去渲染,有这个注解就会跳过这一步。直接返回http相应体。

@Controller:如果方法返回一个字符串,Spring 会默认将其视为"视图名",再由视图解析器找到对应的模板去渲染 HTML 页面。

@RestController:所有方法返回值会直接序列化成 JSON(或其他格式)写回客户端(也就是常说的返回纯数据,不走视图渲染)

@RestController 一般用于编写 RESTful API,客户端(例如前端框架Vue/React或Postman)拿到的是 JSON 数据,而不是一个服务端渲染好的页面。

@RequestMapping("/spittles"):统一给这个控制器的所有方法加上路径前缀 /spittles。

我在类上用 @PostMapping,方法上也用 @PostMapping 可以吗?"

java 复制代码
技术上虽然可能不报错,但实际很少这么做。通常类上只设置"公共路径前缀",不限定 HTTP 方法;具体方法用 @PostMapping 等区分 GET、POST、PUT...... 这样更灵活,也更符合 REST 设计。

@RequestBody 是序列化标识吗?"

更准确说是**"反序列化标识":告诉 Spring "请求体里是 JSON/XML,要把它转换为**某个 Java 对象当作参数"。

而 @ResponseBody(或 @RestController) 则用于"把返回的 Java 对象序列化成 JSON/XML 写回响应体"。

Accept头部包含 application/json 的请求?

@RequestMapping 或 @GetMapping 中加上 produces="application/json",告诉 Spring 只能满足 "希望拿到 JSON" 的客户端。

如果请求头中没有 Accept: application/json,又没有其他匹配的控制器方法,Spring 就不会执行这个方法,会返回 406(Not Acceptable)。

相关推荐
阿絮~1 小时前
Apache RocketMQ进阶之路阅读笔记和疑问
笔记·apache·rocketmq
先睡4 小时前
Redis的缓存击穿和缓存雪崩
redis·spring·缓存
天水幼麟6 小时前
动手学深度学习-学习笔记(总)
笔记·深度学习·学习
天水幼麟8 小时前
动手学深度学习-学习笔记【二】(基础知识)
笔记·深度学习·学习
绿皮的猪猪侠8 小时前
算法笔记上机训练实战指南刷题
笔记·算法·pta·上机·浙大
Bug退退退1238 小时前
RabbitMQ 高级特性之死信队列
java·分布式·spring·rabbitmq
沧海一笑-dj9 小时前
【51单片机】51单片机学习笔记-课程简介
笔记·学习·51单片机·江科大·江科大学习笔记·江科大单片机·江科大51单片机
老虎06279 小时前
JavaWeb(苍穹外卖)--学习笔记04(前端:HTML,CSS,JavaScript)
前端·javascript·css·笔记·学习·html
大苏打seven10 小时前
Docker学习笔记:Docker网络
笔记·学习·docker
kikikidult14 小时前
(2025.07)解决——ubuntu20.04系统开机黑屏,左上角光标闪烁
笔记·ubuntu