在ASP.NET Core中用HttpClient（三）——发送HTTP PATCH请求

正如我们已经提到的，我们使用PUT请求进行完整更新，使用PATCH请求进行部分更新。但这并不是这两个HTTP请求之间的唯一区别。首先，请求主体是不同的。如果我们检查Web API中的PUT，我们可以看到请求体是一个简单的对象:

[FromBody] CompanyForUpdateDto company
但如果我们对PATCH请求做同样的检查:

[FromBody] JsonPatchDocument patchDoc
可以看到，如果我们想要支持PATCH请求的请求体，我们必须使用JsonPatchDocument类。这个类帮助我们描述可以使用PATCH请求执行的不同操作集。

同样，对于PUT请求，我们使用application/json作为媒体类型。但是对于PATCH请求，首选的媒体类型是application/json-patch+json。我们可以为HTTP PATCH请求使用application/json媒体类型，但正如我们提到的，首选的媒体类型是application/json-patch+json，我们将在示例中使用它。

HTTP PATCH操作

PATCH请求可以作为JSON数组的一部分执行一个或多个操作。让我们看看PATCH请求的请求体:

复制代码
[
{
“op”: “replace”,
“path”: “/name”,
“value”: “new name”
},
{
“op”: “remove”,
“path”: “/name”
}
]
复制代码
正如我们所看到的，请求主体基本上是一个指定不同操作的JSON对象数组。也就是说，我们可以确认两个操作:由op属性指定的Replace和Remove。路径部分表示到我们想要修改的对象属性的路径。最后，value部分表示一个新值，我们用它来替换Name属性的旧值。

使用HttpClient的PatchAsync方法发送HTTP PATCH请求

在我们开始修改客户端项目之前，可以快速地看一下API的PATCH操作的路径:

[Route(“api/companies/{companyId}/employees”)]
[ApiController]
public class EmployeesController : ControllerBase
可以看到我们已经在EmployeesController中实现了PATCH操作。由于单个员工不能在没有单个公司的情况下存在，所以到这个控制器的路由是:

api/companies/{companyId}/employees
但是，我们只更新了一个雇员，所以我们需要该雇员的id:

[HttpPatch("{id}")]
public IActionResult PartiallyUpdateEmployeeForCompany(Guid companyId, Guid id, [FromBody] JsonPatchDocument patchDoc)
这意味着该操作的路由是:

api/companies/{companyId}/employees/{id}
为了简单起见，我们已经从这个控制器中删除了其余的操作，另外，为了便于参考，让我们展示一下API实现:

复制代码
[HttpPatch("{id}")]
public IActionResult PartiallyUpdateEmployeeForCompany(Guid companyId, Guid id, [FromBody] JsonPatchDocument patchDoc)
{
if(patchDoc == null)
{
_logger.LogError(“patchDoc object sent from client is null.”);
return BadRequest(“patchDoc object is null”);
}
var company = _repository.Company.GetCompany(companyId, trackChanges: false);
if (company == null)
{
_logger.LogInfo(KaTeX parse error: Expected 'EOF', got '}' at position 96: …otFound(); }̲ var employ…“Employee with id: {id} doesn’t exist in the database.”);
return NotFound();
}
var employeeToPatch = _mapper.Map(employeeEntity);
patchDoc.ApplyTo(employeeToPatch);
_mapper.Map(employeeToPatch, employeeEntity);
_repository.Save();
return NoContent();
}
复制代码
从请求体接受JsonPatchDocument对象。接下来，我们检查patchDoc对象是否存在空值，以及公司和员工是否存在于数据库中。然后，我们把Employee类型映射到EmployeeForUpdateDto类型。这对我们来说很重要，因为patchDoc对象只能应用于EmployeeForUpdateDto类型。在调用ApplyTo方法之后，我们将再次映射到员工类型，并将更改保存到数据库中。

客户端实现

现在，让我们打开客户端项目，并在Services文件夹中添加一个新服务:

复制代码
public class HttpClientPatchService : IHttpClientServiceImplementation
{
private static readonly HttpClient _httpClient = new HttpClient();

public HttpClientPatchService()
{
    _httpClient.BaseAddress = new Uri("https://localhost:5001/api/");
    _httpClient.Timeout = new TimeSpan(0, 0, 30);
    _httpClient.DefaultRequestHeaders.Clear();
}

public async Task Execute()
{
    throw new NotImplementedException();
}

}
复制代码
因此，这是HttpClient类的初始配置。一旦开始学习HttpClientFactory，我们将展示如何能够一次性进行配置，而不会为每个服务重复它。

