XmlSerializer로 XML 직렬화 작업하기

1. Введение

XML — аббревиатура от eXtensible Markup Language. Представьте себе очень строгого и разговорчивого JSON, способного много раз повторять «я структурированный, поверь мне!». XML — текстовый формат, в котором данные обрамляются тегами:

<Player>
  <Name>Aragorn</Name>
  <Health>100</Health>
</Player>

Зачем нам сериализовать объекты в XML в наши дни?

• XML은 여전히 대형(종종 레거시) 시스템 간 통합에서 널리 쓰여, 엄격한 스키마(XSD)로 검증해야 할 때 유리해.
• XML은 종종 엔터프라이즈 설정에서 쓰여(예: App.config와 Web.config — 구형 .NET에서의 사례).
• XML은 데이터 구조의 '자기 설명성'이 중요한 경우에 잘 맞아.

Интересный факт: XML은 처음부터 가능한 한 확장 가능하고 검증 가능한 형태로 설계되었어; 그래서 이름에 그런 뜻이 담겨 있고, 스키마 검사 같은 기능은 JSON에는 기본적으로 없는 장점이야.

XmlSerializer: главный герой

В .NET за сериализацию объектов в XML отвечает класс System.Xml.Serialization.XmlSerializer.

• Он превращает публичные свойства и поля объекта в элементы XML, и наоборот: по XML восстанавливает объект.
• Работает только с открытыми типами и членами классов.
• Не сериализует приватные поля и свойства — только то, что публично!
• Требует для работы наличия пустого конструктора у сериализуемого класса.

Обратите внимание: Если ваш класс не соответствует этим требованиям, XmlSerializer просто не сможет с ним работать — выдаст исключение на этапе сериализации или десериализации.

2. Простой пример — сериализация объекта в XML

Давайте рассмотрим, как сериализовать наш любимый класс Player в XML.

Шаг 1. Описываем класс

public class Player
{
    public string Name { get; set; }
    public int Health { get; set; }
    public bool IsAlive { get; set; }

    // 중요: 매개변수 없는 public 생성자가 필요해!
    public Player() { }

    // 선택사항: 편의를 위해
    public Player(string name, int health, bool isAlive)
    {
        Name = name;
        Health = health;
        IsAlive = isAlive;
    }
}

Шаг 2. Сериализуем в файл

using System.Xml.Serialization;

Player aragorn = new Player("Aragorn", 100, true);

// 1. Создаём сериализатор для типа Player
XmlSerializer serializer = new XmlSerializer(typeof(Player));

// 2. Открываем файл для записи (создастся, если не существует)
using FileStream fs = new FileStream("player.xml", FileMode.Create);

// 3. Сериализуем объект в XML
serializer.Serialize(fs, aragorn);

Результат (player.xml):

<?xml version="1.0"?>
<Player xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Name>Aragorn</Name>
  <Health>100</Health>
  <IsAlive>true</IsAlive>
</Player>

Визуальная схема простейшего процесса

메모리에 있는 객체  --->  XmlSerializer.Serialize()  --->  디스크에 저장된 XML 파일

3. Десериализация — «оживляем» объект из XML

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

using FileStream fs = new FileStream("player.xml", FileMode.Open);
XmlSerializer serializer = new XmlSerializer(typeof(Player));
Player player = (Player)serializer.Deserialize(fs);

Console.WriteLine($"이름: {player.Name}, 체력: {player.Health}, 살아있음: {player.IsAlive}");

В результате программа выдаст: 이름: Aragorn, 체력: 100, 살아있음: True

4. Сериализация в строку — не только в файл

Сериализация в строку

Не всегда хочется сериализовать объект в файл. Иногда, например, нужно передать XML как строку по сети или показать на экране.

using System.IO;
using System.Xml.Serialization;

Player player = new Player("Frodo", 42, true);

XmlSerializer serializer = new XmlSerializer(typeof(Player));
StringWriter stringWriter = new StringWriter();
serializer.Serialize(stringWriter, player);

string xmlString = stringWriter.ToString();
Console.WriteLine(xmlString); // XML 전체 문자열을 화면에 출력!

Десериализация из строки

Аналогично можно десериализовать объект не из файла, а из строки:

string xml = "<Player Name=\"Frodo\"><HP>42</HP></Player>";
XmlSerializer serializer = new XmlSerializer(typeof(Player));

using StringReader stringReader = new StringReader(xml);
Player frodo = (Player)serializer.Deserialize(stringReader);
Console.WriteLine(frodo.Name); // Frodo

5. Кастомизация XML: атрибуты для управления структурой

Иногда стандартное поведение вас не устраивает. XML получается слишком многословным или теги не совпадают с целевыми. На помощь приходят различные «магические» атрибуты — прямо указывают сериализатору, как представлять члены класса.

Самые полезные:

• [XmlElement]

  — задаёт имя элемента.

• [XmlAttribute]

  — делает поле атрибутом XML, а не элементом.

• [XmlIgnore]

  — исключает свойство из сериализации.

• [XmlArray]

  и

  [XmlArrayItem]

  — управляют упаковкой коллекций.

Пример использования:

public class Player
{
    [XmlAttribute]
    public string Name { get; set; }
    [XmlElement("HP")]
    public int Health { get; set; }
    [XmlIgnore]
    public bool IsTempSessionPlayer { get; set; }
}

Результирующий XML:

<Player Name="Aragorn">
  <HP>100</HP>
</Player>

Таблица основных атрибутов для сериализации

[XmlAttribute]

<Player Name="Aragorn">...</Player>

[XmlElement]

<HP>100</HP>

<Health>100</Health>

[XmlIgnore]

[XmlArray]

<Heroes> ... </Heroes>

[XmlArrayItem]

<Hero>...</Hero>

Пример сложной сериализации коллекции:

public class GameWorld
{
    [XmlArray("Heroes")]
    [XmlArrayItem("Hero")]
    public List<Player> Players { get; set; } = new List<Player>();
}

XML:

<GameWorld>
  <Heroes>
    <Hero Name="Legolas">
      <HP>90</HP>
    </Hero>
    <!-- ... -->
  </Heroes>
</GameWorld>

XML 커스터마이징에 대해서는 다음 강의에서 더 자세히 다룰게! :P