详解WebApiClient的JsonPatch局部更新
1.文章目的
随着WebApiClient的不断完善,越来越多开发者选择WebApiClient替换原生的HttpClient,本文将介绍使用WebApiClient来完成JsonPatch提交的新特性。
2.jsonpatch介绍
在服务端WebApi开发的时候,如果设计一个更新登录用户的个人信息的接口,用户能更新昵称、密码、生日、性别等N多个字段,但用户在实际使用中,可能是更新其中的一个或不确定多个字段。开发者往往会为难:对于客户端没有更新到的字段,应该设置为什么值呢?一种是让客户端从服务器同步后再更新相关字段,一种是不更新的字段设置为null,服务器收到null的字段不更新,但这个还是有歧义(要更新为null的情况)。
jsonpatch是为客户端能够局部更新服务端已存在的资源而设计的一种标准交互,在RFC6902里有详细的介绍jsonpatch,通俗来讲有以下几个要点:
- 使用HTTPPATCH请求方法;
- 请求body为描述多个opration的数据json内容;
- 请求的Content-Type为application/json-patch+json;
以下为一个jsonpatch请求的数据包:
PATCH/my/dataHTTP/1.1 Host:example.org Content-Length:326 Content-Type:application/json-patch+json If-Match:"abc123" [ {"op":"test","path":"/a/b/c","value":"foo"}, {"op":"remove","path":"/a/b/c"}, {"op":"add","path":"/a/b/c","value":["foo","bar"]}, {"op":"replace","path":"/a/b/c","value":42}, {"op":"move","from":"/a/b/c","path":"/a/b/d"}, {"op":"copy","from":"/a/b/d","path":"/a/b/e"} ]
op为操作的意思,分为以下几种:
- add添加:{“op”:"add","path":"/xxx","value":"xxx"},如果该属性不存,那么就添加该属性,如果属性存在,就改变属性的值。
- remove删除:{“op”:"remove","path":"/xxx"},删除某个属性,或把它设为默认值(例如空值)。
- replace替换:{“op”:"replace","path":"/xxx","value":"xxx"},改变属性的值,也可以理解为先执行了删除,然后进行添加。
- copy复制:{“op”:"copy","from":"/xxx","path":"/yyy"},把某个属性的值赋给目标属性。
- remove移动:{“op”:"move","from":"/xxx","path":"/yyy"},把源属性的值赋值给目标属性,并把源属性删除或设成默认值。
- test测试:{“op”:"test","path":"/xxx","value":"xxx"},测试目标属性的值和指定的值是一样的。
3.Asp.netmvc接收JsonPatch
在Asp.netmvc,可以使用JsonPatchDocument类型来处理jsonpatch内容,JsonPatchDocument可以将操作行为应用到目标实例里,得到操作之后的数据内容。
[HttpPatch] publicUserInfoPatch([FromBody]JsonPatchDocumentdoc) { varuser=newUserInfo { Account="_Account", Password="_Password", Email="_Email" }; doc.ApplyTo(user); returnuser; }
4.WebApiClient提交JsonPatch
在WebApiClient也提供一个JsonPatchDocument类型,该类型实现了IApiParameterable接口,在http请求之后,会执行BeforeRequestAsync方法,完成组装body的多个opration的数据json内容,使用方法如下:
publicinterfaceIPatchApi:IHttpApi { [HttpPatch("http://localhost:7171/api/userinfo")] TaskPatchAsync(JsonPatchDocument doc); } vardoc=newJsonPatchDocument (); doc.Replace(item=>item.Account,"laojiu"); doc.Replace(item=>item.Email,"laojiu@qq.com"); varclient=HttpApiClient.Create (); awaitclient.PatchAsync(doc);
5.结束语
博主为WebApiClient库的作者,本文向读者介绍了JsonPatch的基本知识,以及如何在WebApiClient提交JsonPatch,欢迎大家给WebApiClient提建议。
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持毛票票。