Question

我想知道如何使用ASP.NET Web API的RESTful接口实现部分更新？比方说，我们通过以下结构的线路传递对象：

public class Person {
    public int Id { get; set; }
    public string Username { get; set; }
    public string Email { get; set; }
}

如何支持一次仅更新Person的部分内容，例如Email属性？是建议通过OData和PATCH动词实现这个，还是自己实现PATCH会更好？

Answer 1

目前最新的 stable 版本的Web API（2012年8月起）没有支持。因此，如果您只想使用Web API RTM，则必须自己实现整个管道。

据说，OData预发行包通过新的Delta<T>对象非常好地支持部分更新。目前Microsoft.AspNet.WebApi.OData包已经是RC版本（0.3），可以从这里获得：http://www.nuget.org/packages/Microsoft.AspNet.WebApi.OData

安装完成后，您可以相应地使用它：

[AcceptVerbs("PATCH")]
public void Patch(int id, Delta<Person> person)
{
    var personFromDb = _personRepository.Get(id);
    person.Patch(personFromDb);
    _personRepository.Save();
}

你会从客户端这样称呼它：

$.ajax({
    url: 'api/person/1',
    type: 'PATCH',
    data: JSON.stringify(obj),
    dataType: 'json',
    contentType: 'application/json',
    success: function(callback) {            
       //handle errors, do stuff yada yada yada
    }
});

这一点的明显优势在于它适用于任何属性，您无需关心是否更新Email或Username或其他内容。

您可能还想查看此帖子，因为它显示了一种非常类似的技术http://techbrij.com/http-patch-request-asp-net-webapi

编辑（更多信息）： 为了只使用PATCH ，除了添加OData包之外，您不需要启用与OData相关的任何内容来访问Delta<TEntityType>对象。

然后你可以这样做：

public class ValuesController : ApiController
{
    private static List<Item> items = new List<Item> {new Item {Id = 1, Age = 1, Name = "Abc"}, new Item {Id = 2, Age = 10, Name = "Def"}, new Item {Id = 3, Age = 100, Name = "Ghj"}};

    public Item Get(int id)
    {
        return items.Find(i => i.Id == id);
    }

    [AcceptVerbs("PATCH")]
    public void Patch(int id, Delta<Item> item)
    {
        var itemDb = items.Find(i => i.Id == id);
        item.Patch(itemDb);
    }
}

如果您的项目是，请说：

{
    "Id": 3,
    "Name": "hello",
    "Age": 100
}

您可以使用以下代码修补/api/values/3

{
    "Name": "changed!"
}

这将正确更新您的对象。

Delta<TEntity>会跟踪您的变化。它是一个动态类，充当您的Type的轻量级代理，并将理解原始对象（即来自DB）与客户端传递的对象之间的差异。

这不会以任何方式影响API的其余部分（当然除了用更新的DLL替换DLL以促进OData包依赖性）。

我添加了一个示例项目来演示PATCH + Delta的工作 - 你可以在这里抓住它（it.s VS2012）https://www.dropbox.com/s/hq7wt3a2w84egbh/MvcApplication3.zip

目前推荐的使用Web API执行部分更新的方法是什么？

1 个答案: