插入和更新的 URI 约定 - WCF Rest API

Question

我有用户集合和用户集合。用户 - ID、FName、LName。

对于插入，我传递带有 Id、FName、LName 的 User 实例。如果用户不存在，服务将插入该用户。

为了更新，我再次传递带有所有参数的 User 实例。该服务更新具有给定 ID 的用户的 FName 和 LName。

我想在服务中将插入和更新作为两个单独的方法。

我不能为这两种方法提供相同的 URI。如下所示：

    [WebInvoke(UriTemplate = "Users", Method = "PUT")]
    void  UpdateUser(User instance);

    [WebInvoke(UriTemplate = "Users", Method = "PUT")]
    void  AddUser(User instance);

实现此目标的最佳方法是什么？

我不同意一篇文章说更新 URI 以具有以下内容：

    [WebInvoke(UriTemplate = "Users/{userId}", Method = "PUT")]
    void  UpdateUser(string userId, User instance);

因为，用户 id 已经存在于 Userinstance 中。

虽然我同意 PUT 方法可以执行插入和更新。出于某种原因，我需要将它们分开。

Answer 1

PUT，作为一个 幂等 操作，应该在您要 PUT 到的 URL 处创建一个新资源，或者完全创建一个新资源替换现有资源（在此放置此资源）。如果对同一个 URL 多次执行相同的 PUT，您仍然会得到相同的资源。

POST 不一定是幂等的，因为您正在更改现有资源。如果您的 POST 正在执行类似向订单添加商品之类的操作，并且您将相同的数据多次发布到相同的 url，则最终可能会得到包含多个相同商品的订单。

简短的回答，让您插入 PUT 操作并更新 POST。

我认为这个答案很好地解释了它。

Answer 2

您可以通过几种方式查看它

• PUT - 用于更新，但如果提供的 id 不存在，则插入
• POST - 用于
  创建、插入任意次数
  即使您传递相同的数据也喜欢
  多次，因为它忽略了 ids

所以我会说：

• 使用 POST 添加用户：/Users （但是理论上你可以使用 PUT 来做到这一点）。
• 使用 PUT 更新用户：/Users/{userId} 与

获取用户信息一样，使用 GET ... 获取用户信息 /Users/{userId} ... 或使用 Delete 删除用户 /Users/{userId} 。

不确定这是否有帮助，如果没有，请告诉我，我会再试一次:-)