RESTful中的PUT和PATCH实践

最新推荐文章于 2025-05-29 10:41:34 发布

青云桑

最新推荐文章于 2025-05-29 10:41:34 发布

阅读量1.9w

点赞数 3

CC 4.0 BY-SA版权

分类专栏： SkyBlog源码解析文章标签： SkyBlog RESTful Swaager

本文链接：https://blog.youkuaiyun.com/qq_35264464/article/details/79490618

本文通过SkyBlog Swagger API展示了RESTful API中PUT和PATCH的使用。PUT用于更新用户完整信息，需要管理员或用户本人权限；PATCH用于部分更新用户角色和状态，权限要求更高，分别限制为系统管理员和系统管理员、管理员。这体现了PUT和PATCH在接口权限和资源修改范围上的差异。

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

先放上后台的在线API文档：SkyBlog Swagger API

在UserApi中，有这样三个接口
1. PUT /users/{id} 更新用户信息
2. PATCH /users/role/{id} 更新用户角色
3. PATCH /users/status/{id} 更新用户状态

在这三个接口便可以看出PUT和PATCH的区别
PUT方法主要是用来更新整个资源的，而PATCH方法主要是用来执行某项操作并更新资源的某些字段

而在项目中，这三个接口需要的用户权限也不一样

PUT /users/{id} 更新用户信息

要求是系统管理员、管理员或者是用户本人，才能使用该接口

    /**
     * 更新用户信息
     * @param id 用户ID
     * @param user 用户对象
     * @return 更新后的用户
     */
    @PutMapping("/{id}")
    @ApiOperation("更新用户信息")