HttpClient obter JSON como AsyncEnumerable

Um novo método de extensão, GetFromJsonAsAsyncEnumerable<T>, foi adicionado ao HttpClient no .NET 8. Esse novo método pega o JSON do corpo da resposta e o desserializa em uma operação enumerável assíncrona.

A assinatura completa do método de extensão é a seguinte:

[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);

Vamos ver como usá-lo. A primeira coisa a notar é que GetFromJsonAsAsyncEnumerable não é async, porque a parte assíncrona é tratada pelo IAsyncEnumerable retornado.

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

Em seguida, pegamos o resultado hotels e usamos um await foreach para aguardar e iterar sobre cada elemento do IAsyncEnumerable.

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

Dentro do corpo do foreach você pode fazer o que quiser com o seu hotel. Veja o exemplo completo abaixo:

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);