Преобразуйте JSON в class C#!

Введите JSON, чтобы получить код class на C#, включая вложенные объекты! Поддержка: System.Text.Json [JsonPropertyName], .NET, ASP.NET Core.
JSON
Результат
 

Преобразуйте JSON в class C#!

Преобразует JSON в классы C# для System.Text.Json. Имена свойств переводятся в PascalCase, и у каждого свойства есть атрибут [JsonPropertyName], чтобы оно привязывалось точно к исходному ключу.

Избавляет от ручного перепечатывания моделей запросов и ответов ASP.NET Core, типов для вызовов HttpClient.GetFromJsonAsync<T>() к внешним API и классов данных в приложениях на Unity или MAUI.

Как пользоваться

  1. Вставьте JSON-ответ или конфигурационный файл.
  2. Введите имя корневого класса в Имя типа (например, PaymentResult).
  3. Поместите сгенерированные классы в файл .cs и добавьте свой namespace.
  4. Используйте их с JsonSerializer.Deserialize<PaymentResult>(json) или GetFromJsonAsync<PaymentResult>(url).

Пример

Вход (JSON)
{
  "paymentId": "pay_8f2k",
  "amount": 15000,
  "currency": "KRW",
  "approved": true,
  "approvedAt": "2024-05-01T12:30:00Z",
  "card": { "issuer": "VISA", "last4": "4242" },
  "metadata": null
}
Результат (C# · System.Text.Json)
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-ссылках.
  • Свойство с тем же именем, что и его класс, в C# недопустимо, поэтому оно получает суффикс Value (например, RootValue).
  • Массив верхнего уровня даёт комментарий // Root: List<RootItem> и класс элемента.

Сценарии использования

Вызов внешних API через HttpClient

Преобразуйте пример ответа API платежей или отслеживания доставки и используйте его как тип в await http.GetFromJsonAsync<PaymentResult>(url) вместо того, чтобы вытаскивать поля по одному из JsonDocument.

Модели payload вебхуков в ASP.NET Core

Сгенерируйте классы по payload, который отправляет вам сторонний сервис, и принимайте их как параметр [FromBody] — привязка модели и валидация будут работать как обычно.

appsettings и файлы игровых данных

Если зафиксировать структуру JSON-файла данных, который читает приложение на Unity или консольное приложение, в классах, то изменение файла данных сразу проявится как ошибка десериализации.

Примечания и ограничения

  • Вывод для Newtonsoft.Json ([JsonProperty]) не генерируется. Если вы используете Json.NET, замените атрибуты на [JsonProperty("key")].
  • Строки с датами остаются string. Для значений ISO 8601 достаточно сменить тип на DateTime или DateTimeOffset, и System.Text.Json их разберёт.
  • Target-typed 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 на него.

Можно ли оставить имена свойств в camelCase?

Вывод следует соглашению C# о PascalCase. Исходный ключ хранится в [JsonPropertyName], так что свойства можно свободно переименовывать, пока атрибут на месте.

Работает ли это с JsonUtility в Unity?

JsonUtility обрабатывает только публичные поля классов с [Serializable], а не свойства, и игнорирует [JsonPropertyName]. В Unity используйте вывод вместе с пакетом Newtonsoft.Json или с System.Text.Json.