在此之后，我们可以使用PatchAsync方法实现发送HTTP PATCH请求的逻辑:

复制代码
private async Task PatchEmployee()
{
var patchDoc = new JsonPatchDocument();
patchDoc.Replace(e => e.Name, “Sam Raiden Updated”);
patchDoc.Remove(e => e.Age);

var uri = Path.Combine("companies", "C9D4C053-49B6-410C-BC78-2D54A9991870", "employees", "80ABBCA8-664D-4B20-B5DE-024705497D4A");
var serializedDoc = JsonConvert.SerializeObject(patchDoc);
var requestContent = new StringContent(serializedDoc, Encoding.UTF8, "application/json-patch+json");

var response = await _httpClient.PatchAsync(uri, requestContent);
response.EnsureSuccessStatusCode();

}
复制代码
在这里，我们在JsonPatchDocument类的帮助下创建了一个新的Patch类。为了能够使用这个类，我们必须安装Microsoft.AspNetCore.JsonPatch。接下来，我们使用JsonPatchDocument类中的两个helper方法创建两个操作。然后，创建URI、序列化对象，并创建新的字符串内容。这里需要注意的重要一点是，我们没有使用System.Text中的JsonSerializer.Serialize()方法。而是使用Newtonsoft.Json的JsonConvert.SerializeObject()方法。我们必须这么做，因为PATCH文件不能很好地用System.Text.Json序列化，我们的API会收到400 bad request。

最后，我们使用PatchAsync方法发送请求，并确保响应有一个成功的状态码。

现在，让我们修改Execute方法:

public async Task Execute(){
　　await PatchEmployee();
}
将服务注册到Program类：

private static void ConfigureServices(IServiceCollection services)
{
//services.AddScoped<IHttpClientServiceImplementation, HttpClientCrudService>();
services.AddScoped<IHttpClientServiceImplementation, HttpClientPatchService>();
}
在PatchEmployee放置断点，并启动项目。

检查数据库：

我们可以看到Name列被修改，Age列被设置为默认值0。让我们看看如何使用HttpRequestMessage来实现同样的功能。

使用HttpRequestMessage发送PATCH请求

与前面处理所有HTTP请求时一样，我们将使用HttpRequestMessage类向服务器送PATCH请求。在本教程的前几篇文章中，我们已经讨论了这种方法的好处。

所以，让我们在HttpClientPatchService类中添加另一个方法:

复制代码
private async Task PatchEmployeeWithHttpRequestMessage()
{
var patchDoc = new JsonPatchDocument();
patchDoc.Replace(e => e.Name, “Sam Raiden”);
patchDoc.Add(e => e.Age, 28);

var uri = Path.Combine("companies", "C9D4C053-49B6-410C-BC78-2D54A9991870", "employees", "80ABBCA8-664D-4B20-B5DE-024705497D4A");
var serializedDoc = JsonConvert.SerializeObject(patchDoc);

var request = new HttpRequestMessage(HttpMethod.Patch, uri);
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Content = new StringContent(serializedDoc, Encoding.UTF8);
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json-patch+json");

var response = await _httpClient.SendAsync(request);
response.EnsureSuccessStatusCode();

}
复制代码
我们再次创建了JsonPatchDocument对象，但这一次，我们replace了员工的姓名，并add了年纪。准备URI并序列化对象。完成之后，我们创建一个新的HttpRequestMessage，提供我们想要使用的HTTP方法和URI。就像我们在所有的HttpRequestMessage示例中所做的那样，我们为请求添加了一个accept header、content和content type。最后，我们使用SendAsync方法发送请求，并确保响应中的状态码成功。

为了能够执行这个方法，我们必须在execute方法中调用它:

public async Task Execute()
{
//await PatchEmployee();
await PatchEmployeeWithHttpRequestMessage();
}
USB Microphone https://www.soft-voice.com/
Wooden Speakers https://www.zeshuiplatform.com/
亚马逊测评 www.yisuping.cn
深圳网站建设www.sz886.com