Компонент для работы с xml delphi. Использование XML Document Object Model

30.10.2019 Звуковые устройства

Язык XML все чаще используется для хранения информации, обмена ею между приложениями и Web-узлами. Во многих приложениях этот язык применяется в качестве базового для хранения данных, в других - для экспортирования и импортирования XML-данных. Из этого следует, что разработчикам пора задуматься над тем, как можно использовать XML-данные в собственных приложениях.

В этой статье мы рассмотрим XML Document Object Model (DOM) и ее реализацию фирмой Microsoft - Microsoft XML DOM.

XML DOM - это объектная модель, предоставляющая в распоряжение разработчика объекты для загрузки и обработки XML-файлов. Объектная модель состоит из следующих основных объектов: XMLDOMDocument, XMLDOMNodeList, XMLDOMNode, XMLDOMNamedNodeMap и XMLDOMParseError. Каждый из этих объектов (кроме XMLDOMParseError) содержит свойства и методы, позволяющие получать информацию об объекте, манипулировать значениями и структурой объекта, а также перемещаться по структуре XML-документа.

Рассмотрим основные объекты XML DOM и приведем несколько примеров их использования в Borland Delphi.

Использование XML DOM в Borland Delphi

Для того чтобы использовать Microsoft XML DOM в Delphi-приложениях, необходимо подключить к проекту соответствующую библиотеку типов. Для этого мы выполняем команду Project | Import Type Library и в диалоговой панели Import Type Library выбираем библиотеку Microsoft XML version 2.0 (Version 2.0), которая обычно находится в файле Windows\System\MSXML.DLL

После нажатия кнопки Create Unit будет создан интерфейсный модуль MSXML_TLB, который позволит нам воспользоваться объектами XML DOM: DOMDocument, XMLDocument, XMLHTTPRequest и рядом других, реализованных в библиотеке MSXML.DLL. Ссылка на модуль MSXML_TLB должна быть указана в списке Uses.

Устройство XML DOM

Document Object Model представляет XML-документ в виде древовидной структуры, состоящей из ветвей. Программные интерфейсы XML DOM позволяют приложениям перемещаться по дереву документа и манипулировать его ветвями. Каждая ветвь может иметь специфический тип (DOMNodeType), согласно которому определяются родительская и дочерние ветви. В большинстве XML-документов можно встретить ветви типа element, attribute и text. Атрибуты (attribute) представляют собой особый вид ветви и не являются дочерними ветвями. Для управления атрибутами используются специальные методы, предоставляемые объектами XML DOM.

Помимо реализации рекомендованных World Wide Web Consortium (W3C) интерфейсов, Microsoft XML DOM содержит методы, поддерживающие XSL, XSL Patterns, Namespaces и типы данных. Например, метод SelectNodes позволяет использовать синтаксис шаблонов XSL (XSL Pattern Syntax) для поиска ветвей по определенному контексту, а метод TransformNode поддерживает использование XSL для выполнения трансформаций.

Тестовый XML-документ

В качестве примера XML-документа возьмем каталог музыкальных CD-ROM, который имеет следующую структуру :

Empire Burlesque Bob Dylan USA Columbia 10.90 1985 Hide your heart Bonnie Tylor UK CBS Records 9.90 1988 ... Unchain my heart Joe Cocker USA EMI 8.20 1987

Теперь мы готовы приступить к рассмотрению объектной модели XML DOM, знакомство с которой начнем с объекта XMLDOMDocument.

XML-документ - объект XMLDOMDocument

