Преобразует JSON в классы C# для System.Text.Json. Имена свойств переводятся в PascalCase, и у каждого свойства есть атрибут [JsonPropertyName], чтобы оно привязывалось точно к исходному ключу.
Избавляет от ручного перепечатывания моделей запросов и ответов ASP.NET Core, типов для вызовов HttpClient.GetFromJsonAsync<T>() к внешним API и классов данных в приложениях на Unity или MAUI.
Имя типа (например, PaymentResult)..cs и добавьте свой namespace.JsonSerializer.Deserialize<PaymentResult>(json) или GetFromJsonAsync<PaymentResult>(url).{
"paymentId": "pay_8f2k",
"amount": 15000,
"currency": "KRW",
"approved": true,
"approvedAt": "2024-05-01T12:30:00Z",
"card": { "issuer": "VISA", "last4": "4242" },
"metadata": null
}using System.Collections.Generic;
using System.Text.Json;
using System.Text.Json.Serialization;
public class PaymentResult
{
[JsonPropertyName("paymentId")]
public string PaymentId { get; set; } = string.Empty;
[JsonPropertyName("amount")]
public int Amount { get; set; }
[JsonPropertyName("currency")]
public string Currency { get; set; } = string.Empty;
[JsonPropertyName("approved")]
public bool Approved { get; set; }
[JsonPropertyName("approvedAt")]
public string ApprovedAt { get; set; } = string.Empty;
[JsonPropertyName("card")]
public Card Card { get; set; } = new();
[JsonPropertyName("metadata")]
public JsonElement? Metadata { get; set; }
}
public class Card
{
[JsonPropertyName("issuer")]
public string Issuer { get; set; } = string.Empty;
[JsonPropertyName("last4")]
public string Last4 { get; set; } = string.Empty;
}
У каждого свойства есть [JsonPropertyName], поэтому paymentId ↔ PaymentId сопоставляются независимо от правил регистра. metadata всегда равен null, так что его тип неизвестен, и он становится JsonElement?. Строковые и объектные свойства получают инициализаторы string.Empty / new(), чтобы код компилировался без предупреждений о nullable.
[JsonPropertyName("originalKey")] на каждом свойстве плюс using System.Text.Json.Serialization;.string, int, long для целых больше 32 бит, double для дробных, bool и List<T> для массивов.JsonElement, при этом добавляется using System.Text.Json;.null, становятся nullable (int?, string?).= string.Empty; или = new();, чтобы избежать предупреждения CS8618 о nullable-ссылках.Value (например, RootValue).// Root: List<RootItem> и класс элемента.Преобразуйте пример ответа API платежей или отслеживания доставки и используйте его как тип в await http.GetFromJsonAsync<PaymentResult>(url) вместо того, чтобы вытаскивать поля по одному из JsonDocument.
Сгенерируйте классы по payload, который отправляет вам сторонний сервис, и принимайте их как параметр [FromBody] — привязка модели и валидация будут работать как обычно.
Если зафиксировать структуру JSON-файла данных, который читает приложение на Unity или консольное приложение, в классах, то изменение файла данных сразу проявится как ошибка десериализации.
[JsonProperty]) не генерируется. Если вы используете Json.NET, замените атрибуты на [JsonProperty("key")].string. Для значений ISO 8601 достаточно сменить тип на DateTime или DateTimeOffset, и System.Text.Json их разберёт.new() и string? предполагают C# 9+ с включённым nullable-контекстом (по умолчанию начиная с .NET 6).record и required не генерируются. Для неизменяемых моделей замените { get; set; } на { get; init; }.[JsonPropertyName], даже когда ключ уже совпадает?System.Text.Json по умолчанию чувствителен к регистру. В консольных или worker-проектах без собственных JsonSerializerOptions paymentId не привязался бы к PaymentId, поэтому атрибут пишется всегда — чтобы всё работало при любой конфигурации.
JsonElement??Проверьте ValueKind, затем используйте GetString(), GetInt32() или Deserialize<T>(). Когда реальный тип станет известен, чище заменить JsonElement на него.
Вывод следует соглашению C# о PascalCase. Исходный ключ хранится в [JsonPropertyName], так что свойства можно свободно переименовывать, пока атрибут на месте.
JsonUtility обрабатывает только публичные поля классов с [Serializable], а не свойства, и игнорирует [JsonPropertyName]. В Unity используйте вывод вместе с пакетом Newtonsoft.Json или с System.Text.Json.