使用.NET 6開發TodoList應用(10)——實作DELETE請求以及HTTP請求冪等性

系列導航及源代碼

• 使用.NET 6開發TodoList應用文章索引

需求

先說明一下關于原本想要去更新的PATCH請求的文章，從目前試驗的情況來看，如果是按照.NET 6的專案結構（即只使用一個Program.cs完成程式初始化），那微軟官方給出的檔案目前還沒有對應地更新，按照之前的方式進行JsonPatch的配置是不行的，目前已經有人在Github微軟的官方檔案Repo下提了ISSUE: .NET 6: JsonPatch in ASP.NET Core web API，并且因為PATCH的使用頻率并不高，所以我暫時跳過那篇，先把進度繼續往后走，看微軟什么時候把這個issue解決一下我再看情況把PATCH那一節補上，

本文我們來看最后一個常用HTTP請求型別：DELETE，

目標

實作并驗證應用正確處理DELETE請求，并對HTTP請求的冪等性做簡單的介紹，

原理與思路

經過關于Create、Update、Get的實作，對于Delete的實作我們的思路是很清晰的，我們需要創建Delete的Command及其Handler，然后在Controller中通過Mediatr發送請求即可，

實作

在Application/TodoList下新建DeleteTodoList檔案夾，并新建DeleteTodoListCommand：

• DeleteTodoListCommand.cs

using MediatR;
using TodoList.Application.Common.Exceptions;
using TodoList.Application.Common.Interfaces;

namespace TodoList.Application.TodoLists.Commands.DeleteTodoList;

public class DeleteTodoListCommand : IRequest
{
    public Guid Id { get; set; }
}

public class DeleteTodoListCommandHandler : IRequestHandler<DeleteTodoListCommand>
{
    private readonly IRepository<Domain.Entities.TodoList> _repository;

    public DeleteTodoListCommandHandler(IRepository<Domain.Entities.TodoList> repository)
    {
        _repository = repository;
    }

    public async Task<Unit> Handle(DeleteTodoListCommand request, CancellationToken cancellationToken)
    {
        var entity = await _repository.GetAsync(request.Id);
        if (entity == null)
        {
            throw new NotFoundException(nameof(TodoList), request.Id);
        }

        await _repository.DeleteAsync(entity,cancellationToken);
        // 對于Delete操作，演示中并不回傳任何實際的物件，可以結合實際需要回傳特定的物件，Unit物件在MediatR中表示Void
        return Unit.Value;
    }
}

在Controller中添加Delete的介面處理：

• TodoListController.cs

// 省略其他...
[HttpDelete("{id:guid}")]
public async Task<ApiResponse<object>> Delete(Guid id)
{
    return ApiResponse<object>.Success(await _mediator.Send(new DeleteTodoListCommand { Id = id }));
}

這里可能值得強調的是關于EntityFrameworkCore中對于關聯物體DELETE操作的處理方式：

打開Infrastructure/Migrations檔案夾，我們可以在遷移領域物體的那次Migration生成的.Designer.cs檔案中發現這樣一段配置：

// 省略其他...
modelBuilder.Entity("TodoList.Domain.Entities.TodoItem", b =>
    {
        b.HasOne("TodoList.Domain.Entities.TodoList", "List")
            .WithMany("Items")
            .HasForeignKey("ListId")
            .OnDelete(DeleteBehavior.Cascade)
            .IsRequired();
        b.Navigation("List");
    });

可以看到在OnDelete中配置的是DeleteBehavior.Cascade行為模式，關于DeleteBehavior，可以參考Referential Constraint Action Options，實際上總共有七種可以設定的行為模式：

• DeleteBehavior.Cascade
• DeleteBehavior.NoAction
• DeleteBehavior.Restrict
• DeleteBehavior.SetNull
• DeleteBehavior.ClientCascade
• DeleteBehavior.ClientNoAction
• DeleteBehavior.ClientSetNull

