java 单机接口限流处理方案
374
2022-06-06
1. 文章目的
随着 WebApiClient 的不断完善,越来越多开发者选择WebApiClient替换原生的HttpClient,本文将介绍使用WebApiClient来完成JsonPatch提交的新特性。
2. json patch介绍
在服务端WebApi开发的时候,如果设计一个更新登录用户的个人信息的接口,用户能更新昵称、密码、生日、性别等N多个字段,但用户在实际使用中,可能是更新其中的一个或不确定多个字段。开发者往往会为难:对于客户端没有更新到的字段,应该设置为什么值呢?一种是让客户端从服务器同步后再更新相关字段,一种是不更新的字段设置为null,服务器收到null的字段不更新,但这个还是有歧义(要更新为null的情况)。
json patch是为客户端能够局部更新服务端已存在的资源而设计的一种标准交互,在 RFC6902 里有详细的介绍json patch,通俗来讲有以下几个要点:
以下为一个json patch请求的数据包:
PATCH /my/data HTTP/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为操作的意思,分为以下几种:
3. Asp.net mvc 接收JsonPatch
在 Asp.net mvc ,可以使用JsonPatchDocument类型来处理json patch内容,JsonPatchDocument可以将操作行为应用到目标实例里,得到操作之后的数据内容。
[HttpPatch] public UserInfo Patch([FromBody] JsonPatchDocument<UserInfo> doc) { var user = new UserInfo { Account = "_Account", Password = "_Password", Email = "_Email" }; doc.ApplyTo(user); return user; }
4. WebApiClient提交JsonPatch
在WebApiClient也提供一个JsonPatchDocument类型,该类型实现了IApiParameterable接口,在http请求之后,会执行BeforeRequestAsync方法,完成组装body的多个opration的数据json内容,使用方法如下:
public interface IPatchApi : IHttpApi { [HttpPatch("http://localhost:7171/api/userinfo")] Task<string> PatchAsync(JsonPatchDocument<UserInfo> doc); } var doc = new JsonPatchDocument<UserInfo>(); doc.Replace(item => item.Account, "laojiu"); doc.Replace(item => item.Email, "laojiu@qq.com"); var client = HttpApiClient.Create<IPatchApi>(); await client.PatchAsync(doc);
5. 结束语
博主为WebApiClient库的作者,本文向读者介绍了JsonPatch的基本知识,以及如何在WebApiClient提交JsonPatch,欢迎大家给WebApiClient提建议。
版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。
发表评论
暂时没有评论,来抢沙发吧~