首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >SSM框架从入门到入土(RESTful风格)

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

作者头像
北极的代码
发布2026-04-22 18:39:54
发布2026-04-22 18:39:54
700
举报

目录

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 Integer id){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 资源定位,多用于筛选、分页等场景)。
本文参与 腾讯云自媒体同步曝光计划,分享自作者个人站点/博客。
原始发表:2026-04-22,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • REST简介
  • 对比:
    • 传统风格资源描述形式
    • REST风格描述形式
  • RESTful入门案例:
    • 1.设定http请求动作(动词)
    • 2.设定请求参数(路径变量)
  • 入门案例优化:
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档