CKTIS / C#
Utf8JsonReader — четене на JSON токени от UTF-8
Utf8JsonReader от System.Text.Json чете JSON байтове, кодирани в UTF-8, токен по токен и само напред. Позволява да избирате нужните стойности, без да изграждате дърво на документа или да десериализирате документа в обекти.
Версия: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Синтаксис
var reader = new Utf8JsonReader(utf8Json);
while (reader.Read())
{
// Inspect reader.TokenType and read the current token's value.
}Utf8JsonReader е променлив ref struct от System.Text.Json, наличен в .NET 10. Приема ReadOnlySpan<byte> или ReadOnlySequence<byte>. Не изгражда дърво на документа; извикващият код сам интерпретира последователните токени и структурата на JSON.
Read() преминава към следващия токен, а TokenType показва вида му. Методи като GetInt32() прочитат текущата стойност, без да придвижват четеца. Проверявайте вида на токена, преди да ги извикате; числото трябва също да се побира в целевия тип. ValueTextEquals() сравнява име или текст, като отчита escape последователностите в JSON, без да създава междинен string.
Четецът не може да се съхранява в поле на клас или да се запазва през граница await. Подайте го с ref на помощна функция, която трябва да придвижи оригиналния четец; копието има независима позиция. При вход с няколко сегмента проверете HasValueSequence, преди да изберете ValueSequence или ValueSpan.
Конструкторът в примера предполага цял документ. При вход на порции използвайте isFinalBlock, запазете CurrentState и непрочетените байтове, посочени от BytesConsumed, а след подаване на още данни създайте нов четец. Самото състояние не съхранява тези байтове. Когато Read() открие синтактична грешка в JSON, хвърля изключение JsonException. Методът обаче може да разпознае низ в кавички като токен дори ако низът съдържа невалидни UTF-8 последователности. При декодиране на такъв токен GetString() може да хвърли InvalidOperationException вместо JsonException. Коментарите и крайните запетаи по подразбиране не са разрешени.
Примери
using System;
using System.Text.Json;
ReadOnlySpan<byte> json = "{\"name\":\"Ada\",\"age\":25}"u8;
var reader = new Utf8JsonReader(json);
while (reader.Read())
{
if (reader.TokenType == JsonTokenType.PropertyName &&
reader.ValueTextEquals("age"u8))
{
if (!reader.Read() || reader.TokenType != JsonTokenType.Number)
throw new JsonException("Expected a number.");
Console.WriteLine(reader.GetInt32());
}
}
Резултат
25
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.