c# - 处理更新详细记录的 RESTful 方式

Question

如果我需要更新许多详细信息行，我的 Web API Controller 方法可能看起来像这样，使用 RPC 样式:

[Route("api/updateAccountDetailStatus")]
[HttpGet]
public IHttpActionResult UpdateAccountDetailStatus(int accountId, string status)

这会将与该帐户关联的所有详细信息行更改为新状态。

在尝试采用 RESTful 方法时，我的猜测是它会是这样的:

PATCH /accounts/110
{
  "status": "hold"
}

[Route("api/accounts/id")]
[HttpGet]
public IHttpActionResult Account(Account account)

我不喜欢的是现在 API Controller 方法需要询问对象以了解如何处理它。在这种情况下，它会将所有详细信息行更改为该新状态。但是，如果有人调用该补丁并发送不同的属性进行修改怎么办？现在我必须根据那个改变行为？有没有更好的办法？

Answer 1

我看到了这个难题。一方面，您希望保持真实并且在您的 URI 中没有操作名称(更改、更新等)，另一方面，这是一个特殊的过程而不是真正的 PATCH。

所以，对于这个article我做了一些工作来允许通过发送的消息类型来定义操作，甚至在 Web API 中创建了一种方法。

此示例代码是 here .

本质上，您将这些公开为 POST 或 PUT(取决于它们是否是幂等的)并且资源将有多个 POST 或 PUT 反对它。例如:

GET /api/InventoryItem [gets all items]
GET /api/InventoryItem/{id} [gets detail of a single item]
POST /api/InventoryItem [creates an item]
POST /api/InventoryItem/{id}* [checks in stock items to the inventory]
POST /api/InventoryItem/{id}* [removes stock items from the inventory]
PUT /api/InventoryItem/{id} [renames an item]
DELETE /api/InventoryItem/{id} [de-activates an item]

这是迄今为止我对这些类型的资源唯一的解决方案。

更新

重要的是，您将在 api/accounts/id 处将其公开为 PUT(因为我认为它是幂等的)，发送表示消息类型的有效负载:

PUT api/accounts/id

{"detailBatchStateChange": "hold"}