SSM框架从入门到入土(RESTful风格)

目录

REST简介

对比:

传统风格资源描述形式

REST风格描述形式

RESTful入门案例:

1.设定http请求动作(动词)

2.设定请求参数(路径变量)

入门案例优化:


REST简介

REST(Representational State Transfer),表现形式状态转换

对比:

传统风格资源描述形式

http://localhost/user/getById?id=1

http://localhost/user/saveUser

REST风格描述形式

http://localhost/user/1

http://localhost/user

优点:隐藏资源的访问行为,无法通过地址得知对资源是何种操作,书写简化

注意事项
++上述行为是约定方式,约定不是规范,可以打破,所以称REST风格,而不是REST规范
描述模块的名称通常使用复数,也就是加s的格式描述,表示此类资源,而非单个资源,例如:users、books、account..++

RESTful入门案例:

1.设定http请求动作(动词)

@RequestMapping(value = "/users",method = RequestMethod.POST),根据你的行为来选定对应的动作,PSOT,GET...........

2.设定请求参数(路径变量)

@RequestMapping(value = "/users/{id}" ,method = RequestMethod.DELETE)

@ResponseBody

public String delete(@PathVariable Integerid){System.out.println("user delete..." + id);return "{'module':'user delete'}";

++在路径上面要有参数的占位,在形参上加上@PathVariable把名称和数据对应上。++

名称:@PathVariable

类型:形参注解

位置:SpringMVC控制器方法形参定义前面

作用:绑定路径参数与处理器方法形参间的关系,要求路径参

入门案例优化:

在我们实际书写中,这样的格式显然有些复杂,因此后续做了一些优化。我们用

@RestController代替@Controller+@RequestBody,

用@PostMapping代替@RequestMapping(method = RequestMethod.POST)

总结:

这种设计使得 API 变得自描述统一。标准映射规则如下:

HTTP 方法 资源路径 (URL) 功能描述 常用HTTP状态码
GET /users 查询所有用户 200 (OK)
GET /users/{id} 查询单个用户 200 (OK) / 404 (Not Found)
POST /users 新增用户 201 (Created)
PUT /users/{id} 全量更新用户 200 (OK) / 204 (No Content)
DELETE /users/{id} 删除用户 204 (No Content) / 200 (OK)

Spring MVC 通过一组专门设计的注解,完美支撑了上述映射规则。

1. @RestController:一键开启 REST 模式

这是构建 RESTful API 的基石。它继承了 @Controller@ResponseBody强制控制器中所有方法返回的对象直接序列化为 JSON/XML 写入 HTTP 响应体,而不是解析为视图页面 。

2. 请求映射注解:精准匹配 HTTP 方法

不要再使用通用的 @RequestMapping强烈建议使用其简化版本,使代码意图一目了然 :

  • @GetMapping

  • @PostMapping

  • @PutMapping

  • @DeleteMapping

3. 参数绑定注解:从请求中提取数据

RESTful 风格要求参数通过特定位置传递,Spring MVC 提供了精准的提取工具 :

  • @PathVariableRESTful 的核心注解 。用于绑定 URL 路径中的模板变量(如 /{id}),这是与传统 ?param=value 风格最大的区别。

  • @RequestBody:绑定 HTTP 请求体中的 JSON/XML 数据到 Java 对象(常用于 POST/PUT)。

  • @RequestParam:绑定查询参数(较少用于 RESTful 资源定位,多用于筛选、分页等场景)。

相关推荐
Leo8991 天前
TCP从零单排
后端
2601_949816681 天前
如何在 Spring Boot 中配置数据库?
数据库·spring boot·后端
开心就好20251 天前
iOS应用上架全流程:从证书申请到发布避坑指南
后端·ios
SamDeepThinking1 天前
程序员懂业务,到底要懂到什么程度
后端·程序员·团队管理
掘金者阿豪1 天前
搭了一个白噪音服务,才意识到之前那些“助眠APP”有多浪费钱
后端
码事漫谈1 天前
OpenSpec实战:AI编程告别“瞎写”
后端
DyLatte1 天前
我做了个AI项目后才发现:会做事的人,正在输给会讲故事的人
前端·后端·程序员
deviant-ART1 天前
java stream 的 findFirst 和 findAny 踩坑点
java·开发语言·后端
神奇小汤圆1 天前
MySQL / MariaDB 主从复制架构实战指南
后端
用户6757049885021 天前
【AI开发实战】从想法到上线,我用AI全栈开发了一款记账微信小程序
后端·aigc·ai编程