關于這七種DeleteBehavior，可以參考這篇博文：Entity Framework Core 關聯洗掉，博主在其中進行了比較詳細的實驗和總結，

可以根據實際需要去顯式地配置DeleteBehavior，另外，習慣觀察生成的Migrations檔案，也是學習EFCore一些慣例或者說默認配置的很好的方法，

驗證

啟動Api專案，發送DELETE請求：

• 請求
  

• 回應
  

并且從資料庫里我們以可以發現，這條TodoList下包含的TodoItem也被一同洗掉了，

總結

到此為止HTTP常用的四大請求我們已經通過幾個例子講完了，關于HEAD請求OPTION請求以及遺留的PATCH請求后面會寫完，下一篇文章開始我們一起學習如何使用FluentValidation來進行請求引數校驗，

關于HTTP請求冪等性的介紹

首先明確兩個概念：

1. 什么叫做HTTP請求是否安全：如果我們執行請求后，對應的資源物體不發生改變，我們稱這個請求是安全的；
2. 什么叫做HTTP請求是否冪等：對于執行請求后產生的副作用（即指如果請求不安全，則稱其會產生副作用），請求執行一次和執行多次的副作用是相同的，我們稱這個請求是冪等的，很顯然安全的請求一定是冪等的，

了解了這兩個概念后，我們直接來看這張表格，快速地對HTTP請求的安全性和冪等性有一個認識，

鑒于PATCH方法并不常用，那么重點需要關注的主要就是POST請求，以及一部分的PUT請求（比如更新的欄位是在當前欄位值的基礎上進行計算而新得出這種場景，實際就不是冪等的，但是我們一般不推薦在Update時做這種型別的操作，更推薦的是把計算邏輯前置到介面回應處理前，以整體設定值的方式去Update物體），一般而言POST請求是用來創建資源的，如果不采取某種方式來保證執行結果的實際冪等性，那么該請求產生的副作用將是難以控制和處理的，

如何保證介面的冪等性？

正式因為并非所有的HTTP請求（在這里我們可以泛化到任意型別的介面請求）都是冪等的，而不管是應用程式內的容錯還是服務之間因為磁區導致的對請求的冪等性更為嚴格的要求（尤其是在分布式系統中，對于磁區導致的請求重試的場景），我們需要在設計和實作介面的時候，把冪等性設計考慮進來，提高介面的魯棒性，

總體來說，實作介面的冪等性有兩種思路：一種是通過代碼邏輯去限制重復呼叫出現的副作用；第二種是通過Token唯一性來保證同一個請求不會被呼叫多次，

通過代碼邏輯去限制副作用的實作方式有很多種：從前端/界面的層次上去人為限制請求的重復發送（比如按鈕置灰禁止點擊之類的），通過在資料庫層面應用鎖或使用唯一索引，通過在邏輯執行程序中應用鎖等方式，這種方式只能針對一些通過滿足某些判斷進行的邏輯實作，有其局限性，

通過Token唯一性保證冪等的思路大致是這樣：生成全域唯一的Token保存下來，并在前端頁面獲取保存，發送請求時連同Token一起發到后端，后端先進行Token校驗，校驗通過發送實際請求或執行邏輯，完成后洗掉舊Token并生成新Token，那么前端下次攜帶保存的舊Token來請求時，因為Token校驗不通過而拒絕繼續執行，這種方式就好比短信驗證碼，只有第一次攜帶這個驗證碼請求時會成功，后端判斷第一次請求有效后就會把這個驗證碼置為無效，下次你就無法攜帶相同的驗證碼繼續發起請求了，例子不是特別恰當，但是可以類比著進行理解，

參考資料

1. Referential Constraint Action Options
2. Entity Framework Core 關聯洗掉
3. 介面的冪等性，如何保證

標籤：.NET Core

上一篇：.NET6中一些常用組件的配置及使用記錄，持續更新中。。。

下一篇：C# 利用Autofac批量介面注入依賴【學習記錄】