[KOSD] Perubahan FromQuery Model Binding daripada .NET o .NET8

Baru-baru ini, semasa memindahkan projek kami daripada .NET 6 ke .NET 8, rakan sepasukan saya Jeremy Chan menemui perubahan tidak berdokumen dalam tingkah laku mengikat model yang nampaknya muncul sejak .NET 7. Perubahan ini tidak dijelaskan dengan jelas dalam .NET rasmi dokumentasi, jadi ia boleh menjadi sesuatu yang mudah diabaikan oleh pembangun.

Untuk menggambarkan isu ini, mari mulakan dengan projek API Web yang ringkas dan teroka kaedah pengawal mudah yang menyerlahkan perubahan.

[ApiController]
public class FooController
{
  [HttpGet()]
  public async void Get([FromQuery] string value = "Hello")
  {
    Console.WriteLine($"Value is {value}");

    return new JsonResult() { StatusCode = StatusCodes.Status200OK };
  }
}

Kemudian kami menganggap bahawa kami telah mendayakan nullable dalam kedua-dua projek .NET 6 dan .NET 8.

<Project Sdk="Microsoft.NET.Sdk.Web">

    <PropertyGroup>
        <Nullable>enable</Nullable>
        ...
    </PropertyGroup>

    ...

</Project>

Situasi dalam .NET 6

Dalam .NET 6, apabila kami memanggil titik akhir dengan /foo?value=, kami akan menerima ralat berikut.

{
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-5bc66c755994b2bba7c9d2337c1e5bc4-e116fa61d942199b-00",
  "errors": {
    "value": [
      "The value field is required."
    ]
  }
}

Namun, jika kita menukar kaedah menjadi seperti berikut, ralat tidak akan berlaku.

public async void Get([FromQuery] string? value)
{
    if (value is null)
        Console.WriteLine($"Value is null!!!");
    else
        Console.WriteLine($"Value is {value}");

    return new JsonResult() { StatusCode = StatusCodes.Status200OK };
}

Log apabila memanggil titik akhir dengan /foo?value= kemudiannya akan menjadi "Nilai adalah batal!!!".

Oleh itu, kita boleh tahu bahawa rentetan pertanyaan tanpa nilai akan ditafsirkan sebagai batal. Itulah sebabnya akan berlaku ralat pengesahan apabila nilai tidak boleh dibatalkan.

Oleh itu, kita boleh mengatakan bahawa, untuk menjadikan titik akhir berfungsi dalam .NET 6, kita perlu mengubahnya menjadi seperti berikut untuk menjadikan nilai pilihan. Ini tidak akan menandakan nilai sebagai medan yang diperlukan.

public async void Get([FromQuery] string? value = "Hello")

Sekarang, jika kita memanggil titik akhir dengan /foo?value=, kita akan menerima melihat log "Nilai ialah Helo" yang dicetak.

Situasi dalam .NET 8 (dan .NET 7)

Kemudian bagaimana pula dalam .NET 8 dengan persediaan asal yang sama, iaitu seperti yang ditunjukkan di bawah.

public async void Get([FromQuery] string value = "Hello")

Dalam .NET 8, apabila kita memanggil titik akhir dengan /foo?value=, kita akan melihat log “Value is Hello” dicetak.

Jadi, apa yang berlaku di sini?

Dalam .NET 7, Antara Muka IParsable baharu telah diperkenalkan. Oleh itu, bermula dari .NET 7, IParsable.TryParse API digunakan untuk mengikat nilai parameter tindakan pengawal.

Penyelidikan awal menunjukkan bahawa, di bawah hud, .NET 7 dan seterusnya, pelaksanaan pengikatan model baharu digunakan dan ia menyebabkan perkara ini berlaku.

Rujukan

• [Cadangan API]: String harus melaksanakan IParsable;
• Minta bool dan string melaksanakan ISpanParsable.

KOSD, atau Kopi-O Siew Dai, ialah sejenis kopi Singapura yang saya gemari. Ia pada asasnya adalah secawan kopi dengan sedikit gula. Siri ini bertujuan untuk memblog tentang pengetahuan teknikal yang saya perolehi semasa menikmati secawan kecil Kopi-O Siew Dai.

Atas ialah kandungan terperinci [KOSD] Perubahan FromQuery Model Binding daripada .NET o .NET8. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!