JSON na klasę C#

Przykładowy wynik

Dla wejścia:

{ "firstName": "Alice", "age": 30, "emails": ["a@a.com"], "address": { "city": "Madrid" } }

Wynik System.Text.Json (C# 10+):

public class User
{
    [JsonPropertyName("firstName")]
    public string FirstName { get; set; } = default!;

    [JsonPropertyName("age")]
    public int Age { get; set; }

    [JsonPropertyName("emails")]
    public List<string> Emails { get; set; } = new();

    [JsonPropertyName("address")]
    public Address Address { get; set; } = default!;
}

public class Address
{
    [JsonPropertyName("city")]
    public string City { get; set; } = default!;
}

Mapowanie typów

Opcje atrybutów

• System.Text.Json ([JsonPropertyName("foo")]), preferowany dla .NET 6+ i nowych projektów.
• Newtonsoft.Json ([JsonProperty("foo")]), dla starszych projektów albo gdy potrzebujesz funkcji specyficznych dla Newtonsoft.
• Brak, nazwy właściwości dokładnie odpowiadają kluczom JSON (działa tylko, jeśli klucze JSON są już w PascalCase).

Częste błędy

• Używanie int dla pola, które może się przepełnić. Jeśli Twój JSON ma wartości przekraczające int.MaxValue, użyj long. Generator awansuje automatycznie, gdy widzi duże wartości.
• Brak [JsonIgnore] dla właściwości obliczanych. Jeśli dodasz pomocnicze właściwości do wygenerowanej klasy, oznacz je [JsonIgnore], bo inaczej będą serializowane na wyjściu.
• Zapomnienie o parsowaniu niezależnym od kultury. Pola decimal powinny deserializować się z CultureInfo.InvariantCulture; System.Text.Json robi to domyślnie, Newtonsoft z ustawieniami globalnymi.
• Zaufanie generatorowi na jednej próbce. Nullowalność i typy elementów tablicy są zgadywane z tego, co widzi. Zawsze sprawdź adnotacje nullowalności względem rzeczywistego zachowania Twojego API.