1. 文章目的

隨著WebApiClient的不斷完善，越來越多開發(fā)者選擇WebApiClient替換原生的HttpClient，本文將介紹使用WebApiClient來完成JsonPatch提交的新特性。

2. json patch介紹

在服務(wù)端WebApi開發(fā)的時(shí)候，如果設(shè)計(jì)一個(gè)更新登錄用戶的個(gè)人信息的接口，用戶能更新昵稱、密碼、生日、性別等N多個(gè)字段，但用戶在實(shí)際使用中，可能是更新其中的一個(gè)或不確定多個(gè)字段。開發(fā)者往往會(huì)為難：對(duì)于客戶端沒有更新到的字段，應(yīng)該設(shè)置為什么值呢？一種是讓客戶端從服務(wù)器同步后再更新相關(guān)字段，一種是不更新的字段設(shè)置為null，服務(wù)器收到null的字段不更新，但這個(gè)還是有歧義（要更新為null的情況）。

json patch是為客戶端能夠局部更新服務(wù)端已存在的資源而設(shè)計(jì)的一種標(biāo)準(zhǔn)交互，在RFC6902里有詳細(xì)的介紹json patch，通俗來講有以下幾個(gè)要點(diǎn)：

使用HTTP PATCH請(qǐng)求方法；

請(qǐng)求body為描述多個(gè)opration的數(shù)據(jù)json內(nèi)容；

請(qǐng)求的Content-Type為application/json-patch+json；

以下為一個(gè)json patch請(qǐng)求的數(shù)據(jù)包：

op為操作的意思，分為以下幾種：

add 添加：{“op”: "add", "path": "/xxx", "value": "xxx"}，如果該屬性不存，那么就添加該屬性，如果屬性存在，就改變屬性的值。

remove 刪除：{“op”: "remove", "path": "/xxx"}，刪除某個(gè)屬性，或把它設(shè)為默認(rèn)值（例如空值）。

replace 替換：{“op”: "replace", "path": "/xxx", "value": "xxx"}，改變屬性的值，也可以理解為先執(zhí)行了刪除，然后進(jìn)行添加。

copy 復(fù)制：{“op”: "copy", "from": "/xxx", "path": "/yyy"}，把某個(gè)屬性的值賦給目標(biāo)屬性。

remove 移動(dòng)：{“op”: "move", "from": "/xxx", "path": "/yyy"}，把源屬性的值賦值給目標(biāo)屬性，并把源屬性刪除或設(shè)成默認(rèn)值。

test測(cè)試：{“op”: "test", "path": "/xxx", "value": "xxx"}，測(cè)試目標(biāo)屬性的值和指定的值是一樣的。

4.?Asp.net mvc接收J(rèn)sonPatch

在Asp.net mvc，可以使用JsonPatchDocument類型來處理json patch內(nèi)容，JsonPatchDocument可以將操作行為應(yīng)用到目標(biāo)實(shí)例里，得到操作之后的數(shù)據(jù)內(nèi)容。

5. WebApiClient提交JsonPatch

在WebApiClient也提供一個(gè)JsonPatchDocument類型，該類型實(shí)現(xiàn)了IApiParameterable接口，在http請(qǐng)求之后，會(huì)執(zhí)行BeforeRequestAsync方法，完成組裝body的多個(gè)opration的數(shù)據(jù)json內(nèi)容，使用方法如下：

6. 結(jié)束語(yǔ)

博主為WebApiClient庫(kù)的作者，本文向讀者介紹了JsonPatch的基本知識(shí)，以及如何在WebApiClient提交JsonPatch，歡迎大家給WebApiClient提建議。

相關(guān)文章：

• WebApiClient的接口輸入驗(yàn)證

• WebApiClient百度地圖服務(wù)接口實(shí)踐

• 使用WebApiClient請(qǐng)求和管理Restful Api

• .net的retrofit--WebApiClient底層篇
  

原文地址：https://www.cnblogs.com/kewei/p/9431349.html

.NET社區(qū)新聞，深度好文，歡迎訪問公眾號(hào)文章匯總 http://www.csharpkit.com

總結(jié)

以上是生活随笔為你收集整理的WebApiClient的JsonPatch局部更新的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。