HttpClient obtener JSON como AsyncEnumerable

Se ha añadido un nuevo método de extensión, GetFromJsonAsAsyncEnumerable<T>, a la parte de HttpClient de .NET 8. Este nuevo método toma el JSON del cuerpo de la respuesta y lo deserializa en una operación enumerable asíncrona.

La firma completa del método de extensión es la siguiente:

[RequiresUnreferencedCode(HttpContentJsonExtensions.SerializationUnreferencedCodeMessage)]
[RequiresDynamicCode(HttpContentJsonExtensions.SerializationDynamicCodeMessage)]
public static IAsyncEnumerable<TValue?> GetFromJsonAsAsyncEnumerable<TValue>(
    this HttpClient client,
    [StringSyntax(StringSyntaxAttribute.Uri)] string? requestUri,
    CancellationToken cancellationToken = default) =>
    GetFromJsonAsAsyncEnumerable<TValue>(client, requestUri, options: null, cancellationToken);

Veamos cómo usarlo. Lo primero a notar es que GetFromJsonAsAsyncEnumerable no es async, ya que la parte asíncrona la gestiona el IAsyncEnumerable que se devuelve.

IAsyncEnumerable<Hotel> hotels = client.GetFromJsonAsAsyncEnumerable<Hotel>("https://foo.bar/api/hotels");

A continuación, tomamos el resultado hotels y usamos un await foreach para esperar e iterar sobre cada elemento del IAsyncEnumerable.

await foreach (var hotel in hotels)
{
    Console.WriteLine($"{hotel.stars}* | {hotel.name}");
}

Dentro del cuerpo del foreach puedes hacer lo que quieras con tu hotel. Ejemplo completo a continuación:

using System.Net.Http.Json;

using var client = new HttpClient();
IAsyncEnumerable<Hotel> hotels = client.GetFromJsonAsAsyncEnumerable<Hotel>("https://foo.bar/api/hotels");

await foreach (var hotel in hotels)
{
    Console.WriteLine($"{hotel.stars}* | {hotel.name}");
}

public record Hotel(string name, string address, int stars);