Язык программирования C#9 и платформа .NET5 - Эндрю Троелсен

и записью чисел. В табл. 20.14 перечислены значения, доступные в перечислении JsonNumberHandling.

Перечисление JsonNumberHandling имеет атрибут flags, который делает возможным побитовое сочетание его значений. Например, если вы хотите читать строки (и числа) и записывать числа в виде строк, тогда применяйте следующую настройку:

JsonSerializerOptions options = new()

{

   ...

   NumberHandling = JsonNumberHandling.AllowReadingFromString &

                    JsonNumberHandling.WriteAsString

};

При таком изменении данные JSON, созданные для класса Car, будут выглядеть так:

{

  "canFly": true,

  "canSubmerge": false,

  "theRadio": {

    "hasTweeters": true,

    "hasSubWoofers": false,

    "stationPresets": [

      "89.3",

      "105.1",

      "97.1"

    ],

    "radioId": "XF-552RR6"

  },

  "isHatchBack": false

}

Потенциальные проблемы, связанные с производительностью, при использовании JsonSerializerOption

В случае применения класса JsonSerializerOption лучше всего создать единственный экземпляр и многократно использовать его повсюду в приложении. С учетом сказанного модифицируйте операторы верхнего уровня и методы, относящиеся к JSON, как показано ниже:

JsonSerializerOptions options = new()

{

    PropertyNameCaseInsensitive = true,

    PropertyNamingPolicy = JsonNamingPolicy.CamelCase,

    IncludeFields = true,

    WriteIndented = true,

    NumberHandling =

      JsonNumberHandling.AllowReadingFromString |

      JsonNumberHandling.WriteAsString

};

SaveAsJsonFormat(options, jbc, "CarData.json");

Console.WriteLine("=> Saved car in JSON format!");

SaveAsJsonFormat(options, p, "PersonData.json");

Console.WriteLine("=> Saved person in JSON format!");

static void SaveAsJsonFormat<T>(JsonSerializerOptions options,

  T objGraph, string fileName)

=> File.WriteAllText(fileName,

 System.Text.Json.JsonSerializer.Serialize(objGraph, options));

Стандартные настройки свойств JsonSerializer для веб-приложений

При построении веб-приложений вы можете применять специализированный конструктор для установки следующих свойств:

PropertyNameCaseInsensitive = true,

PropertyNamingPolicy = JsonNamingPolicy.CamelCase,

NumberHandling = JsonNumberHandling.AllowReadingFromString

Вы по-прежнему можете устанавливать дополнительные свойства через инициализацию объектов, например:

JsonSerializerOptions options = new(JsonSerializerDefaults.Web)

{

  WriteIndented = true

};

Сериализация коллекций объектов

 Сериализация коллекций объектов в данные JSON выполняется аналогично сериализации одиночного объекта. Поместите приведенную далее локальную функцию в конец операторов верхнего уровня:

static void SaveListOfCarsAsJson(JsonSerializerOptions options, string fileName)

{

    // Сохранить список List<T> объектов JamesBondCar.

    List<JamesBondCar> myCars = new()

    {

  new JamesBondCar { CanFly = true, CanSubmerge = true },

        new JamesBondCar { CanFly = true, CanSubmerge = false },

        new JamesBondCar { CanFly = false, CanSubmerge = true },

        new JamesBondCar { CanFly = false, CanSubmerge = false },

    };

    File.WriteAllText(fileName,

        System.Text.Json.JsonSerializer.Serialize(myCars, options));

    Console.WriteLine("=> Saved list of cars!");

}

В заключение добавьте следующую строку, чтобы задействовать новую функцию:

SaveListOfCarsAsJson(options, "CarCollection.json");

Десериализация объектов и коллекций объектов

Как и десериализация XML, десериализация JSON является противоположностью сериализации. Показанная ниже функция будет десериализировать данные JSON в тип, заданный при вызове обобщенной версии метода:

