当前位置：首页 > 科技 > 软件

REST API中的Patch请求大家都用错了，这才是正确姿势

来源：责编：时间：2024-09-10 09:46:33 38观看

导读环境：SpringBoot3.2.51. 简介HTTP PATCH 方法它允许我们对 HTTP 资源进行部分更新。在篇文章，将带你如何使用 HTTP PATCH 方法和 JSON Patch文档格式对 RESTful 资源进行部分更新。HTTP PATCH 请求正文（Request Body）描述

环境：SpringBoot3.2.5

1. 简介

HTTP PATCH 方法它允许我们对 HTTP 资源进行部分更新。

在篇文章，将带你如何使用 HTTP PATCH 方法和 JSON Patch文档格式对 RESTful 资源进行部分更新。

HTTP PATCH 请求正文（Request Body）描述了如何修改目标资源以生成新版本。简而言之，JSON Patch 格式使用 "一系列操作 "来描述应如何修改目标资源。JSON Patch文档是一个 JSON 对象数组。数组中的每个对象正好代表一个 JSON Patch操作。Request Body请求格式如下：

[  {    "op": "replace|add|remove|move|copy|test",    "path": "/xxx",    ["value": "value"],    ["from": "/yyy"]  },    ...]

op：具体的操作
path：资源路径
value：变更值；根据操作op不同，决定是否有该属性
from：资源路径；根据操作op不同，决定是否有该属性

接下来，通过具体的示例来了解 JSON Patch操作。

2. JSON Patch操作

接下来的所有操作都基于下面的资源进行：

{     "id": 1,    "telephone": "001-555-1234",    "favorites": ["Milk","Eggs"],    "communicationPreferences": {"post":true, "email":true}}

假设有上面的资源数据，下面将分别介绍基于该资源如何进行不同的操作。

2.1 add添加操作

添加操作为对象添加新值。此外，我们还可以用它来更新现有成员，并在指定索引处向数组中插入一个新值。

给favorities数据添加新值，并且插入到第一个位置。

请求Body

{  "op": "add",  "path": "/favorites/0",  "value": "Bread"}

结果

{  "id": "1",  "telephone": "001-555-1234",  "favorites": ["Bread","Milk","Eggs"],  "communicationPreferences": {"post":true, "email":true}}

2.2 remove删除操作

不仅可以删除指定属性的值，如果是数组还可以删除指定索引位置的元素。

删除communicationPreferences属性值

请求Body

{  "op": "remove",  "path": "/communicationPreferences"}

结果

{  "id": "1",  "telephone": "001-555-1234",  "favorites": ["Bread","Milk","Eggs"],  "communicationPreferences": null}

2.3 replace替换操作

将目标属性值更新为一个新的值；

更新电话号码；

请求Body

{  "op": "replace",  "path": "/telephone",  "value": "001-555-5678"}

结果

{   "id": "1",   "telephone": "001-555-5678",   "favorites": ["Bread","Milk","Eggs"],   "communicationPreferences": null}

2.4 move移动操作

移动操作会移除指定位置的值，并将其添加到目标位置。

移动favorities属性第0号位置元素到最后一个位置。

请求Body

{  "op": "move",  "from": "/favorites/0",  "path": "/favorites/-"}

结果

{   "id": "1",   "telephone": "001-555-5678",   "favorites": ["Milk","Eggs","Bread"],   "communicationPreferences": null}

2.5 copy复制操作

复制操作将指定位置的值复制到目标位置。

将favorites属性中的Milk复制一份到该属性的最后位置。

请求Body

{  "op": "copy",  "from": "/favorites/0",  "path": "/favorites/-"}

结果

{   "id": "1",   "telephone": "001-555-5678",   "favorites": ["Milk","Eggs","Bread","Milk"],   "communicationPreferences": null}

2.6 test测试操作

测试操作测试 "路径 "上的值是否等于 "值"。

请求Body

{  "op": "test",   "path": "/telephone",  "value": "001-555-5678"}

注意：JSON Patch请求的Content-Type类型为：application/json-patch+json

接下来将实战演示在Spring Boot中如何使用JSON Patch。

3. 实战案例

3.1 引入依赖

<dependency>  <groupId>com.github.java-json-tools</groupId>  <artifactId>json-patch</artifactId>  <version>1.13</version></dependency>

该组件是RFC 6902（JSON Patch）和RFC 7386（JSON Merge Patch）的实现，其核心使用Jackson（2.2.x）。该组件的特性：

JSON Patch的序列化和JSON与Jackson Merge Patch实例
全面支持RFC 6902操作，包括测试
JSON“差异”(仅RFC 6902)与运算因子分解

接下来进入实践代码的编写

3.2 定义实体类

