GameDev: разработка на Unity3D

#сериализация #десериализация

Приветствую 👋
Сегодня говорим про конвертеры в JsonNet. Первая часть статьи про сериализацию и десериализацию тут

Конвертеры в JsonNET представляют собой механизм для настройки пользовательской сериализации и десериализации определенных типов данных или объектов в формате JSON. Дают возможность настроить процесс преобразования объектов в JSON и обратно.

JsonNet предоставляет два основных типа конвертеров:
- JsonConverter;
- JsonConverter<T>, где T - это конкретный тип данных, для которого конвертер применяется.

За определение логики сериализации и десериализации отвечают методы WriteJson и ReadJson, затронем их ниже по тексту.

Как работают конвертеры:

Наследование - создание собственных классов наследованием от JsonConverter или JsonConverter<T>.

Сериализация:
В методе WriteJson определяем преобразование объекта в JSON.
Создаем JSON объекты, устанавливаем свойства и вызываем методы для добавления данных в JSON строку.

Десериализация:
В методе ReadJson определяем преобразование JSON обратно в объект.
Читаем свойства из JSON строки, создаем и инициализируем объекты, затем возвращаем получившийся объект.

Рассмотрим пример простого конвертера для преобразования строки в верхний регистр:

В этом примере UpperCaseConverter преобразует строку в верхний регистр как при сериализации, так и при десериализации.

using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
using System;

public class UpperCaseConverter : JsonConverter<string>
{
    public override void WriteJson(JsonWriter writer, string value, JsonSerializer serializer)
    {
        writer.WriteValue(value.ToUpper());
    }

    public override string ReadJson(JsonReader reader, Type objectType, string existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        if (reader.Value == null)
            return null;

        return reader.Value.ToString().ToUpper();
    }
}
Применение этого конвертера:

class Program
{
    static void Main()
    {
        var settings = new JsonSerializerSettings
        {
            Converters = { new UpperCaseConverter() }
        };

        string json = JsonConvert.SerializeObject("hello", settings);
        Console.WriteLine(json); // Output: "HELLO"

        string value = JsonConvert.DeserializeObject<string>(json, settings);
        Console.WriteLine(value); // Output: "HELLO"
    }
}

Настройка единой конфигурации сериализации и десериализации для всего проекта.
Класс JsonSerializerSettings позволяет настроить единую конфигурацию сериализации и десериализации для всего проекта и управлять процессом из единого места.

Разберем подробнее
Настроим ContractResolver и NamingStrategy с помощью JsonSerializerSettings.
Contract Resolver (ContractResolver) - определяет, как JsonNet будет находить и настраивать контракты для сериализации и десериализации. Позволяет контролировать, какие свойства будут включены в процесс, игнорировать некоторые свойства, управлять настройками атрибутов и т. д.

Naming Strategy (NamingStrategy) - позволяет управлять форматированием имен свойств в JSON, определяет, как будут преобразованы имена свойств объектов в имена полей JSON и наоборот.

Рассмотрим пример использования JsonSerializerSettings:

using Newtonsoft.Json;
using Newtonsoft.Json.Serialization;

class Program
{
    static void Main()
    {
        var settings = new JsonSerializerSettings
        {
            ContractResolver = new DefaultContractResolver
            {
                NamingStrategy = new CamelCaseNamingStrategy() // Use CamelCase naming strategy
            },
            Formatting = Formatting.Indented // Optional formatting for readability
        };

        var data = new { UserName = "Sergey", UserAge = 40 };

        string json = JsonConvert.SerializeObject(data, settings);
        Console.WriteLine(json);
    }
}

В примере ContractResolver устанавливается в DefaultContractResolver, а NamingStrategy в CamelCaseNamingStrategy, что преобразует имена свойств в стиле Camel Case.

Хорошего дня!

650 views08:56