Работа с XML-документом начинается с его загрузки. Для этого мы используем метод Load, который имеет всего один параметр, указывающий URL загружаемого документа. При загрузке файлов с локального диска указывается только полное имя файла (протокол file:/// в данном случае можно опустить). Если XML-документ хранится в виде строки, для загрузки такого документа следует использовать метод LoadXML.

Для управления способом загрузки документа (синхронный или асинхронный) используется свойство Async. По умолчанию это свойство имеет значение True, указывающее на то, что документ загружается асинхронно и управление возвращается приложению еще до полной загрузки документа. В противном случае документ загружается синхронно, и тогда приходится проверять значение свойства ReadyState, чтобы узнать, загрузился документ или нет. Также можно создать обработчик события OnReadyStateChange, который получит управление при изменении значения свойства ReadyState.

Ниже показано, как загрузить XML-документ, используя метод Load:

Uses ... MSXML_TLB ... procedure TForm1.Button1Click(Sender: TObject); var XMLDoc: IXMLDOMDocument; begin XMLDoc:= CoDOMDocument.Create; XMLDoc.Async:= False; XMLDoc.Load(‘C:\DATA\DATA.xml’); // // Здесь располагается код, манипулирующий // XML-документом и его ветвями // XMLDoc:= Nil; end;

После того как документ загружен, мы можем обратиться к его свойствам. Так, свойство NodeName будет содержать значение #document, свойство NodeTypeString - значение document, свойство URL - значение file:///C:/DATA/DATA.xml.

Обработка ошибoк

Особый интерес представляют свойства, связанные с обработкой документа при его загрузке. Так, свойство ParseError возвращает объект XMLDOMParseError, содержащий информацию об ошибке, возникшей в процессе обработки документа.

Чтобы написать обработчик ошибки, можно добавить следующий код:

Var XMLError: IXMLDOMParseError; ... XMLDoc.Load(‘C:\DATA\DATA.xml’); XMLError:= XMLDoc.ParseError; If XMLError.ErrorCode <> 0 Then // // Здесь мы обрабатываем ошибку // Else Memo1.Lines.Add(XMLDoc.XML); ... XMLDoc:= Nil;

Чтобы узнать, какая информация возвращается в случае ошибки, изменим следующий элемент каталога:

Empire Burlesque Bob Dylan USA Columbia 10.90 1985

убрав закрывающий элемент во второй строке:</p><p> <CD> <TITLE>Empire Burlesque <ARTIST>Bob Dylan</ARTIST> <COUNTRY>USA</COUNTRY> <COMPANY>Columbia</COMPANY> <PRICE>10.90</PRICE> <YEAR>1985</YEAR> </CD> </p><p>Теперь напишем код, возвращающий значения свойств объекта XMLDOMParseError:</p><p>XMLError:= XMLDoc.ParseError; If XMLError.ErrorCode <> 0 Then With XMLError, Memo1.Lines do begin Add(‘Файл: ‘ + URL); Add(‘Код: ‘ + IntToStr(ErrorCode)); Add(‘Ошибка: ‘ + Reason); Add(‘Текст: ‘ + SrcText); Add(‘Строка: ‘ + IntToStr(Line)); Add(‘Позиция: ‘ + IntToStr(LinePos)); end Else Memo1.Lines.Add(XMLDoc.XML); End; </p><p>и выполним наше приложение. В результате получаем следующую информацию об ошибке .</p> <p>Как видно из приведенного примера, возвращаемой объектом XMLDOMParseError информации вполне достаточно для того, чтобы локализовать ошибку и понять причину ее возникновения.</p> <p>Теперь восстановим закрывающий элемент <TITLE> в нашем документе и продолжим обсуждение XML DOM.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h2> Доступ к дереву документа</h2> <p>Для доступа к дереву документа можно либо получить корневой элемент и затем перебрать его дочерние ветви, либо найти какую-то специфическую ветвь. В первом случае мы получаем корневой элемент через свойство DocumentElement, которое возвращает объект типа XMLDOMNode. Ниже показано, как воспользоваться свойством DocumentElement для того, чтобы получить содержимое каждого дочернего элемента:</p><p>Var Node: IXMLDOMNode; Root: IXMLDOMElement; I: Integer; ... Root:= XMLDoc.DocumentElement; For I:= 0 to Root.ChildNodes.Length-1 do Begin Node:= Root.ChildNodes.Item[I]; Memo1.Lines.Add(Node.Text); End; </p><p>Для нашего XML-документа мы получим следующий текст .</p> <p>Если нас интересует какая-то специфическая ветвь или ветвь уровнем ниже первой дочерней ветви, мы можем воспользоваться либо методом NodeFromID, либо методом GetElementByTagName объекта XMLDOMDocument.</p> <p>Метод NodeFromID требует указания уникального идентификатора, определенного в XML Schema или Document Type Definition (DTD), и возвращает ветвь с этим идентификатором.</p> <p>Метод GetElementByTagName требует указания строки со специфическим элементом (тэгом) и возвращает все ветви с данным элементом. Ниже показано, как использовать данный метод для нахождения всех исполнителей в нашем каталоге CD-ROM:</p><p>Nodes: IXMLDOMNodeList; Node: IXMLDOMNode; ... Nodes:= XMLDoc.GetElementsByTagName(‘ARTIST’); For I:= 0 to Nodes.Length-1 do Begin Node:= Nodes.Item[I]; Memo1.Lines.Add(Node.Text); End; </p><p>Для нашего XML-документа мы получим следующий текст </p> <p>Отметим, что метод SelectNodes объекта XMLDOMNode обеспечивает более гибкий способ для доступа к ветвям документа. Но об этом чуть ниже.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h2> Ветвь документа - объект XMLDOMNode</h2> <p>Объект XMLDOMNode представляет собой ветвь документа. Мы уже сталкивались с этим объектом, когда получали корневой элемент документа:</p><p>Root:= XMLDoc.DocumentElement; </p><p>Для получения информации о ветви XML-документа можно использовать свойства объекта XMLDOMNode (табл. 1).</p> <p>Для доступа к данным, хранимым в ветви, обычно используют либо свойство NodeValue (доступно для атрибутов, текстовых ветвей, комментариев, инструкций по обработке и секций CDATA), либо свойство Text, возвращающее текстовое содержимое ветви, либо свойство NodeTypedValue. Последнее, однако, может использоваться только для ветвей с типизованными элементами.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h3> Перемещение по дереву документа</h3> <p>Объект XMLDOMNode предоставляет множество способов для перемещения по дереву документа. Например, для доступа к родительской ветви используется свойство ParentNode (тип XMLDOMNode), доступ к дочерним ветвям осуществляется через свойства ChildNodes (тип XMLDOMNodeList), FirstChild и LastChild (тип XMLDOMNode) и т.д. Свойство OwnerDocument возвращает объект типа XMLDOMDocument, идентифицирующий сам XML-документ. Перечисленные выше свойства позволяют легко перемещаться по дереву документа.</p> <p>Теперь переберем все ветви XML-документа:</p><p>Root:= XMLDoc.DocumentElement; For I:= 0 to Root.ChildNodes.Length-1 do Begin Node:= Root.ChildNodes.Item[I]; If Node.HasChildNodes Then GetChilds(Node,0); End; </p><p>Как уже отмечалось выше, SelectNodes объекта XMLDOMNode обеспечивает более гибкий способ доступа к ветвям документа. Кроме того, существует метод SelectSingleNode, возвращающий только первую ветвь документа. Оба эти метода позволяют задавать XSL-шаблоны для поиска ветвей.</p> <p>Рассмотрим процесс использования метода SelectNodes для извлечения всех ветвей, у которых есть ветвь CD и подветвь PRICE:</p><p>Root:= XMLDoc.DocumentElement; Nodes:= Root.SelectNodes(‘CD/PRICE’); </p><p>В коллекцию Nodes будут помещены все подветви PRICE ветви CD. К обсуждению XSL-шаблонов вернемся чуть позже.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h3> Манипуляция дочерними ветвями</h3> <p>Для манипуляции дочерними ветвями мы можем воспользоваться методами объекта XMLDOMNode (табл. 2).</p> <p>Для того чтобы полностью удалить запись о первом диске, необходимо выполнить следующий код :</p><p>Var XMLDoc: IXMLDOMDocument; Root: IXMLDOMNode; Node: IXMLDOMNode; XMLDoc:= CoDOMDocument.Create; XMLDoc.Async:= False; XMLDoc.Load(‘C:\DATA\DATA.xml’); // Получить корневой элемент Root:= XMLDoc.DocumentElement; Node:= Root; // Удалить первую дочернюю ветвь Node.RemoveChild(Node.FirstChild); </p><p>Обратите внимание на то, что в данном примере мы удаляем первую дочернюю ветвь. Как удалить первый элемент первой дочерней ветви, показано ниже :</p><p>Var XMLDoc: IXMLDOMDocument; Root: IXMLDOMNode; Node: IXMLDOMNode; XMLDoc:= CoDOMDocument.Create; XMLDoc.Async:= False; XMLDoc.Load(‘C:\DATA\DATA.xml’); // Получить корневой элемент Root:= XMLDoc.DocumentElement; // и первую дочернюю ветвь Node:= Root.FirstChild; // Удалить первую дочернюю ветвь Node.RemoveChild(Node.FirstChild); </p><p>В приведенном выше примере мы удалили не первую ветвь <CD>…</CD>, а первый элемент ветви - <TITLE>….

Теперь добавим новую ветвь. Ниже приведен код, показывающий, как добавить новую запись о музыкальном CD-ROM :

Var NewNode: IXMLDOMNode; Child: IXMLDOMNode; ... // Создадим новую ветвь - NewNode:= XMLDoc.CreateNode(1, ‘CD’, ‘’); // Добавим элемент Child:= XMLDoc.CreateNode(1,‘TITLE’,‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ‘Pink Floyd’; // Добавим элемент <ARTIST> Child:= XMLDoc.CreateNode(1, ‘ARTIST’, ‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ‘Division Bell’; // Добавим элемент <COUNTRY> Child:= XMLDoc.CreateNode(1, ‘COUNTRY’, ‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ‘UK’; // Добавим элемент <COMPANY> Child:= XMLDoc.CreateNode(1, ‘COMPANY’, ‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ‘EMI Records Ltd.’; // Добавим элемент <PRICE>Child:= XMLDoc.CreateNode(1, ‘PRICE’, ‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ’11.99"; // Добавим элемент <YEAR> Child:= XMLDoc.CreateNode(1, ‘YEAR’, ‘’); // Добавим элемент NewNode.AppendChild(Child); // И установим его значение Child.Text:= ‘1994’; // И добавим ветвь Root.AppendChild(NewNode); ... </p><p>Приведенный выше код показывает следующую последовательность действий по добавлению новой ветви:</p> <ul><li>Создание новой ветви методом CreateNode: <ul><li>создание элемента методом CreateNode;</li> <li>добавление элемента к ветви методом AppendChild;</li> <li>установка значения элемента через свойство Text;</li> <li>… повторить для всех элементов.</li> </ul></li> <li>Добавление новой ветви к документу методом AppendChild.</li> </ul><p>Напомним, что метод AppendChild добавляет ветвь в конец дерева. Для того чтобы добавить ветвь в конкретное место дерева, необходимо использовать метод InsertBefore.</p> <h2> Набор ветвей - объект XMLDOMNodeList</h2> <p>Объект XMLNodeList содержит список ветвей, который может быть построен с помощью методов SelectNodes или GetElementsByTagName, а также получен из свойства ChildNodes.</p> <p>Мы уже рассматривали использование этого объекта в примере, приведенном в разделе «Перемещение по дереву документа». Здесь же мы приведем некоторые теоретические замечания.</p> <p>Число ветвей в списке может быть получено как значение свойства Length. Ветви имеют индексы от 0 до Length-1, и каждая отдельная ветвь доступна через элемент массива Item с соответствующим индексом.</p> <p>Перемещение по списку ветвей также может осуществляться с помощью метода NextNode, возвращающего следующую ветвь в списке, или Nil, если текущая ветвь - последняя. Чтобы вернуться к началу списка, следует вызвать метод Reset.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h2> Создание и сохранение документов</h2> <p>Итак, мы рассмотрели, как можно добавлять ветви и элементы в существующие XML-документы. Теперь создадим XML-документ «на лету». Прежде всего напомним, что документ может быть загружен не только из URL, но и из обычной строки. Ниже показано, как создать корневой элемент, который затем может использоваться для динамического построения остальных элементов (что мы уже рассмотрели в разделе «Манипуляция дочерними ветвями»):</p><p>Var XMLDoc: IXMLDOMDocument; Root: IXMLDOMNode; Node: IXMLDOMNode; S: WideString; ... S:= ‘<CATALOG></CATALOG>’; XMLDoc:= CoDOMDocument.Create; XMLDoc.Async:= False; XMLDoc.LoadXML(S); Root:= XMLDoc.DocumentElement; Node:= XMLDoc.CreateNode(1, ‘CD’, ‘’); Root.AppendChild(Node); Memo1.Lines.Add(XMLDoc.XML); ... XMLDoc:= Nil; </p><p>После построения XML-документа сохраним его в файле с помощью метода Save. Например:</p> <p>XMLDoc.Save(‘C:\DATA\NEWCD.XML’);</p> <p>Помимо сохранения в файле метод Save позволяет сохранять XML-документ в новом объекте XMLDOMDocument. В этом случае происходит полная обработка документа и, как следствие, проверка его структуры и синтаксиса. Ниже показано, как сохранить документ в другом объекте:</p><p>Procedure TForm1.Button2Click(Sender: TObject); var XMLDoc2: IXMLDOMDocument; begin XMLDoc2:= CoDOMDocument.Create; XMLDoc.Save(XMLDoc2); Memo2.Lines.Add(XMLDoc2.XML); ... XMLDoc2:= Nil; end; </p><p>В заключение отметим, что метод Save также позволяет сохранять XML-документ в другие COM-объекты, поддерживающие интерфейсы IStream, IPersistStream или IPersistStreamInit.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h2> Использование XSL-шаблонов</h2> <p>Обсуждая метод SelectNodes объекта XMLDOMNode, мы упомянули о том, что он обеспечивает более гибкий способ доступа к ветвям документа. Гибкость заключается в том, что в качестве критерия для выбора ветвей можно указать XSL-шаблон. Такие шаблоны предоставляют мощный механизм для поиска информации в XML-документах. Например, для того, чтобы получить список всех названий музыкальных CD-ROM в нашем каталоге, можно выполнить следующий запрос:</p><p>Чтобы узнать, диски каких исполнителей выпущены в США, запрос формируется следующим образом:</p><p>Nodes:= Root.SelectNodes(‘CD/ARTIST’); </p><p>Ниже показано, как найти первый диск в каталоге:</p><p>Nodes:= Root.SelectNodes(‘CD/TITLE’); </p><p>и последний:</p><p>Nodes:= Root.SelectNodes(‘CD/TITLE’); </p><p>Чтобы найти диски Боба Дилана, можно выполнить следующий запрос:</p><p>Nodes:= Root.SelectNodes(‘CD[$any$ ARTIST= ”Bob Dylan”]/TITLE’); </p><p>а чтобы получить список дисков, выпущенных после 1985 года, мы выполняем следующий запрос:</p><p>Nodes:= Root.SelectNodes(‘CD/TITLE’); </p><p>Более подробное обсуждение синтаксиса XSL требует отдельной публикации. Чтобы заинтриговать читателей и подтолкнуть к дальнейшим исследованиям, приведу всего один небольшой пример возможного использования XSL. Допустим, нам необходимо преобразовать наш каталог в обычную HTML-таблицу. Пользуясь традиционными способами, мы должны перебрать все ветви дерева и для каждого полученного элемента сформировать соответствующие тэги <TD>…</TD>.</p> <p>Используя XSL, мы просто создаем шаблон (или таблицу стилей), в котором указываем, что и как надо преобразовать. Затем накладываем этот шаблон на наш каталог - и готово: перед нами текст XSL-шаблона, преобразующего каталог в таблицу (листинг 2).</p> <p>Код для наложения XSL-шаблона на наш каталог выглядит так:</p><p>Procedure TForm1.Button2Click(Sender: TObject); var XSLDoc: IXMLDOMDocument; begin XSLDoc:= CoDOMDocument.Create; XSLDoc.Load(‘C:\DATA\DATA.xsl’); Memo2.Text:= XMLDoc.TransformNode(XSLDoc); XSLDoc:= Nil; end; </p><p>Завершая наше обсуждение XSL, следует сказать, что в настоящее время этот язык активно используется для трансформации между различными XML-документами, а также для форматирования документов.</p> <table border="0" width="100%"><tr><td width="50%"> </td> <td width="50%"> </td> </tr></table><h2> Заключение</h2> <p>По вполне понятным причинам в одной статье невозможно рассмотреть все объекты Microsoft XML DOM и привести примеры их использования. Здесь мы лишь коснулись основных вопросов использования XML DOM в приложениях. В табл. 3 показаны все объекты, реализованные в Microsoft XML DOM.</p> <p>КомпьютерПресс 12"2000</p> <p>Последнее время много внимания уделяется построение систем электронного бизнеса, или как их еще называют - B2B (business to business). Учитывая рекомендации по построению обменных потоковых систем координирующего интернет-технологий органа - WWW Consortium: акцент сделан в сторону XML-технологий и построение систем обмена XML-документами.</p> <p>Преимущество использования XML в электронном бизнесе - высокая эффективность B2B систем при низких затратах на ее создание за счет четкого и наглядного представления структурированной информации, возможность использования современных сетевых протоколов и создания бизнес-систем реального времени.</p> <p>Независимость представления информации в виде XML документов позволяет разным, участвующим в электронном бизнесе, фирмам производить независимое друг от друга ПО.</p> <p>Во всех системах обмен, как правило, строится по одинаковой схеме, с использованием HTTP запросов. В качестве протокола защиты информации применяется протокол SSL (но это отдельная тема).</p> <p>Один из возможных вариантов обработки XML сообщения является построение BIN/CGI (ISAPI)-приложений или COM (серверных) компонент, формирующих или обрабатывающих XML-документы.</p> <p>С одной стороны, приложение выступает в качестве клиента, которое в режиме POST выдает HTTP запрос, с другой стороны, находится WEB сервер на стороне которого осуществляется обработка запроса и выдача ответа. В информационном обмене используются XML-документы.</p> <p>Один из наиболее эффективных вариантов реализации - использование существующего XML-парсера, поддерживающего DOM модель. Такой парсер является дистрибутивной поставкой Win`98 или составной частью IE 4,7 и выше (для Win`95) и представляет COM сервер, находящийся в библиотеке msxml.dll.</p> <p>Модель компонентных объектов (COM) - представляет инкапсулированные данные и методы в единую сущность и способ доступа к ним через систему интерфейсов. Средствами Delphi достаточно просто осуществить доступ к классам COM-объекта (в одном COM-сервере может быть включено несколько классов). Доступ к объектам осуществляется путем инициализации экземпляра класса через систему интерфейсов. Описание интерфейсов осуществляется языком определения интерфейсов (IDL), которое возможно осуществить средствами среды автоматически.</p> <p>Средствами Delphi осуществляется импорт из COM-сервера <i>msxml.dll </i>, строится файлы описания интерфейса IDL и файл бинарного описания типов библиотеки - TLB. Данная операция осуществляется через системное меню: <b>Project | Type Library Import: </b>(рисунок 1). Далее появляется диалоговое окно (рисунок 2), в котором необходимо выбрать COM-объект (в нашем случае объект зарегистрирован под именем "Microsoft.XMLDom (Version 2.0)") и создать TLB-файл (кнопка <b>Create Unit </b>). Используя TLB-файл, среда генерирует "паскалевский" файл описания COM-сервера - MSXML_TLB.pas</p> <p>В файле MSXML_TLB.pas описаны все интерфейсы, константы и соклассы COM-сервера.</p> <p>Для доступа к объектам COM-элемента, необходимо в директиве <b>USES </b>добавить имя файла описания библиотеки (MSXML_TLB.pas). Ниже представлена простейшая программа, использующая DOM стандартный анализатор msxml.dll, которая загружает XML-документ и отображает его в элементе текстового поля Memo1.</p> <b>uses </b> Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs, OleServer, MSXML_TLB, StdCtrls; <b>type </b> TForm1 = <b>class </b>(TForm) Button1: TButton; Memo1: TMemo; <b>procedure </b> Button1Click(Sender: TObject); <b> end; </b> <b>var </b> Form1: TForm1; <b>implementation </b> {$R *.DFM} <b>Procedure </b>TForm1.Button1Click(Sender: Tobject); <span> // объявление сокласса объекта DOMDocument; </span> <b>var </b>coDoc: CoDOMDocument; <span> // класс, согласованный с интерфейсом IDOMDocument; </span> <b>var </b>Doc: IXMLDOMDocument; <b>begin </b> <span> // создание экземпляра объекта DOMDocument; </span> Doc:= coDoc.Create; <span> // вызов метода Load экземпляра объекта DOMDocument; </span> Doc.load("data.xml"); <span> // доступ к свойстве xml экземпляра объекта DOMDocument; </span> Memo1.Text:=Doc.xml; <b>end; </b> <b>end. </b> <h2>Концепция DOM - объектная модель документа</h2> <p>Каждый XML документ представляется в виде набора множества объектов (классов), с помощью которых возможен доступ к отдельным элементам (полям объекта). DOM - интерфейс описывает доступ как к простым объектам типа DOMString или CharacterData, так и к частям или отдельным элементам XML документа: DOMFragmentElement, DOMNode, DOMElement.</p> <p>Ниже приведены самые важные свойства и методы объектов XMLDOMDocument, XMLDOMNode, XMLDOMNodeList. Необходимо отметить, что представленные ниже методы и функции объектов DOM модели (Document Object Model) используются Microsoft XML-анализатором msxml.dll и несколько шире, чем утвержденная W3C Консорциумом DOM модель.</p> <p>Более полное описание интерфейса DOM объектов можно найти на </p> <table cellspacing="0" cellpadding="4" width="500" border="1"><tbody><tr><td valign="top" colspan="2"> Объект XMLDOMDocument </td> </tr><tr><td valign="top" colspan="2">Представляет верхний уровень объектной иерархии и содержит методы для работы с документом: его загрузки, анализа, создания в нем элементов, атрибутов, комментариев и т.д. . </td> </tr><tr><td valign="top" colspan="2"><b>Свойства </b> </td> </tr><tr><td valign="top" width="39%"><b>Async </b> </td> <td valign="top" width="61%">Свойство идентифицирующее текущий режим обработки </td> </tr><tr><td valign="top" width="39%" height="19"><b>ParseError </b> </td> <td valign="top" width="61%" height="19">Возвращает ссылку на объект обработки ошибки XMLDOMParseError </td> </tr><tr><td valign="top" width="39%"><b>Включение - выключение верификации документа. </b> </td> <td> </td> </tr><tr><td valign="top" width="39%"><b>url </b> </td> <td valign="top" width="61%">Возвращает URL документа </td> </tr><tr><td valign="top" width="39%"><b>documentElement </b> </td> <td valign="top" width="61%">Содержит ссылку на корневой элемент документа в виде объекта XMLDOMElement. </td> </tr><tr><td valign="top" colspan="2"><b>Методы </b> </td> </tr><tr><td valign="top" width="39%"><b>load(url) <br>loadXML(xmlString) </b> </td> <td valign="top" width="61%">Загружает XML документ, </td> </tr><tr><td valign="top" width="39%"><b>save(objTarget) </b> </td> <td valign="top" width="61%">Сохраняет XML документ в файле </td> </tr><tr><td valign="top" width="39%"><b>abort </b> </td> <td valign="top" width="61%">Прерывание процесса загрузки и обработки документа. </td> </tr><tr><td valign="top" width="39%"><b>createAttribute (name) </b> </td> <td valign="top" width="61%">Создает для текущего элемента новый атрибут с указанным именем. </td> </tr><tr><td valign="top" width="39%"><b>createNode(Type, name, nameSpaceURI) </b> </td> <td valign="top" width="61%">Создает узел указанного типа и названия </td> </tr><tr><td valign="top" width="39%"><b>createElement(tagName) </b> </td> <td valign="top" width="61%">Создает элемент документа с указанным названием. </td> </tr><tr><td valign="top" width="39%"><b>createTextNode(data) </b> </td> <td valign="top" width="61%">Создает текст внутри документа </td> </tr><tr><td valign="top" width="39%"><b>getElementsByTagName(tagname) </b> </td> <td valign="top" width="61%">Возвращает ссылку на коллекцию элементов документа с заданным именем </td> </tr><tr><td valign="top" width="39%"><b>nodeFromID(idString) </b> </td> <td valign="top" width="61%">Поиск элемента по идентификатору </td> </tr></tbody></table><br><table cellspacing="0" cellpadding="4" width="500" border="1"><tbody><tr><td valign="top" colspan="2"> <b>Объект XMLDOMNode </b> </td> </tr><tr><td valign="top" colspan="2">Объект XMLDOMNode, реализующий базовый DOM интерфейс <b>Node </b>, предназначен для манипулирования с отдельным узлом дерева документа. Его свойства и методы позволяют получать и изменять полную информацию о текущем узле - его тип, название, полное название, его содержимое, список дочерних элементов и т.д. </td> </tr><tr><td valign="top" colspan="2"><b>Свойства </b> </td> </tr><tr><td valign="top" width=" "><b>nodeName, baseName </b> </td> <td valign="top" width="65%">Возвращает название текущего узла. </td> </tr><tr><td valign="top" width="35%"><b>prefix </b> </td> <td valign="top" width="65%">Возвращает Namespace префикс. </td> </tr><tr><td valign="top" width="35%"><b>dataType </b> </td> <td valign="top" width="65%">Определяет тип содержимого текущего узла </td> </tr><tr><td valign="top" width="35%"><b>nodeType, nodeTypeString </b> </td> <td valign="top" width="65%">Возвращает тип текущего узла: </td> </tr><tr><td valign="top" width="35%"><b>attributes </b> </td> <td valign="top" width="65%">Возвращает список атрибутов текущего узла в виде коллекции XMLDOMNamedNodeMap. </td> </tr><tr><td valign="top" width="35%"><b>text </b> </td> <td valign="top" width="65%">Возвращает содержимое текущего поддерева в виде текста </td> </tr><tr><td valign="top" width="35%"><b>xml </b> </td> <td valign="top" width="65%">Возвращает XML-представление текущего поддерева. </td> </tr><tr><td valign="top" width="35%"><b>nodeValue </b> </td> <td valign="top" width="65%">Возвращает содержимое текущего узла. </td> </tr><tr><td valign="top" width="35%"><b>childNodes </b> </td> <td valign="top" width="65%">Возвращает список дочерних элементов в виде XMLDOMNodeList. </td> </tr><tr><td valign="top" width="35%"><b>firstChild, lastChild </b> </td> <td valign="top" width="65%">Возвращает первый/последний дочерний элемент </td> </tr><tr><td valign="top" width="35%"><b>previousSibling ,nextSibling </b> </td> <td valign="top" width="65%">Возвращает предыдущий /следующий сестринский элемент. </td> </tr><tr><td valign="top" width="35%"><b>parentNode </b> </td> <td valign="top" width="65%">Содержит ссылку на родительский элемент. </td> </tr><tr><td valign="top" width="35%"><b>ownerDocument </b> </td> <td valign="top" width="65%">Возвращает указатель на документ, в котором находится текущий узел. </td> </tr><tr><td valign="top" colspan="2"><b>Методы </b> </td> </tr><tr><td valign="top" width="35%"><b>appendChild(newChild) </b> </td> <td valign="top" width="65%">Добавляет текущему узлу новый дочерний элемент. </td> </tr><tr><td valign="top" width="35%"><b>insertBefore(newChild, refChild) </b> </td> <td valign="top" width="65%">Вставляет дочерний узел, располагая его в текущем поддереве "левее" узла, указанного параметром refChild. </td> </tr><tr><td valign="top" width="35%"><b>cloneNode (deep) </b> </td> <td valign="top" width="65%">Создание копии текущего элемента. </td> </tr><tr><td valign="top" width="35%"><b>getAttribute </b><b>(name)<br> </b><b>getAttributeNode </b><b><span> (name)<br>setAttribute(name, value)<br>setAttributeNode(XMLDOMAttribute) </span> </b> </td> <td valign="top" width="65%">Доступ к атрибутам (создание, чтение, запись) объекта. Name - имя атрибута, value - его значение. Возращает значение объект XMLDOMAttribute. </td> </tr><tr><td valign="top" width="35%"><b>replaceChild(newChild, oldChild) removeChild(oldChild) </b> </td> <td valign="top" width="65%">Замена объекта oldChild текущего списка дочерних объектов на newChild. Удаление объекта oldChild </td> </tr><tr><td valign="top" width="35%"><b>selectNodes(patternString) selectSingleNode(patternString) </b> </td> <td valign="top" width="65%">Возвращает объект XMLDOMNodeList, выбранное по шаблону поиска или первый узел </td> </tr><tr><td valign="top" width="35%"><b>transformNode(stylesheet)<br>transformNodeToObject(stylesheet, outputObject) </b> </td> <td valign="top" width="65%">Назначает стилевую таблицу для поддерева текущего узла и возвращает строку - результат обработки. В качестве параметра передается ссылка на объект DOMDocument, в котором находятся XSL инструкции. </td> </tr></tbody></table><br><h2>Использование XML в бизнесе.</h2> <p>Для более ясной картины необходимо пояснение, а зачем все это нужно с тем, что бы понять, как это работает:</p> <p>При построении B2B или корпоративной ERP системы, при организации информационного обмена XML-документами между предприятиями или филиалами пр-я, используются эффективно себя зарекомендовавшая система передачи информации на основе имеющихся WEB серверов по HTTP протоколам.</p> <p>С одной стороны, приложение выступает в качестве клиента, которое в режиме POST выдает HTTP запрос, с другой стороны, находится WEB сервер, на стороне которого осуществляется обработка запроса и выдача ответа. В качестве обмена используются XML-документы.</p> <p>Например, в простой корпоративной ERP системе бухгалтерской программе (АСУ Бухучет) необходимо сформировать некий запрос на выписку накладной и передать его в филиал, который имеет склад (АСУ Склад). АРМ Аналогичная постановка задачи при создании В2В системы, когда Предприятие А запрашивает наличие продукции (делает заказ на приобретение) у Поставщика В.</p> <p>Предприятие А и его программа выступает в качестве клиента. Склад обслуживает Поставщик В, у которого находится складской комплекс БД на SQL сервере. Обмен осуществляется через корпоративный WEB сервер Поставщика В.</p> <p>Ниже представлен следующий типовой алгоритм обмена:</p> <br>Рисунок 3. <ol><li><b>Предприятие А </b>инициирует <b>процесс А </b>(заказ продукции), который выступает в качестве WEB-клиента.</li><li><b>Процесс А </b>формирует XML документ (например запрос- накладная) и передает его как POST запрос http на WEB сервер Поставщика В. В качестве URI - используется идентификатор ресурса обрабатывающего приложения. URI может быть одинаковым как для всех типов документов, либо индивидуальным для каждого типа. Все зависит от структуры B2B (WEB) сервера.</li><li>WEB сервер анализирует запрос и порождает серверный <b>Процесс В </b>, передавая в качестве параметра тело XML документа. <br>Процессе В запускается WEB-сервером и обрабатывается либо как ASP страница,CGI (ISAPI) - приложение или JAVA севрлет (серверное приложение)</li><li><b>Процесс В </b>- формирует запрос на SQL-сервер базы данных.</li><li>SQL-сервер производит необходимые операции в БД, формирует ответ и возвращает его <b>Процессу В </b>.</li><li>По ответу от SQL-сервера <b>Процесс В </b> формирует XML документ (ответ) и возращает его как на ответ на http запрос клиентскому приложению.</li><li>Далее, в зависимости от ситуации на стороне клиента формируется либо новый http запрос, либо заканчивается сеанс.</li> </ol><h2>Несколько слов об организации документооборота.</h2> <p>Общим правилом разработки системы обмена XML документами является:</p><ul><li><b>во-первых </b>- разработка схемы потоков электронных документов и их структуры;</li><li><b>во-вторых </b>- разработка таблиц функций процессов (подпроцессов) т.е. какую функцию по отношению к какому XML-документу будет реализовывать каждый процесс.</li> </ul><p>Каждый XML документ, подобно HTML документу, должен состоять из заголовка сообщения (информация заключенная тагами) и тела сообщения (для запроса эта информация обрамленная тагами для ответа на запрос). Для того, чтобы XML документ был правильно сформирован, необходимо его две составные части "Заголовок" и "Запрос" обрамить тегами, например. Вид типового документа представлен ниже:</p> <p>Заголовок (Рисунок 4), в отличие HTML документа, должен содержать разного рода служебную информацию, в том числе информацию о типе передаваемого документа и процессе его обработки. В информационную обработку поступает тело документа, т.е. содержательная часть обрамленная тагами. Следует отметить, что структуру заголовков должна быть единой для всех типов документов.</p> <p>Для запущенного сервером Процесса, алгоритм обработки предпочтительно (но не обязательно) строить следующим образом:</p> <img src='https://i0.wp.com/codenet.ru/np-includes/upload/2005/01/05/128666.jpg' height="500" width="408" loading=lazy><br>Рисунок 6. <h2>Некоторые принципиальные моменты при создании клиентской части</h2> <p>Как уже пояснялось, при создание XML-документа используется его представление в виде DOM модели. Ниже приведен пример части текста Delphi программы создания заголовка xml сообщения.</p> <b>procedure </b>TThread1.HeaderCreate(Sender: Tobject); <b>var </b> <span> // объявление сокласса, необходим для создания </span> coDoc: CoDomDocument ; <span> // объекта XMLDomDocument </span> Doc: DomDocument ; r: IXMLDOMElement; Node: IXMLDOMElement; // DOMText txt: IXMLDOMText; // DOMAttribute attr: IXMLDOMAttribute; <b>begin </b> <span> // создание документа DOM </span> Doc:=coDoc.Create; Doc.Set_async(false); <span> // начальная инициация DOM документа </span> Doc.LoadXML("<Header/>"); <span> // создание DOMElement (таг <<b>Sender </b>>) </span> Node:= Doc.createElement ("Sender"); <span> // создание текстового узла "<b>ООО "Тайфун" </b>" </span> txt:= Doc.createTextNode("ООО "Тайфун""); <span> // присвоение узлу <<b>Sender </b>> значение </span> <span> // текстового узла "<b>ООО "Тайфун" </b>" </span> Node.appendChild(txt); <span> // добавление элемента <<b>Sender </b>> в корень документа как дочернего </span> r.appendChild(Node); <span> <<b>From </b>> </span> Node:= Doc.createElement ("From"); txt:= Doc.createTextNode("http://tayfun.ru/xml/default.asp"); Node.appendChild(txt); r.appendChild(Node); <span> // аналогичные операции для тага <<b>To </b>> </span> Node:= Doc.createElement ("To"); txt:= Doc.createTextNode("http://irbis.ru"); Node.appendChild(txt); r.appendChild(Node); <span> // создание DOMElement () </span> Node:= Doc.createElement ("TypeDocument"); <span> // создание узла XMLDOMAttribute </span> Att:= Doc.createAttribute ("Id ", " Order"); <span> // <TypeDocument Id="Order"/> </span> Node.appendChild(Att); r.appendChild(Node); <b>end; </b> <p>Следует отметить, что объявление переменной coDoc: CoDomDocument и Doc: DomDocument , а также ее создание методом Create (Doc:=coDoc.Create;) осуществляется один раз. Объявление переменной находится в секции описания глобальных переменных, а не в локальной процедуре, как было продемонстрировано для наглядности в данном примере (т.е. одна глобальная переменная типа DomDocument на один программный модуль).</p> <p>Результатом работы вышеприведенной программы будет созданный заголовок, применительно к нашему примеру xml-документа: изображен на рисунке 5.</p> <img src='https://i1.wp.com/codenet.ru/np-includes/upload/2005/01/05/128662.gif' height="116" width="298" loading=lazy><br>Рисунок 5.<p><img src='https://i2.wp.com/codenet.ru/np-includes/upload/2005/01/05/128664.gif' height="179" width="385" loading=lazy><br>Рисунок 6. </p><p>Основное преимущество передачи информации в виде XML-документов в том, что существует возможно формировать сообщение, используя независимые структуры таблиц в СУБД как на принимаемой, так и на передаваемой стороне. Используя наш пример, пусть требуется передать информацию об инвойсах Предприятия А, из СУБД имеющий структуру, изображенную на рисунке 6</p> <p>Для формирования xml-документа, содержащего инвойс первоначально строится SQL-запрос (запрос А) с информацией о самом инвойсе:</p> <b>SELECT </b> * FROM Invoice_General <b>WHERE </b> InvoiceNum = :num <b>SELECT </b>Goods,Qulity,Price, HZ_cod <b>FROM </b>Goods <b>WHERE </b> InvoiceNum = :num <span> // :num - параметр, который задает номер инвойса. </span> <p>Ниже представлена часть программы, формирующей тело xml-документа:</p> <b>procedure </b> TThread1.DataBodyCreate(Sender: Tobject); <b>var </b> <span> // объявление сокласса и объекта XMLDomDocument </span> //coDoc: CoDomDocument ; <span> // должно быть глобальным, для всего модуля. </span> //Doc: DomDocument ; <span> // объявление объектов DOMElement </span> r: IXMLDOMElement; // DOMElement; Node, Node2: IXMLDOMElement; Node3, Node4: IXMLDOMElement; // DOMText txt: IXMLDOMText; str: String; <span> // InvoiceNumber: <b>integer; </b> - глобальная переменная - // имеет значение 987654 // queryA, queryB: <b>String; </b> - глобальная переменная, // имеет значение,соответствующее запросу // queryA - запрос А генеральная информацией об инвойсе // queryB - запрос B информация о товарах, описываемых в // инвойсе (см. текст) </span> <b>begin </b> Query.Close; <span> // см. по тексту "запрос А" </span> Query.Text:= queryA; <span> // выполнение запроса </span> Query.ExecSQL; Query.Open; <span> // получение адреса корневого элемента </span> r:=Doc.Get_documentElement; Node2:= Doc.createElement (" Request "); <span> // создание DOMElement (таг) </span> Node:= Doc.createElement ("Invoice"); <span> // добавление элемента в корень </span> r.appendChild(Node2); <span> // добавление элемента в </span> Node2. appendChild(Node); <span> // создание DOMElement (таг) </span> Node3:= Doc.createElement ("Depurture") ; <span> // добавление элемента в </span> Node. appendChild(Node3); <span> // обращение к полю "Depurture" запроса </span> str:= Query.FieldByName("Depurture").AsString; <span> // создание текстового узла = значению поля </span><span> // присвоение узлу значение </span> <span> // текстового узла, переменной str </span> Node.appendChild(txt); <span> // аналогичные операции для тага <Destination>, <DataSend>, // <DataDepurture>, <Currency> // <DestinationCompany> (поле DB "Consignee") </span> Node:= Doc.createElement ("Destination"); <span> // имя поля БД может и не совпадать с именем </span> str:= Query.FieldByName("Consignee ").AsString; <span> // тага, в этом преимущество использования </span> txt:= Doc.createTextNode(str); <span> // DOM интерфейса перед СУБД, имеющим поддержку XML-интерфейса, // типа ORACLE 8i или Ms SQL 2000 </span> Node.appendChild(txt); ... <span> // формирование запроса на спецификацию по товарам </span> <span> // закрывает запрос для доступа </span> Query.Close; <span> // см. по тексту "запрос В", информац. О товарах </span> Query.Text:= queryВ; <span> // присваивание значения параметров </span> Query.Params.AsInteger:= InvoiceNumber; <span> // выполнение запроса </span> Query2.ExecSQL; <span> // открытие доступа к данным запроса </span> Query.Open; <span> // создание DOMElement (таг) </span> Node3:= Doc.createElement (" Imems") ; <span> // добавление элемента в </span> Node. appendChild(Node3); <span> // цикл по всем строкам запроса </span> <b>while </b> <b>not </b> Eof.Query <b>do </b> begin Node4:= Doc.createElement ("Imem"); <span> // добавление элемента в </span> Node3.appendChild(Node4); <span> // формирование данных для тага </span> str:= Query.FieldByName("Price").AsString; txt:= Doc.createTextNode(str); Node.appendChild(txt); ... <span>// аналогичные операции для тагов <HZ_Cod>, <Quality>, <GoodName> </span> <b>end; </b> <b>end; </b> <p>В результате выполнения данной процедуры формируется следующий текст XML-документа:</p> <table width="100%"><tbody><tr><td align="middle"><br><img src='https://i0.wp.com/codenet.ru/np-includes/upload/2005/01/05/128661.gif' width="100%" loading=lazy></td> </tr></tbody></table><p>Для формирования запроса используется метод Open объекта <b>IXMLHttpRequest </b>:</p> <b>procedure </b> Open(const bstrMethod, - тип метода ="POST" bstrUrl, - Url адрес сервера varAsync, - режим связи асинхронный/синхронный = true bstrUser, - имя пользователя для аутентификации bstrPassword) - пароль <h2>Создании серверной части обработки документа</h2> <p>Как было отмечено ранее, обработка HTTP запроса может осуществляться либо CGI-приложениями, либо Java-сервлетами. Возможен и вариант написания ASP-страниц. Но в этом случае передача данных возможна только методом "GET" через строку запроса. Хотя, обработка HTTP запроса ASP-страниц работает более эффективнее, чем CGI-приложением. Однако, на мой взгляд, без разницы, как обрабатывать, а важнее решить вопрос - как построить программу обработки, а не какими средствами.</p> <p>Если из предыдущей главы мы рассмотрели варианты формирования XML-документ, то задача серверного приложения обратная - разбор XML-документов. Ниже представлена часть программы, осуществляющей разбор xml-документа:</p> <b>procedure </b>Tthread1.DataParser(Sender: Tobject); <b>var </b> <span>// объявление объектов DOMElement </span> r,FNode: IXMLDOMElement; Str,Filename: String; parm: String; <span>// объявление сокласса и </span> CoDocXML, CoDocXSL, CoDocResult: CoDomDocument ; <span>// объекта XMLDomDocument </span> XMLDoc, XSLDoc, ResultDoc: DomDocument ; <span>// HttpStr: String; - глобальная переменная, содержащая строку HTTP запроса </span> <b>Begin </b> XMLDoc:=coDocXML.Create; XMLDoc.LoadXML(HttpStr); <span> // получение адреса корневого элемента </span> r:=Doc.Get_documentElement; <span> // получение значения элемента </span> FNode:= r.SelectSingleNode("//TypeDocument"); <span> // получение значения атрибута id="Order" </span> FileName:= FNode.GetAttibute("id"); <span> // и формирование имени файла Order.xsl </span> FileName:= FileName+".xsl"; <span> // создание документа XSLDoc </span> XSLDoc:=coDocXSL.Create; XSLDoc.LoadXML(FileName); <span> // создание документа XMLDoc </span> ResultDoc:=coDocResult.Create; <span> // установка синхронного режима обработки </span> ResultDoc.Set_async(false); <span> // установка проверки разбора </span> ResultDoc.validateOnParse:= true; <span> // разбор XMLDoc по XSL-шаблону </span> XMLDoc.transformNodeToObject(XSLDoc, ResultDoc); <span> // переменной Str присваивается текстовое значение </span> <span> // результирующего документа. </span> Str:= ResultDoc.text; <span> // поиск элемента </span> FNode:= r.SelectSingleNode("//InvoiceNumber"); <span> // и получение значения элемента </span> parm:= FNode.text; <span> // закрывает запрос для доступа </span> Query.Close; Query.Text:= Str; <span> // присваивание значения параметра </span> Query.Params.AsString:= parm; <span> // выполнение запроса </span> Query.ExecSQL; <b>end; </b> <p>Вся изюминка разбора заключается в применении XSL-шаблона, который сформирован для каждого типа документа индивидуально. Результатом разбора является строка SQL-запроса. В последствие выполнение сформированной строки SQL-запроса осуществит необходимые изменения данных в СУБД.</p> <p>Преимущество использования разбора через шаблон еще и в том, что получается некая гибкость данных, и получается полная независимость работы алгоритма от программного кода. Ниже приведен используемый для обработки документа типа ORDER текст XSL-шаблона:</p><p> <!-- файл Order.xsl --> <xsl:stylesheet xmlns:xsl="http://www.w3.org/TR/WD-xsl"> <xsl:template match="/"> <xsl:for-each select="//header"> INSERT into TABREG (FROM, TO, TYPEDOC,body) VALUES(" <xsl:value-of select="from" />", "<xsl:value-of select="to" />", "<xsl:value-of select="TypeDocument/@id" />") </xsl:for-each> <xsl:for-each select="//item"> INSERT into GOODS (invoiceNumber, name, price, quality) VALUES(" :num", "<xsl:value-of select="name" />", "<xsl:value-of select="price" />", "<xsl:value-of select="quality" /> ") </xsl:for-each> </xsl:template> </xsl:stylesheet> </p><p>Поясняя вышеприведенный пример, надо отметить, что использование пары тагов и носит формальный характер, т.к. после разбора в результирующем XML-документе формально должен присутствовать хотя бы один узел. Метод ResultDoc.text присваивает текстовое значение полученного в ходе разбора XML-документа ResultDoc. В этом случае значением является все то, что обрамлено пары тегов и, т.е. сформированный нами SQL-запрос.</p> <p>Другой особенностью написания программы надо отметить возможность использования SQL-параметра <b>:num. </b> Использование параметра позволяет упростить текст xsl-шаблона. Определение значение соответствующих элементов узлов XML-документа определяется первоначально выбора по имени соответствующего узла, например:</p><h2>Коротко об XSL</h2> <p>Аббревиатура XSL происходит от eXtensible Stylesheet Language - язык форматирования таблиц стилей (XML данных). Как понятно из заголовка eXtensible Stylesheet Language (XSL) используется для форматирования XML данных. По определению W3C XSL состоит из двух частей:</p> <ul><li>XSLT - XSL Transformation. Язык, используемый для преобразования или форматирования (трансформирования) XML документов. Таким образом, при помощи XSLT мы можем получить разные разрезы множества данных и формы представления данных.</li><li>Элементы форматирования. К этим элементам относятся все элементы типографического оформления данных, после их обработки их при помощи XSL. Используется только для формирования HTML страниц.</li> </ul><p>При помощи XSLT мы можем отобрать нужные нам данные из XML файла, и оформить их в виде для предоставления пользователю. Например, в нашем случае мы преобразовали XML данные в виде SQL запроса. Классическое применение XSL - это, как правило форматирование данных в виде HTML страниц или более редкое представление в виде RTF файлов.</p> <p>XSL файл описывает шаблон (template), согласно которому будет совершаться преобразование XML данных. Возвращаясь к xsl-шаблонам, в XSLT можно выделить следующие элементы (директивы):</p> <table cellspacing="0" cellpadding="4" width="500" border="1"><tbody><tr><td valign="top" width="31%"> <b>XSL-директивы </b> </td><th align="middle" width="69%"> <b>описание </b> </th> </tr><tr><td>xsl:apply-templates </td> <td>Директива, указывающая на применение соответствующих шаблонов атрибуту select="имя шаблона" </td> </tr><tr><td>xsl:attribute </td> <td>создает дерево атрибутов и добавляет его в выходной элемент, параметр name="имя атрибута", namespace - URI на пространство имен (префикс пространства имен) </td> </tr><tr><td>xsl:call-template </td> <td>вызывает шаблон, атрибуту name=" URI на шаблон" </td> </tr><tr><td>xsl:choose<br>xsl:when<br>xsl:otherwise </td> <td>осуществление выбора по условию xsl:when expr="вычисление выражения на script ", <br>language="language-name" <br>test= "вычисляемое выражение" </td> </tr><tr><td>xsl:comment </td> <td>генерирует комментарий в выходной документ </td> </tr><tr><td>xsl:copy<br>xsl:copy-of </td> <td>копирует текущей узел в выходной источник или вставляет фрагмент документа в узел, где атрибут select="имя узла источника" </td> </tr><tr><td>xsl:element </td> <td>создает выходной элемент по имени, атрибут name="имя элемента", namespace="uri ссылка на пространство имен" </td> </tr><tr><td>xsl:for-each </td> <td>повторно применяет шаблон ко всем узлам списка узлов, атрибут select задает список узлов </td> </tr><tr><td>xsl:if </td> <td>проверка условия, задается атрибутом test в виде выражения </td> </tr><tr><td>xsl:include </td> <td>включает внешний шаблон, атрибут href = "URI reference" </td> </tr><tr><td>xsl:output </td> <td>специфицирует выходной результат, атрибут method может иметь значения "xml", "html" или "text" </td> </tr><tr><td>xsl:param </td> <td>специфицирует значение параметров, атрибут name="имя параметра", select = "значение" </td> </tr><tr><td>xsl:processing-instruction </td> <td>создает инструкцию обработки, атрибут name="имя процесс инструкции" </td> </tr><tr><td>xsl:sort </td> <td>сортирует множество узлов, атрибуты select = "имя узла", data-type = тип данных {"text" | "number" | Qname}, order = направление сортировки {"ascending" | "descending"} </td> </tr><tr><td>xsl:stylesheet </td> <td>определяет документ xsl-шаблонов, является корневым элементом для XSLT </td> </tr><tr><td>xsl:template </td> <td>определяет xsl-шаблон, атрибут name= " URI префикс на имя шаблона", match= "указание на узел, к которому применяется шаблон" </td> </tr><tr><td>xsl:text </td> <td>генерирует текст в выходной поток, атрибут disable-output-escaping = "yes" или "no", указывает на возможность генерации символов ESC </td> </tr><tr><td>xsl:value-of </td> <td>вставляет значение выбранного узла как текст, атрибут select= "указатель на узел" из которого берут значение </td> </tr><tr><td>xsl:variable </td> <td>специфицирует значение границ переменных, атрибут name = "имя переменной", select = "вычисление значения переменной" </td> </tr><tr><td>xsl:with-param </td> <td>применяет параметр к шаблону, атрибут name ="имя параметра", select = выражение для вычисления текущего контекста, значение по умолчанию "." </td> </tr></tbody></table><h2>Заключение</h2> <p>В заключение, необходимо отметить, что использование стандартного XML-парсера <i>msxml.dll </i>является не единственным средством разбора и создания XML-документов. Например, для создание XML документов эффективно использовать компоненты <b>TPageProduser </b>и <b>TТableProduser </b>. Но, данная статья лишь подчеркивает широту и возможность применения на практике DOM модели.</p> <p>Автор будет очень благодарен за отзывы об актуальности темы, общем содержании, стиле изложения, а также всем остальным комментариям, которые помогут в дальнейшем улучшить качество написания сборника статей и выпуску книги, освещающую тему практической стороны использования XML-документов в электронной коммерции. Более подробную информацию о практической стороне применения электронных документов можно почерпнуть на авторском сайте www.eDocs.al.ru Также на авторском сайте планируется разместить исходные тексты и примеры.</p> <p>У многих программистов Delphi, сохранение настроек ассоциируется с использованием <i>INI </i> файлов в своих программах. Применение данного метода, в более менее серьезных проектах, необходимо избегать, так как это ограничивает в гибкости, что препятствует дальнейшему расширению программы. Стоит сказать, что такой подход достаточно популярен, в силу своей простоты использования и наличия встроенных средств в среду разработки.<br><br> Тем не менее, идеальным вариантом для хранения настроек программы являются структурированные <i>XML </i> файлы. Их преимущество заключается в том, что количество параметров может быть не фиксированным. Чтобы лучше это понять, рассмотрим конкретный пример.</p><p>В программе USearch , при клике по записи, появляется контекстное меню , в котором отображается список пунктов. Эти пункты являются командами, которые в свою очередь загружаются из файла настроек. В случае, если бы настройки хранились в <i>INI </i> файле, то программа могла бы сохранять и загружать определенное количество команд, например 10 или 50. Как только потребуется большее значение, придется заново переписывать код и соответственно повторно компилировать его.</p><p><img src='https://i1.wp.com/zoo-mania.ru/wp-content/uploads/2011/08/settings.ini_.jpg' height="145" width="247" loading=lazy><br> Применяя подход с использованием <i>XML </i> файлов, у нас появится возможность загружать все параметры секции динамически. Ко всему этому, файл конфигурации станет более изящным, без избыточной нумерации параметров. Однако, стандартные средства для работы с <i>XML </i> в Delphi имеют множество недостатков, поэтому рекомендую использовать стандартную библиотеку <b>MSXML </b>. Обычно она по-умолчанию входит в состав операционных систем семейства Windows.</p><p><img src='https://i2.wp.com/zoo-mania.ru/wp-content/uploads/2011/08/settings.xml_.jpg' align="center" width="100%" loading=lazy><br> Для подключения <b>MSXML </b>, нам необходимо сформировать файл интерфейса со списком всех функций, импортировав его из COM-сервера. Как импортировать интерфейс написано не мало подробных статей, я же предлагаю вам скачать файл <b>MSXML2_TLB.PAS </b> уже готовый к использованию. После того, как файл будет скачан, разместите его рядом с вашим проектом, либо закиньте в папку lib среды Delphi. Таким образом, все создаваемые программы смогут использовать модуль <b>MSXML </b>, достаточно лишь дописать в uses строчку MSXML2_TLB .</p><p>Для наглядности, рассмотрим следующий пример применения этой библиотеки:</p><p>Procedure LoadData; var XMLDoc: DOMDocument; Root: IXMLDOMElement; begin XMLDoc:= CoDOMDocument.Create; XMLDoc.Load("settins.xml"); Root:= XMLDoc.DocumentElement; ShowMessage(Root.SelectSingleNode("size/width").Text); Root:= nil; XMLDoc:= nil; end; </p><p>Сначала создается экземпляр класса DOMDocument , после чего в память загружается содержимое файла settings.xml . Так как по стандарту любой <i>XML </i> файл должен содержать корневой тэг (в данном случае <i>config </i>), то нам необходимо его получить, используя функцию <i>DocumentElement </i>. Затем происходит вывод содержимого между тэгами <width></width> , которые в свою очередь находятся между тэгами <size></size> . Таким образом из файла settings.xml , наш метод выведет в MessageBox текст <i>"100px" </i>.</p><p> <?xml version="1.0" encoding="utf-8"?> <config> <size> <height>500px</height> <width>100px</width> </size> </config> </p><p>Здесь применен метод SelectSingleNode , который в качестве параметра принимает строку</p> <p>Сегодня решил немного продолжить тему работы с XML-RPC в WordPress. Как это обычно со мной бывает, идея родилась в момент чтения случайного блога, вздумалось взглянуть на работу с постами в блоге и, заодно, попробовать написать что-нибудь под свои нужды.</p> <p>Естественно программу я сегодня не выложу, но некоторые выкладки, листинги и идеи в посте будут присутствовать.</p> <p>Вкратце работу с XML-RPC я рассматривал в посте "XML-RPC в <b>Delphi </b>. Первое знакомство с WordPress изнутри." Сегодня попробуем продвинуться дальше в своей работе и использовать несколько взаимосвязанных методов для получения определенной информации из блога.</p> <p>Конкретизируем <b>цель на сегодня </b>: необходимо получить данные по постам в блоге, используя доступные методы из API WordPress .</p> <p>Для достижения поставленной цели нам понадобятся следующие модули Delphi: <b>XMLIntf </b> , <b>xmldom </b> , <b>XMLDoc </b>и библиотека <b>synapce </b>или компонент <b>Indy idHTTP </b> (кому как угодно).</p> <p><b>1. Тестируем соединение с блогом. </b></p> <p>Полагаю, что первое, что следует сделать - это проверить корректность работы с блогом на предмет следующих возможных ошибок:</p> <p>1. В блоге отключена возможность использования XML-RPC</p> <p>2. Пользователь предоставил некорректные данные (url, логин или пароль).</p> <p>Для проверки возможности работы с XML-RPC в блоге достаточно воспользоваться методом demo.sayHello . Если ответом будет строка "Hello" , значит всё в порядке и можно приступать к следующему шагу проверки. Для выполнения этой проверки нам потребуется выполнить три простенькие задачки:</p> <ul><li>сформировать правильный XML-документ</li> <li>отправить запрос на сервер и получить ответ</li> <li>проанализировать ответ</li> </ul><p>Формируем XML-документ, который должен выглядеть так:</p> <p><methodCall></p> <p><methodName>demo.sayHello</methodName></p> <p><string>test</string></p> <p></methodCall></p> <p>Для этого воспользуемся интерфейсом IXMLDocument:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>var doc: IXMLDocument; //документ</p> <p>Root: IXMLNode; //корневой узел</p> <p>inherited Create;</p> <p>doc:=NewXMLDocument();//создаем пустой документ</p> <p>Root:=Doc.CreateElement("methodCall","");//добавляем корневой узел</p> <p>Doc.DocumentElement:=Root;</p> <p>Root.AddChild("methodName").NodeValue:="demo.sayHello";//добавляем название метода</p> <p>Root.AddChild("params").AddChild("param").AddChild("value").AddChild("string").NodeValue:="test";//записываем параметры метода</p> </td> </tr></tbody></table><p>Так как сам по себе XML-документ достаточно простой, то я позволил себе немного "похалявить" и последней строкой кода записал сразу все узлы и значение единственного параметра для нашего метода.<br>Теперь можно отправить документ на сервер и получить ответ:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>with THTTPSend.Create do</p> <p>Doc.SaveToStream(Document);//записываем документ в тело запроса</p> <p>if HTTPMethod("POST",aURL) then</p> <p>//запрос успешно отправлен и получен ответ</p> <p>//запрос не удался</p> </td> </tr></tbody></table><p>Что мне нравится в <b>Synapce </b>, так это то, что не требуется лишних "телодвижений" в плане заполнения заголовков Content-Length , Content-Type и пр. Конечно никто не мешает заполнить все возможные заголовки самому, но можно обойтись и так, как показал я выше - всё на автомате.<br>Двигаемся дальше - проводим анализ ответа.<br>Позволю себе напомнить Вам, что удачная отправка запроса на сервер никак не свидетельствует о том, что мы успешно получили доступ к XML-RPC блога. Удачная отправка запроса свидетельствует только о том, что мы отправили запрос и получили ответ, а _что_ находится в ответе ошибка или нет - мы пока не знаем.<br>Чтобы пока не забивать голову лишними способами и методами парсинга ответа от сервера, предлагаю в данном случае остановиться на применении простой проверки:</p> <p>В соответствии со спецификацией XML-RPC сообщения об ошибках содержится в узле с названием fault. Следовательно, применительно к нашему случаю достаточно проверить наличие такого узла в ответном XML-документе - если его нет, то значит проверка прошла успешно, был сформирован корректный запрос и XML-RPC работает исправно.<br>Переходим к следующему шагу - проверке на корректность предоставленных данных пользователем и возможности работы пользователя с XML-RPC блога.<br>С XML-RPC блога имеет право работать только администратор, следовательно, необходимо узнать кто пробует получить доступ. Для этого воспользуемся методом wp.getUsersBlogs . Параметрами метода являются логин и пароль.<br>Но прежде, чем приступим к отправке запроса и получению ответа, думаю, стоит немного задуматься о будущем и предусмотреть работу с ошибками, формирование документов и т.д.<br>В предыдущей проверке, можно сказать, было баловство - простейших вариант работы типа:<br>отправил/получил/тут_же_разобрал/забыл/пошел_дальше.<br>Так как я планирую развивать модуль по работе с API WordPress и дальше, то есть смысл определиться со следующими моментами в работе:</p> <p>1. Сформировать "скелет" документа</p> <p>2. Записать в документ все необходимые параметры, учитывая типы данных</p> <p>3. Отправить запрос и получить ответ от сервера</p> <p>4. Проанализировать ответ и, если в ответе содержится сообщение об ошибке, то правильно его прочитать</p> <p>Все эти четыре шага я сделал отдельными методами класса. Под "скелетом" документа я понимаю следующее содержимое:</p> <p><methodCall></p> <p><methodName>MethodName</methodName></p> <p><params> </params></p> <p></methodCall></p> <p>То есть часть документа, содержащая имя метода и узел params без содержимого. Дальше на останется только правильно заполнить список параметров. Чем мы сейчас и займемся.</p> <p>Всего в XML-RPC предусмотрено использование шести простых типов данных:</p> <p>1. int и i4 - целые числаinteger)</p> <p>2. double - дробные числа</p> <p>3. string - строки</p> <p>4. base64 - закодированная строка</p> <p>5. dateTime.iso8601 - дата/время</p> <p>Заводим новый тип данных:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>TSimpleType = (tsInt, tsI4, tsString, tsDouble, tsDateTime, tsBase64, tsBoolean);</p> </td> </tr></tbody></table><p>С помощью значений этого типа будем определять тэг для значения параметра.</p> <p>Так как операции создания "скелета" документа и добавления параметров метода разнесены по разным функциям, то создадим ещё один вспомогательный тип данных:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>PXMLDocument = ^IXMLDocument;</p> </td> </tr></tbody></table><p>Теперь сам метод добавления параметра в документ:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>procedure TBlog.SetParam(SimpleType: TSimpleType; Value: string;</p> <p>Document: PXMLDocument);</p> <p>var Root: IXMLNode;</p> <p>if Document^.IsEmptyDoc then Exit;//документ пуст</p> <p>Root:=Document^.DocumentElement.ChildNodes.FindNode("params");</p> <p>if Root=nil then Exit; //узел не найден</p> <p>case SimpleType of</p> <p>tsInt:Root.AddChild("param").AddChild("value").AddChild("int").NodeValue:=Value;</p> <p>tsI4:Root.AddChild("param").AddChild("value").AddChild("i4").NodeValue:=Value;</p> <p>tsString:Root.AddChild("param").AddChild("value").AddChild("string").NodeValue:=Value;</p> <p>tsDouble:Root.AddChild("param").AddChild("value").AddChild("double").NodeValue:=Value;</p> <p>tsDateTime:Root.AddChild("param").AddChild("value").AddChild("dateTime.iso8601").NodeValue:=Value;</p> <p>tsBase64:Root.AddChild("param").AddChild("value").AddChild("base64").NodeValue:=Value;</p> <p>tsBoolean:Root.AddChild("param").AddChild("value").AddChild("boolean").NodeValue:=Value;</p> </td> </tr></tbody></table><p>Этот метод работает только в случае записи простого типа. При работе со структурами необходимо доработать алгоритм.</p> <p>Теперь про анализ сообщений об ошибке. Рассмотрим пример того, как выглядит сообщение об ошибке в XML-RPC:</p> <p><methodResponse></p> <p><name>faultCode</name></p> <p><int>403</int></p> <p><name>faultString</name></p> <p><string>Bad login/pass combination.</string></p> <p></methodResponse></p> <p>Сообщение об ошибке приходит нам в структуре. Причём, если считать, что теги member нумеруются от нуля, то каждый чётный элемент структуры - это код ошибки, а нечётный - текст ошибки. Следовательно метод обработки сообщений об ошибке может выглядеть так:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>function TBlog.ParseErrors(aDocument: PXMLDocument): TStringList;</p> <p>List: IDOMNodeList;</p> <p>List:=aDocument^.DOMDocument.getElementsByTagName("member");</p> <p>Result:=TStringList.Create;</p> <p>for i:=0 to List.length-1 do</p> <p>0:code:=(List.item[i].lastChild.firstChild as IDOMNodeEx).text; //чётный элемент - читаем код ошибки</p> <p>1://нечётный элемент - читаем текст ошибки и записываем результат</p> <p>Result.Add(code+" "+(List.item[i].lastChild.firstChild as IDOMNodeEx).text);</p> </td> </tr></tbody></table><p>Здесь код и текст ошибки записывается в TStringList. Думаю, что при необходимости можно легко сделать, чтобы код и текст читались в разные списки или массивы. Нам пока это не требуется.</p> <p>Отправку документа мы уже рассматривали, поэтому сразу привожу метод проверки данных на корректность:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>function TBlog.CheckUserAccess(const aURL, aUser, aPassword: string;var Error:string): boolean;</p> <p>var Doc:IXMLDocument;</p> <p>Doc:=GetDocument("wp.getUsersBlogs"); //создали "скелет"</p> <p>//добавляем параметры</p> <p>SetParam(tsString,aUser,@Doc);</p> <p>SetParam(tsString,aPassword,@Doc);</p> <p>SendQuery(@Doc,aURL); //отправляем запрос</p> <p>if not Doc.IsEmptyDoc then //если документ записан корректно</p> <p>if Doc.DocumentElement.ChildNodes.FindNode("fault")<>nil then //есть сообщение об ошибке</p> </td> </tr></tbody></table><p>Если пришло сообщение об ошибке, то записываем сообщение в переменную Error. В данном случае структура содержит только одно сообщение об ошибке - поэтому я так легко прописал:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>Error:=ParseErrors(@Doc).Strings;</p> </td> </tr></tbody></table><p>Итак, две проверки сделаны и мы определили, что XML-RPC включен и работает исправно, а пользователь ввёл корректные данные логина и пароля и может работать с API WordPress. Что дальше? А дальше начинаем основную работу - получаем данные по комментариям в блоге.</p> <p><b>2. Получаем данные о постах блога. </b></p> <p>Итак, что предоставляет в наше распоряжение WordPress. Сначала сделаем кратки обзор методов из xmlrpc.php.</p> <p><b>wp.getPostStatusList </b> - выводит значения для статуса поста. По сути на выходе будем имеет четыре строки: "draft", "pending", "private", "publish".</p> <p>Пока этот метод нам бесполезен.</p> <p><b>blogger.getRecentPosts </b>- эта функция уже из API Blogger, но поддерживается в WordPress. На выходе будем иметь последние посты блога, включая весь контент поста.</p> <p>Можно использовать метод, НО работа программы будет замедлена так как придётся "тягать" по Сети пост целиком. А если попробуем получить список постов блога целиком, то, видимо придётся ложиться спать, не дождавшись результата. Следовательно - пока оставляем метод в стороне.</p> <p><b>metaWeblog.getRecentPosts </b> - аналогично предыдущему методу.</p> <p><b>mt.getRecentPostTitles </b> - метод из MovableType API. Судя по названию - то, что нам надо. Смотрим описание метода.</p> <p>Метод возвращает список, содержащий заголовки постов блога. При этом контент в список не записывается.</p> <p>Входные параметры:</p> <ul><li>String blogid</li> <li>String username</li> <li>String password</li> <li>int numberOfPosts</li> </ul><p><b>blogid </b>всегда равен 1 (см. описание в xmlrpc.php)</p> <p><b>numberOfPosts </b>- количество постов, которые необходимо вывести в список. Если параметр имеет значение больше, чем количество постов в блоге, то метод возвращает список всех постов.</p> <p>Осталось узнать, что из себя представляет этот список. А на выходе мы будем иметь массив структур, включающий в себя:</p> <ul><li>дату создания элемента</li> <li>userid</li> <li>postid</li> <li>заголовок.</li> </ul><p>Замечательно. Воспользуемся этим методом, а заодно научимся анализировать сложные структуры ответа.</p> <p>Про создание запроса, думаю, писать не стоит. Процедура аналогична той, что рассмотрена выше. А на анализе ответа сервера остановимся подробно. Стем как выглядит тип struct (структура) мы познакомились при парсинге ответа, содержащего ошибку авторизации. Посмотрим, что из себя представляет массив.</p> <p>Массивы не имеют названия и описываются тегом <array>. Он содержит один элемент <data> и один или несколько дочерних элементов <value>, где задаются данные. В качестве элементов массива могут выступать любые другие типы в произвольном порядке, а также другие массивы - что позволяет описывать многомерные массивы. Так же можно описывать массив структур. Например, массив из четырех элементо будет выглядеть так:</p> <p><value><i4>34</i4></value></p> <p><value><string>Привет, Мир!</string></value></p> <p><value><boolean>0</boolean></value></p> <p><value><i4>-34</i4></value></p> <p>У нас на выходе из метода <b>mt.getRecentPostTitles<br></b>будет содержаться <b>массив структур </b>, причём одна структура - это информация по одному посту блога. Следовательно, чтение данных по постам блога можно условно разделить на следующие шаги:</p> <p>1. Выделяем из XML-документа все элементы <b>value </b></p> <p>2. В каждом <b>value </b>читаем все элементы <b>member </b></p> <p>3. каждый второй дочерний элемент у <b>member </b>- данные по посту, которые необходимо запомнить.</p> <p>Начнем сразу с обработки ответа. Вводим новый тип данных:</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>TBlogPost = packed record</p> <p>user_id: integer;</p> <p>dateCreated: string;//пока будем хранить дату "как есть"</p> <p>TBlogPosts = array of TBlogPost;</p> </td> </tr></tbody></table><p>Обрабатываем ответ сервера.</p> <table style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; BORDER-TOP: #e0e0e0 1px solid; BORDER-RIGHT: #e0e0e0 1px solid" border="0" cellpadding="0" width="100%"><tbody><tr><td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> </td> <td style="BORDER-BOTTOM: #e0e0e0 1px solid; BORDER-LEFT: #e0e0e0 1px solid; BORDER-COLLAPSE: collapse; FONT-FAMILY: Verdana, " ms="" sans="" serif="" sans-serif="" arial="" color:="" font-size:="" border-top:="" solid="" border-right:="" bgcolor="#c0c0c0"> <p>//т.к. в массиве всего 1 тэг data, то можно получить список элементов так</p> <p>Values:=Doc.DOMDocument.getElementsByTagName("data").item.childNodes;</p> <p>SetLength(Result,Values.length);</p> <p>for i:= 0 to Values.length-1 do</p> <p>Members:=Values[i].firstChild.childNodes;//получили все members для 1 value</p> <p>for j:=0 to Members.length - 1 do</p> <p>with Result[i]do</p> <p>0:dateCreated:=(Members[j].lastChild.firstChild as IDOMNodeEx).text;</p> <p>1:user_id:=StrToInt((Members[j].lastChild.firstChild as IDOMNodeEx).text);</p> <p>2:id:=StrToInt((Members[j].lastChild.firstChild as IDOMNodeEx).text);</p> <p>3:title:=(Members[j].lastChild.firstChild as IDOMNodeEx).text;</p> </td> </tr></tbody></table><p>Соответственно, если получено сообщение об ошибке, то можно воспользоваться рассмотренной ранее функцией.</p> <p>На сегодня всё. В следующий раз продолжим работу с API и попробуем получить все комментарии из блога.</p> <p>Всех приветствую! Несколько лет писал на Матлабе, а тут приспичило на Дельфи программу написать.</p><p>Мне необходимо научиться работать с xml-документами. Работаю в RAD Stiduo XE3. Там есть компонент TXMLDocument, наверно, известный многим программящим на Delphi. Вроде бы и умеет много. Но проблема в том, что по нему нет понятной документации и описания. Хэлп в RAD Studio - фигня, потому что нормальной информации там нет; только разбросанная по страницам скудная справка по некоторым методам и процедурам (без примеров и нормального описания). Перерыл весь инет. Нашёл только темы на форумах с решением конкретных задач, где надо ещё час догадываться, что делает та или иная строка, связанная с обращением к xml-файлу. <br> Мне же нужно руководство по основным функциям, процедурам и методам, применяемым при работе с xml. Учебник, мануал, описание. Или хотя бы "xml в Delphi для чайников". Например:</p><p><i>Для открытия xml-файла используем метод XMLDocument1.LoadFromFile("filemane.xml"), где filename - имя файла.<br> Переменная nodelist типа IXMLNode служит для хранения списка дочерних элементов. Для определения этого списка служит метод Xmldocument1.DocumentElement (где XMLDocument1 - исследуемый xml-файл).<br> Чтобы запросить содержимое дочернего элемента "element1" используется метод XMLDocument1.DocumentElement.ChildNodes[ "element1"].Text...<br></i><br> и в таком духе дальше по всем применяемым методам, процедурам, типам данных.<br> Где найти подобные мануалы/описания? Кто может помочь?</p><p>Если нужна конкретная задача, опишу её.<br>Имеется xml-документ вида:</p><p> <br><ltm version="1.0" type="settings" ><br><progname>LTM</progname></p><p><templateFiles><br> <assets>fon.png</assets><br> <assets>up.jpg</assets><br> <images><br> <pano> <tiles>pano_u.jpg</tiles><br> <tiles>pano_f.jpg</tiles><br> </pano><br> <tour><br> <tourimages>start.jpg</tourimages><br> <tourimages>tmb.jpg</tourimages><br> </tour><br> </images><br></templateFiles><br><dimensions><br> <tiles type="pc">1910</tiles><br> <tiles type="ipad">768</tiles><br> <tiles side="iphone">512</tiles><br> <tourimages name="start.jpg" edge="long">1024</tourimages><br> <tourimages name="start.jpg" edge="short">768</tourimages><br></dimensions></p><p><hotspot name="hs015_2" style="mappoint" scena="scene017" ath="68.17644363437007" /><br><hotspot name="hs015_1" style="mappoint" scena="scene014" rz="4436007" /> <br><data name="onstart" mode="noVoice">Some text</data><br><data name="onerror" mode="noVoice">Some errortext</data><br><data name="onerror" mode="alarm">Other errortext</data></p><p>В коде программы имеем:</p><p>var<br>...<br>parent, child1: IXMLNode;</p><p>begin<br>XMLDocument1.LoadFromFile("f:\filename.x ml");<br>XMLDocument1.Active:=true;<br>.<br>.<br>end</p><p>Что надо научиться делать:<br>(заранее извиняюсь, если неверно называю составляющие xml-документа)<br> 1. Получить имя корневого элемента (в нашем случае ltm), а также список его атрибутов (version, type) и их значения ("1.0", "settings").<br> 2. Получить количество элементов, являющихся дочерними по отношению к корневому. В данном случае их 7: templateFiles, dimensions, hotspot, hotspot, data, data, data. Получить имена элементов (тэгов) (templateFiles, dimensions и т. п.). Получив количество элементов и научившись извлекать их имена, я прогоню цикл от 0 до count-1 и сделаю что мне нужно.<br> 3. Получить количество и список атрибутов требуемого элемента. Например, для элемента hotspot. Правильный ответ будет 4 атрибута. Для первого элемента hotspot это будут name, style, scena, ath. Для второго - то же, только вместо атрибута ath - атрибут rz.<br> Заметьте, в файле 2 элемента hotspot, с разными атрибутами. Вот как с ними работать (если одноимённых элементов больше 1)?<br> Я хочу так: получаю список дочерних элементов по отн. к корневому (см. п. 2), прогоняю по ним цикл с for и найду элементы hotspot, у которых параметр name равен требуемому (скажем "hs015_2" - такой элемент будет заведомо один). Можно ли как-то решить этот вопрос без цикла? То есть, получить значение атрибута scena для элемента hotspot, у которого name="hs015_2"?<br> 4. Проделать вышеописанное по отношению к узлам и элементам, являющимся дочерними по отношению к дочерним. В моём примере - узел (дочерний по отношению к и родительский по отношению к и.<br> Если я правильно понимаю, надо как-то передать содержимое узла в переменную типа IXMLNode и делать то же, что и в п.1-3. Так?</p><p>5. Надо научиться изменять вышеуказанные параметры (задавать свои).</p><p>Вроде пока всё. На данном этапе мне важнее всего синтаксические конструкции.<br> Кто владеет этой темой, напишите пожалуйста и другие синтаксические конструкции для решения вышеописанных вопросов (как получить атрибуты, их кол-во, кол-во элементов, их имена и т. п.). Главное сейчас - овладеть синтаксисом, а свой алгоритм я уж реализую потом. Заранее всем огромное спасибо!</p><p>P.S. Очень не хотелось бы писать с нуля свой парсер XML только потому, что к имеющимся нет нормального описания.</p> <script>document.write("<img style='display:none;' src='//counter.yadro.ru/hit;artfast_after?t44.1;r"+ escape(document.referrer)+((typeof(screen)=="undefined")?"": ";s"+screen.width+"*"+screen.height+"*"+(screen.colorDepth? screen.colorDepth:screen.pixelDepth))+";u"+escape(document.URL)+";h"+escape(document.title.substring(0,150))+ ";"+Math.random()+ "border='0' width='1' height='1' loading=lazy>");</script> </div> <dblock></dblock> <dblock></dblock> <dblock></dblock> <dblock></dblock> <dblock></dblock> </div> </div> <div class="grid_4"> <ul id="sidebar"> <div class="widget cat-lists"> <div class="outer"> <div class="menu-sidebar-container"> <ul id="menu-sidebar" class="menu"> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/internet/">Интернет</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/programs/">Программы</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/games/">Игры</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/problems/">Проблемы</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/windows/">Windows</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/social-networks/">Социальные сети</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/android/">Android</a></li> <li class="menu-item menu-item-type-taxonomy menu-item-object-category"><a href="/category/ios/">Ios</a></li> </ul> </div> </div> <script> function fd() { var menu = document.querySelector('.menu-wrapper') // Using a class instead, see note below. menu.classList.toggle('active'); } function fds(e) { var menu = document.querySelector('.' + e) // Using a class instead, see note below. menu.classList.toggle('active'); } </script> </div> <li id="text-46" class="widget widget_text"> <div class="textwidget"> </div> </li> <li id="text-9" class="widget widget_text"> <div class="textwidget"> <div class="subscription" id="sidebar-sub"> <div class="gradient-sub"></div> <p class="head-sub">Присоединяйтесь!</p> <p class="description-sub"> Уже подписаны более 6 000 человек.<br> Получайте самые свежие статьи. </p> <form action="/" method="post" target="_blank" id="subscr-form-6292" onsubmit="return jc_chkscrfrm(this, false, false, false, false)"> <input type="text" name="lead_email" class="sr-required" placeholder="Введите ваш e-mail" maxlength="100"> <button type="submit" name="lead_subscribe" value="Подписаться">ПОДПИСАТЬСЯ</button> </form> <div class="ribbon"></div> </div> </div> </li> <li id="text-36" class="widget widget_text"> <div class="textwidget"> </div> </li> <div id="sticky-anchor"></div> <div id="sticky"> <div id="owl-demo2" class="owl-carousel owl-theme"> <div class="item"> </div> </div> </div> <script> var stk = true; </script> <style> #owl-demo2 .item { background: #3fbf79; margin: 10px; color: #FFF; -webkit-border-radius: 3px; -moz-border-radius: 3px; border-radius: 3px; text-align: center; } .customNavigation { text-align: center; } //use styles below to disable ugly selection .customNavigation a { -webkit-user-select: none; -khtml-user-select: none; -moz-user-select: none; -ms-user-select: none; user-select: none; -webkit-tap-highlight-color: rgba(0, 0, 0, 0); } </style> <link href='/assets/owl.theme.css' rel='stylesheet' type='text/css'> <link href='/assets/owl.carousel.css' rel='stylesheet' type='text/css'> <link href='/assets/owl.transitions.css' rel='stylesheet' type='text/css'> </ul> </div> <div class="clear"></div> <a class="btn-floating btn-large red" href="#"></a> <footer> <script type="text/javascript"> function GoTo(link) { window.open(link.replace("_", "http://")); } </script> <div class="grid_12"> <p id="footer"><a href="/">Интернет, компьютеры, гаджеты</a> - Копирование материалов строго запрещено. <br><a href="" target="_blank">О проекте</a> <br><a href="" target="_blank">Реклама на сайте</a> <script src="https://ajax.googleapis.com/ajax/libs/jquery/1/jquery.min.js"></script> <script type="text/javascript" src="/assets/modernizr.min.js"></script> <script type="text/javascript" src="/assets/jquery.slicknav.js"></script> <script type="text/javascript" src="/assets/main.js"></script> <script type="text/javascript" src="/assets/include.js"></script> <script type="text/javascript" src="/assets/jquery.fancybox.js"></script> <script type="text/javascript"> $(document).ready(function() { $('.fancybox').fancybox(); }); </script> <script type="text/javascript"> window.___gcfg = { lang: 'ru' }; (function() { var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true; po.src = 'https://apis.google.com/js/plusone.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s); })(); </script> <div id="fb-root"></div> <script> (function(d, s, id) { var js, fjs = d.getElementsByTagName(s)[0]; if (d.getElementById(id)) return; js = d.createElement(s); js.id = id; js.src = "https://connect.facebook.net/ru_RU/all.js#xfbml=1"; fjs.parentNode.insertBefore(js, fjs); }(document, 'script', 'facebook-jssdk')); </script> </div> <div class="clear"></div> </footer> </div> <script type='text/javascript' src='/assets/jquery.form.min.js'></script> <script type='text/javascript' src='/assets/scripts.js'></script> <script type='text/javascript' src='/assets/postviews-cache.js'></script> <script type='text/javascript' src='/assets/wp-embed.min.js'></script> <script type='text/javascript' src='/assets/form.js'></script> <script type='text/javascript' src='/assets/jquery.fancybox-1.3.8.min.js'></script> <script type='text/javascript' src='/assets/jquery.easing.min.js'></script> <script type="text/javascript"> jQuery(document).on('ready post-load', function(){ jQuery('.nofancybox,a.pin-it-button,a[href*="pinterest.com/pin/create/button"]').addClass('nolightbox'); } ); jQuery(document).on('ready post-load',easy_fancybox_handler); jQuery(document).on('ready',easy_fancybox_auto);</script> </body> <script>// <![CDATA[ $(".closed").toggleClass("show"); $(".title").click(function(){ $(this).parent().toggleClass("show").children("div.contents").slideToggle("medium"); if ($(this).parent().hasClass("show")) $(this).children(".title_h3").css("background","#bbbbbb"); else $(this).children(".title_h3").css("background","#dddddd"); } ); // ]]></script> <script> $(".single-post .post a:has(img), .single-post .entry-content a:has(img)").fancybox(); $('.sub-menu').parent().addClass('after'); $('.mobile_menu .ya-site-form__input-text').attr('id', 'unstapble-transparent'); $('.sub-menu').parent().children('a').attr("onclick", "$(this).parent().toggleClass('active');return false;"); // $('.nav-list-mobile li a').click(function() { // $(this).parent().toggleClass('active'); // return false; // } ); function tg_menu () { $('.mobile_menu').toggleClass('active'); $('.google_search_mob').toggleClass('active'); } ; if (stk) { $(document).ready(function() { $(window).scroll(sticky_relocate); sticky_relocate(); function sticky_relocate() { var window_top = $(window).scrollTop(); var div_top = $('#sticky-anchor').offset().top; if (window_top > div_top) { $('#sticky').addClass('stick'); } else { $('#sticky').removeClass('stick'); } } } ); } if (carusel) { } </script> <script src="/assets/owl.carousel.min.js"></script> <script> var owl2 = $("#owl-demo2"); owl2.owlCarousel({ items : 1, //10 items above 1000px browser width lazyLoad : true, itemsDesktop : [1000,1], //5 items between 1000px and 901px itemsDesktopSmall : [900,1], // betweem 900px and 601px itemsTablet: [600,1], //2 items between 600 and 0 itemsMobile : [479,1] // itemsMobile disabled - inherit from itemsTablet option } ); // Custom Navigation Events // $(".next").click(function(){ // owl.trigger('owl.next'); // } ) // $(".prev").click(function(){ // owl.trigger('owl.prev'); // } ) owl2.trigger('owl.play',5000); //owl.play event accept autoPlay speed as second parameter // $(".stop").click(function(){ // owl.trigger('owl.stop'); // } ) </script> </html>