static T ReadAsJsonFormat<T>(JsonSerializerOptions options,

  string fileName) =>

    System.Text.Json.JsonSerializer.Deserialize<T>

      (File.ReadAllText(fileName), options);

Добавьте к операторам верхнего уровня следующий код для восстановления объектов (или списка объектов) из данных JSON:

JamesBondCar savedJsonCar =

    ReadAsJsonFormat<JamesBondCar>(options, "CarData.json");

Console.WriteLine("Read Car: {0}", savedJsonCar.ToString());

List<JamesBondCar> savedJsonCars =

    ReadAsJsonFormat<List<JamesBondCar>>(options, "CarCollection.json");

Console.WriteLine("Read Car: {0}", savedJsonCar.ToString());

Резюме

 Глава начиналась с демонстрации использования типов Directory(Info) и File(Info). Вы узнали, что эти классы позволяют манипулировать физическими файлами и каталогами на жестком диске. Затем вы ознакомились с несколькими классами, производными от абстрактного класса Stream. Поскольку производные от Stream типы оперируют с низкоуровневым потоком байтов, пространство имен System.IO предлагает многочисленные типы средств чтения/записи (например, StreamWriter, StringWriter и BinaryWriter), которые упрощают процесс. Попутно вы взглянули на функциональность типа DriveType, научились наблюдать за файлами с применением типа FileSystemWatcher и выяснили, каким образом взаимодействовать с потоками в асинхронной манере.

В главе также рассматривались службы сериализации объектов. Вы видели, что платформа .NET Core использует граф объектов, чтобы учесть полный набор связанных объектов, которые должны сохраняться в потоке. В заключение вы поработали с сериализацией и десериализацией XML и JSON.

Глава 21

Доступ к данным с помощью ADO.NET

Внутри платформы .NET Core определено несколько пространств имен, которые позволяют взаимодействовать с реляционными базами данных. Все вместе эти пространства имен известны как ADO.NET. В настоящей главе вы сначала ознакомитесь с общей ролью инфраструктуры ADO.NET, а также основными типами и пространствами имен, после чего будет обсуждаться тема поставщиков данных ADO.NET. Платформа .NET Core поддерживает многочисленные поставщики данных (как являющиеся частью .NET Core, так и доступные от независимых разработчиков), каждый из которых оптимизирован для взаимодействия с конкретной системой управления базами данных (СУБД), например, Microsoft SQL Server, Oracle, MySQL и т.д.

Освоив общую функциональность, предлагаемую различными поставщиками данных, вы узнаете о паттерне фабрики поставщиков данных. Вы увидите, что с использованием типов из пространства имен System.Data (включая System.Data.Common, а также специфичные для поставщиков данных пространства имен вроде Microsoft.Data.SqlClient, System.Data.Odbc и доступное только в Windows пространство имен System.Data.Oledb) можно строить единственную кодовую базу, которая способна динамически выбирать поставщик данных без необходимости в повторной компиляции или развертывании кодовой базы приложения.

Далее вы научитесь работать напрямую с поставщиком баз данных SQL Server, создавая и открывая подключения для извлечения данных и затем вставляя, обновляя и удаляя данные, и ознакомитесь с темой транзакций базы данных. Наконец, вы запустите средство массового копирования SQL Server с применением ADO.NET для загрузки списка записей внутрь базы данных.

На заметку! Внимание в настоящей главе сконцентрировано на низкоуровневой инфраструктуре ADO.NET. Начиная с главы 22, будет раскрываться инфраструктура объектно-реляционного отображения (object-relational mapping — ORM) производства Microsoft под названием Entity Framework (EF) Core. Поскольку инфраструктура EF Core для доступа к данным внутренне использует ADO.NET, хорошее понимание принципов работы ADO.NET жизненно важно при поиске и устранении проблем при доступе к данным. Кроме того, существуют задачи, решить