README.md

xml-parser

Библиотека для cериализации данных в xml

Библиотека предназначена для записи и чтения данных XML для

Установка

Для установки необходимо:

• Скачать файл *.ospx из раздела releases
• Воспользоваться командой:

opm install -f <ПутьКФайлу>

или

opm install xml-parser

Особенности работы

Чтение данных из XML

• При чтении библиотека получает для каждого узла Соответствие со следующими ключами
  • _Атрибуты - соответствие с атрибутами узла
  • _Комментарий - Строка - строка содержащая комментарии узла
  • _CDATA - Строка - строка содержащая данные CDATA узла
  • _Значение - Строка - строка значение узла
  • _Элементы - Массив, Соответствие - вложенные узлы
• После чтение по умолчанию производится попытка упрощения результата чтения
  • если заполнено только _Значение - тогда присваивается результату чтения узла _Значение
  • если заполнено только _Элементы - тогда присваивается результату чтения узла _Элементы
  • во всех остальных случаях присутствуют только заполненные ключи соответствия

Запись данных в XML

При сериализации данных используются предопределенные ключи:

• _Атрибуты - соответствие с атрибутами узла
• _Комментарий - Строка - строка содержащая комментарии узла
• _CDATA - Строка - строка содержащая данные CDATA узла
• _Значение - Строка - строка значение узла
• _Элементы - Массив, Соответствие - вложенные узлы

Пример работы:

• Чтение данных из файла

  #Использовать xml-parser
  
    //<ФайлПФР>
    //    <ИмяФайла>
    //        <НазваниеФормата>fb2</НазваниеФормата>
    //        <НазваниеПрограммы />
    //    </ИмяФайла>
    //</ФайлПФР>

    ПутьКФайлу = "ТутНуженПутьКФайлу";

	ПроцессорXML = Новый СериализацияДанныхXML();
	
	РезультатЧтения = ПроцессорXML.ПрочитатьИзФайла(ПутьКФайлу);

    Сообщить(РезультатЧтения["ФайлПФР"]["ИмяФайла"]["НазваниеФормата"]);

• Запись данных в файл

  #Использовать xml-parser
  
  ПутьКФайлу = "ТутНуженПутьКФайлу";

	ПроцессорXML = Новый СериализацияДанныхXML();
	ДанныеЗаписиXML = Новый Структура("name", "Наименование");

	ПроцессорXML.ЗаписатьВФайл(ДанныеЗаписиXML, ПутьКФайлу);
   
    // Содержимое файла 
    //<name>Наименование</name>

Публичный интерфейс

Документация публичного интерфейса (в разработке)

Доработка

Доработка проводится по git-flow. Жду ваших PR.

Лицензия

Смотри файл LICENSE.