采用RESTful方式更新集合：购物车类场景的子集修改需求

嘿，这个场景其实挺典型的，咱们得先从RESTful的核心——资源定义入手，再对应到具体的HTTP操作上。先理清楚你的业务里的资源：

• 产品全集/products：这是你的基础数据资源，应该是只读或者只做全局价格调整用的，咱们不要直接动它来实现子集的自定义价格。
• 你需要的「价格修改后的子集」是一个独立的业务资源，比如叫custom-price-sets（自定义价格集合），如果是购物车场景的话就叫carts，名字可以根据你的业务调整，核心是把这个子集当成一个可操作的独立资源。

1. 创建初始的价格修改子集 #

当你从全集中挑产品改价格时，这本质是创建一个新的资源，用POST方法最合适：

请求端点 #

POST /custom-price-sets

请求体（JSON格式） #

{
  "products": [
    { "productId": 1, "price": 1.59 },
    { "productId": 3, "price": 2.59 }
  ]
}

服务器响应 #

服务器会返回201 Created状态码，同时给你这个新资源的唯一标识和访问URI，比如：

{
  "id": "price-set-001",
  "uri": "/custom-price-sets/price-set-001",
  "products": [
    { "productId": 1, "price": 1.59 },
    { "productId": 3, "price": 2.59 }
  ]
}

这样你就拿到了一个可以后续操作的独立资源，而不是直接修改产品全集。

2. 更新这个子集的价格 #

接下来修改子集里的价格，有两种符合RESTful语义的方式，看你是要全量替换还是局部更新：

方式一：全量替换（用PUT） #

如果你想完全替换这个子集的内容（比如更新某个产品价格的同时，可能还要添加/移除其他产品），就用PUT方法，把整个更新后的集合发过去：

请求端点

PUT /custom-price-sets/price-set-001

请求体（JSON）

{
  "products": [
    { "productId": 1, "price": 1.79 },
    // 注意：如果还要保留productId=3的商品，必须把它也写进来，否则服务器会认为你要移除它
    { "productId": 3, "price": 2.59 }
  ]
}

响应

服务器返回200 OK，同时返回更新后的完整资源。

方式二：局部增量更新（用PATCH + JSON Patch） #

如果你只想修改子集里某一个产品的价格，不想全量发送所有内容，就用PATCH方法配合JSON Patch规范（RFC 6902），这样更高效：

请求端点

PATCH /custom-price-sets/price-set-001

请求体（JSON Patch格式）

[
  {
    "op": "replace",
    "path": "/products/0/price",
    "value": 1.79
  }
]

这里的/products/0是指集合里第一个产品（索引从0开始）。如果你的服务器支持按productId定位，也可以写成/products/productId=1/price（具体取决于服务器的实现逻辑）。

响应

服务器一般会返回200 OK（带更新后的资源）或者204 No Content（只返回状态，不返回内容）。

补充：如果是购物车场景的适配 #

如果你的业务就是购物车（比如用户的购物车商品自定义价格），资源名称可以换成/carts/{cart-id}/items，操作逻辑完全一致：

• 创建购物车并添加改价商品：POST /carts
• 更新购物车内商品价格：PUT /carts/{cart-id}/items 或者 PATCH /carts/{cart-id}/items

关键注意点 #

• 别直接修改产品全集/products：除非是产品本身的基础价格变更，你的子集是业务场景下的自定义资源，应该独立维护。
• 贴合HTTP方法语义：POST创建新资源，PUT全量替换，PATCH局部更新，这才是RESTful的核心，别乱用方法。

内容的提问来源于stack exchange，提问作者morowinder