public class Customer {  /**编号*/  private Long id ;  /**电话*/  private String telephone ;  /**收藏集*/  private List<String> favorites ;  /**通信首选项*/  private Map<String, Boolean> communicationPreferences ;  public Customer(Long id, String telephone, List<String> favorites,      Map<String, Boolean> communicationPreferences) {    this.id = id ;    this.telephone = telephone ;    this.favorites = favorites ;    this.communicationPreferences = communicationPreferences ;  }  // getters, setters}

定义异常类

public static class CustomerNotFoundException extends RuntimeException {}

当没有资源时抛出该异常类

3.3 Service类

@Servicepublic static class CustomerService {  // 模拟静态数据  private static List<Customer> DATAS = List    .of(new Customer(          1L, "188",           List.of("Milk", "Eggs"),           Map.of("phone", true, "email", true)));  // 根据ID查询操作  public Optional<Customer> findCustomer(Long id) {    return DATAS.stream().filter(customer -> customer.getId() == id).findFirst();  }}

接下来就是关键的Controller接口的编写了

3.4 Controller接口

@PatchMapping(path = "/{id}", consumes = "application/json-patch+json")public ResponseEntity<Customer> updateCustomer(@PathVariable Long id, @RequestBody JsonPatch patch) {  try {    // 查询资源    Customer customer = customerService.findCustomer(id).orElseThrow(CustomerNotFoundException::new);    Customer customerPatched = applyPatchToCustomer(patch, customer);    return ResponseEntity.ok(customerPatched);  } catch (JsonPatchException | JsonProcessingException e) {    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();  } catch (CustomerNotFoundException e) {    return ResponseEntity.status(HttpStatus.NOT_FOUND).build();  }}// 将请求的操作转换成真实的资源变更private Customer applyPatchToCustomer(JsonPatch patch, Customer targetCustomer)    throws JsonPatchException, JsonProcessingException {  ObjectMapper objectMapper = new ObjectMapper() ;  JsonNode patched = patch.apply(objectMapper.convertValue(targetCustomer, JsonNode.class));  return objectMapper.treeToValue(patched, Customer.class);}

在该接口中注意以下两点：

consumes属性设置为application/json-patch+json，也就是请求的Content-Type必须是该值。
请求body通过JsonPatch对象接收。

接下来进行测试：

图片

请求Body中定义了2个操作，replace与add。最后返回的结果表明操作成功，数据得到了变更。

本文链接：http://www.28at.com/showinfo-26-112718-0.htmlREST API中的Patch请求大家都用错了，这才是正确姿势

声明：本网页内容旨在传播知识，若有侵权等问题请及时与本网联系，我们将在第一时间删除处理。邮件：2376512515@qq.com

上一篇：聊聊 C# 中的ToString()数字格式化

下一篇： PHP 程序员学会了 Go 语言就能唬住面试官吗？

标签：

热门焦点

Redmi Buds 4开箱简评：才199还有降噪可以无脑入

在上个月举办的Redmi Note11T Pro系列新机发布会上，除了两款手机新品之外，Redmi还带来了两款TWS真无线蓝牙耳机产品，Redmi Buds 4和Redmi Buds 4 Pro，此前我们在Redmi Note11T
零售大模型“干中学”，攀爬数字化珠峰

文/侯煜编辑/cc来源/华尔街科技眼对于绝大多数登山爱好者而言，攀爬珠穆朗玛峰可谓终极目标。攀登珠峰的商业路线有两条，一是尼泊尔境内的南坡路线，一是中国境内的北坡路线。相
签约井川里予、何丹彤，单视频点赞近千万，MCN黑马永恒文希快速崛起！

来源：视听观察永恒文希传媒作为一家MCN公司，说起它的名字来，可能大家会觉得有点儿陌生，但是说出来下面一串的名字之后，或许大家就会感到震惊，原来这么多网红，都签约这家公司了。根
华为Mate60系列模具曝光：采用硕大圆形后置相机模组+拼接配色方案

据此前多方爆料，今年华为将开始恢复一年双旗舰战略，除上半年推出的P60系列外，往年下半年的Mate系列也将迎来更新，有望在9-10月份带来全新的华为Mate60
苹果、三星、惠普等暂停向印度出口笔记本和平板电脑

集微网消息，据彭博社报道，在8月3日印度突然禁止在没有许可证的情况下向印度进口电脑/平板及显示器等产品后，苹果、三星电子和惠普等大公司暂停向印度
iQOO Neo8系列新品发布会

旗舰双芯更强更Pro
OPPO K11采用全方位护眼屏：三大护眼能力减轻视觉疲劳

日前OPPO官方宣布，全新的OPPO K11将于7月25日正式发布，将主打旗舰影像，和同档位竞品相比，其最大的卖点就是将配备索尼IMX890主摄，堪称是2000档位影像表
OPPO Reno10 Pro英雄联盟定制礼盒公布：萨勒芬妮同款配色梦幻十足

5月24日，OPPO推出了全新的OPPO Reno 10系列，包含OPPO Reno10、OPPO Reno10 Pro和OPPO Reno10 Pro+三款新机，全系标配了超光影长焦镜头，是迄今为止拍照
滴滴违法违规被罚80.26亿共存在16项违法事实

滴滴违法违规被罚80.26亿存在16项违法事实开始于2121年7月，历经一年时间，网络安全审查办公室对“滴滴出行”网络安全审查终于有了一个暂时的结束。据“网信