【ASP.NET Core】JSON Patch 使用简述

JSON Patch 是啥玩意儿？不知道，直接翻译吧，就叫它“Json 补丁”吧。干吗用的呢？当然是用来修改 JSON 文档的了。那咋修改呢？比较常见有四大操作：AMRR。

咋解释呢？

A—— Add；

M—— Move；

R—— Replace；

R—— Remove。

Add 就是向 JSON 对象中添加一对 key - value，或者向 Json Array 中加个元素。

Move 就是把某个节点从一个地方移到另一个地方。

Replace 就是替换，比如把 city 的值从“广州”改为“珠海”。

Remove 就是删除 JSON 对象中的某对 key - value，或者从 Json Array 中删除一个元素。

除了上述四大美女外，还有 copy，就是把某个节点复制到另一个地方；test 这个嘛，在修改 JSON 文档之前验证某个值，如果值正确了就进行更新，如果值不对就“呵呵“，比如，可以 test 一下 age 属性是否为 25，如果是就更新 SON 文档，如果不是就算了吧。

这个 JSON Patch 也不是很复杂，你可以参考主页上的说明，主页地址：http://jsonpatch.com/

这个 JSON Patch 有什么用呢？有用得很！尤其是现在很多数据都是通过网络来传输的，而且许多数据也喜欢用 JSON 格式（貌似是比 XML 简单一些）。如果 JSON 文档比较长，客户端获取了数据后，然后可能会对数据进行更新，然后更新时又把整个 JSON 文档提交回服务器。虽然这一来一回，所产生的流量远不如你打《王者农药》所产生的流量，但是，如果传输频繁，这个流量消耗也是不小的，毕竟各大运营商是增不降费的。按照现在各种破 App 内含数不胜数的虚假广告和一些无用的图片信息，刷几条微博就刷掉 5-6 M 的流量了。

所以说，尽量减少传输量是很有必要的。JSON Patch 不必把整个 JSON 文档都提交回服务器，而仅告诉服务器你要更新哪个地方就好了。比如

[
   { "op" : "add", "path" : "/age", "value" : "150" },
   { "op" : "replace", "path" : "/name", "value" : "老鬼" }
]

注意，JSON Patch 本质上也是一个 JSON 文档。在写的时候，要记得最外面有一层中括号，为啥？你都看到了，是个数组。因为你可以同时把多个操作组合在一起提交。就像上面的，add 和 replace 操作就一起提交了。

当然了，老周本文重点是介绍如何在 ASP.NET Core 中使用 JSON Patch 的，所以，下面咱们切入正题，不说 F 话了。

ASP.NET Core 的 API 自身也有与 JSON Patch 相关的实现，所以，用起来还是挺省心的。这些 API 都分布在 Microsoft.AspNetCore.JsonPatch.* 命名空间中。

相当核心的一个类就是 JsonPatchDocument<TModel>，TModel 是指你要用来生成 JSON 文档的模型类。当客户端提交 JSON Patch 上来后，会自动包含在该对象上，然后你只要调用一下 AppliyTo 方法就可以对模型对象进行更新了。

非常简单的，下面老周就给你演示一下。这里我用的 Web API ，因为这一情形是最为常用的。模型对象是一个字典实例—— IDictionary<string, object>，之所以用字典，是因为字典比较好添加属性。

添加一个 API 控制器类，然后初始化一个字典实例。

    [Route("api/[controller]")]
    public class DemoController : Controller
    {
        IDictionary<string, object> dic = new Dictionary<string, object>
        {
            ["name"] = "非洲黑鹿",
            ["age"] = ,
            ["phone"] = ""
        };
    }

为了可以获取数据，可以定义一个 HTTP-GET 方法访问的方法，并将字典以 JSON 文档返回。

        [HttpGet("pick")]
        public IActionResult PickData()
        {
            return Json(dic);
        }

下面来重点了，为了能够使用 JSON Patch 来更新字典对象，还要弄一个以 HTTP-POST 方法提交的方法。

        [HttpPost("set")]
        public IActionResult SetData([FromBody]JsonPatchDocument<IDictionary<string,object>> body)
        {
            body.ApplyTo(dic);
            return Json(dic);
        }

请严重注意：

1、方法参数的类型是 JsonPatchDocument<TModel>，这样服务器收到客户端提交的 JSON Patch 文档后会自动创建 JsonPatchDocument 实例并传递给 body 参数。

2、在参数上要应用 FromBodyAttribute （特性），因为你得告诉运行时，客户端 POST 上来的整个数据正文将用于生成 JSON Patch 文档。

3、更新字典实例很简单，直接调用 JSON Patch 文档的 ApplyTo 方法就完事了。

好了，就是这么简单，这个演示的例子就完工了。不过得打开 Program.cs 文件，配置一下 Host。

        public static void Main(string[] args)
        {
            WebHostBuilder bd = new WebHostBuilder();
            bd.UseContentRoot(Directory.GetCurrentDirectory())
                .UseStartup<Startup>()
                .UseUrls("http://*:6000")
                .UseKestrel();
            var host = bd.Build();
            host.Run();
        }

http://*:6000 表示应用程序的 URL 在 6000 端口上侦听连接，* 表示绑定给本机的任意主机名。比如 localhost。

在 Startup 类中，还要配置 MVC 的内容，Web API 其实也是 MVC 的一种，只是它不返回 HTML 。

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();
        }

        public void Configure(IApplicationBuilder app)
        {
            app.UseMvc();
        }

由于刚才在 DemoController 控制器中已经用了路由特性指定了路由规则，那么这里就不用再配置全局路由规则了。

   [Route("api/[controller]")]

好，现在我们来测试一下。测试 API 可以用 Postman 大叔，因为它比较牛。

首先，输入 URL http://localhost:6000/api/demo/pick，方式为 GET。

然后返回以下数据。

现在，我们把里面的 name 属性改为“巴西龟”。输入 URL  http://localhost:6000/api/demo/set，提交方式为 POST。

选择 “body” ，格式选 raw，Content Type 选 JSON ( application / json )。

然后输入以下 JSON 。

[
 { "op" : "replace",
   "path" : "/name",
   "value" : "巴西龟"
 }
]

提交之后，得到更新后的字典数据。

我们还可以进行多个操作，除了修改 name 的值，还可以考虑添加一个项。

[
 { "op" : "replace",
   "path" : "/name",
   "value" : "巴西龟"
 },
 {
   "op" : "add",
   "path" : "/email",
   "value" : "small-pig@163.com"
 }
]

向字典添加一个 email 字段。

发送请求后，返回字典数据的最新内容。

好了，简单的演示就结束了。

最后，老周还要强调一点，就是如果你的 JSON Patch 文档的 TModel 是一个类，由于 .NET 是面向对象的，你不能随便向一个类添加属性，因此，add 操作对于类是不可行的，但你可以进行 replace 操作。

=============================

前两天，也就是上个星期六，由于张老鬼找老周有点事情研究，所以【闲聊 ASP.NET Core】的直播暂停一次。这个星期可以补上，周六周日都行，到时候老周会在微博上发一下时间，因为这个周末，女朋友所在的公司组织全体员工去长途旅游，所以这个周末老周就可以自由了，爱干吗就干吗。

我们俩都是穷人家的孩子，双方都没有车，距离又有点远，每次见面都要滴滴打车，所以一个月也只能见两三次面。这个五月她那边比较忙，只见了一次面。没办法，想天天去浪是不可能的了。这就是咱们平头百姓的生活。