Использование XML в среде Delphi (исходники)

Рис 5.	Рис 6.

Основное приемущество передачи информации в виде XML-документов в том, что существует возможно формировать сообщение, используя независимые структуры таблиц в СУБД как на принимаемой, так и на передаваемой стороне. Используя наш пример, пусть требуется передать информацию об инвойсах Предприятия А, из СУБД имеющий структуру, изображенную на рис. 6

Для формирования xml-документа, содержащего инвойс первоначально строится SQL-запрос (запрос А) с информацией о самом инвойсе:

    SELECT * FROM Invoice_General
    WHERE InvoiceNum = :num                      // :num  - параметр, который задает номер инвойса. 

и далее строится SQL-запрос (запрос В) информация о товарах, описываемых в инвойсе (детальная спецификация):

    SELECT Goods,Qulity,Price, HZ_cod 
    FROM Goods 
    WHERE InvoiceNum = :num                      // :num - параметр, который задает номер инвойса. 

Ниже представлена часть программы, формирующей тело xml-документа:

procedure TThread1.DataBodyCreate(Sender: Tobject);
var
  //coDoc      : CoDomDocument ;              // объявление сокласса и объекта XMLDomDocument 
  //Doc        : DomDocument ;                // должно быть глобальным, для всего модуля. 
  
  r            : IXMLDOMElement;              // объявление объектов DOMElement
  Node, Node2  : IXMLDOMElement;              //                     DOMElement;
  Node3, Node4 : IXMLDOMElement;              //                                  
  txt          : IXMLDOMText;                 //                     DOMText
  str          : String;

// InvoiceNumber: integer;  - глобальная переменная - имеет значение 987654 
// queryA, queryB : String;  - глобальная переменная, имеет значение, соответсвующее запросу
// queryA - запрос А генеральная информацией об инвойсе
// queryB - запрос B информация о товарах, описываемых в  инвойсе (см. текст)

begin

  Query.Close;                                     // закрывает запрос для доступа
  Query.Text := queryA;                            // см. по тексту "запрос А"

 Query.Params[0].AsInteger := InvoiceNumber;       // присваивание значения параметров
 Query.ExecSQL;                                    // выполнение запроса
 Query.Open;                                       // открытие доступа к данным запроса 

  r:=Doc.Get_documentElement;                      // получение адреса корневого элемента

  Node2 := Doc.createElement ( ' Request ');       // создание DOMElement (таг ) 
  Node := Doc.createElement ( 'Invoice');          // создание DOMElement (таг ) 
  r.appendChild(Node2);                            // добавление элемента  в корень
  Node2. appendChild(Node);                        // добавление элемента  в  
  
  Node3 := Doc.createElement ( 'Depurture') ;      // создание DOMElement (таг )                  
  Node. appendChild(Node3);                        // добавление элемента  в 

  str:= Query.FieldByName('Depurture').AsString;   // обращение к полю 'Depurture' запроса
  txt := Doc.createTextNode( str);                 // создание техстового узла = значению поля  
  Node.appendChild(txt);                           //  присвоение узлу  значение 
                                                   // техстового узла, переменной str 

// аналогичные операции для тага , , , 
//  (поле DB  "Consignee" )

  Node := Doc.createElement ( 'Destination');                  
  str:= Query.FieldByName('Consignee ').AsString;    // имя поля БД может и не совпадать с именем 
  txt := Doc.createTextNode( str);                   // тага, в этом приемущество использования 
  Node.appendChild(txt);                             // DOM интерфейса перед СУБД, имеющим 
                                                     // поддержку XML-интерфейса, типа ORACLE 8i 
...                                                  // или Ms SQL 2000
                                                     // формирование запроса на спецификацию по товарам 
 Query.Close;                                        // закрывает запрос для доступа
 Query.Text := queryВ;                               // см. по тексту "запрос В", информац. О товарах

 Query.Params[0].AsInteger := InvoiceNumber;         // присваивание значения параметров
 Query2.ExecSQL;                                     // выполнение запроса
 Query.Open;                                         // открытие доступа к данным запроса 

Node3 := Doc.createElement ( ' Imems') ;             // создание DOMElement (таг )                  
Node. appendChild(Node3);                            // добавление элемента  в 

while not Eof.Query do begin                         // цикл по всем строкам запроса
   Node4 := Doc.createElement ( 'Imem');
   Node3.appendChild(Node4);                         // добавление элемента  в 
  
  str:= Query.FieldByName('Price').AsString;         // формирование данных для тага 
  txt := Doc.createTextNode( str); 
  Node.appendChild(txt); 
  ...
// аналогичные операции для тагов , , 
  end;
end;

В результате выполнения данной процедуры формируется следующий текст XML-документа:

Для формирования запроса используется метод Open объекта IXMLHttpRequest:

procedure Open(const bstrMethod,        - тип метода ="POST"
          bstrUrl,                      - Url адрес сервера
          varAsync,                     - режим связи асинхронный/синхронный = true
          bstrUser,                     - имя пользователя для аутентификации
          bstrPassword)                 - пароль

Создании серверной части обработки документа

Как было отмечено ранее, обработка HTTP запроса может осуществляться либо CGI-приложениями, либо Java-сервлетами. Возможен и вариант написания ASP-страниц. Но в этом случае передача данных возможна только методом "GET" через строку запроса. Хотя, обработка HTTP запроса ASP-страниц работает более эффективнее, чем CGI-приложением. Однако, на мой взгляд, без разницы, как обрабатывать, а важнее решить вопрос - как построить программму обработки, а не какими средствами.

Если из предыдущей главы мы рассмотрели варианты формирования XML-документ, то задача серверного приложения обратная - разбор XML-документов. Ниже представлена часть программы, осуществляющей разбор xml-документа:

procedure Tthread1.DataParser(Sender: Tobject);
var

  r,FNode          : IXMLDOMElement;                       // объявление объектов DOMElement
  Str,Filename     : String;
  parm             : String;

CoDocXML, CoDocXSL, CoDocResult      : CoDomDocument ;     // объявление сокласса и
XMLDoc, XSLDoc, ResultDoc            : DomDocument ;       // объекта XMLDomDocument 

// HttpStr : String; - глобальная переменная, содержащая строку HTTP запроса

Begin

  XMLDoc:=coDocXML.Create;                 // создание документа XMLDoc
  XMLDoc.Set_async(false);                 // установка синхронного режима обрабработки
  XMLDoc.LoadXML(HttpStr);                 // загрузка DOM документа из строки HttpStr

  r:=Doc.Get_documentElement;                        // получение адреса корневого элемента
  FNode:= r.SelectSingleNode("//TypeDocument");      // получение значения элемента 
  FileName:= FNode.GetAttibute("id");                // получение значения аттрибута id="Order"
  FileName:= FileName+".xsl";                        // и формирование имени файла Order.xsl

  XSLDoc:=coDocXSL.Create;                           // создание документа XSLDoc
  XSLDoc.Set_async(false);                           // установка синхронного режима обрабработки
  XSLDoc.LoadXML(FileName);                          // загрузка DOM документа из файла Order.xsl

  ResultDoc:=coDocResult.Create;                     // создание документа XMLDoc
  ResultDoc.Set_async(false);                        // установка синхронного режима обрабработки
  ResultDoc.validateOnParse := true;                 // установка проверки разбора
 
  XMLDoc.transformNodeToObject(XSLDoc, ResultDoc);   // разбор XMLDoc по XSL-шаблону
	 
 Str:= ResultDoc.text;                               // переменной Str присваивается текстовое значение 
                                                     // результирующего документа.

 FNode:= r.SelectSingleNode("//InvoiceNumber");      // поиск элемента 
 parm:= FNode.text;                                  //  и получение значения элемента

 Query.Close;                                        // закрывает запрос для доступа
 Query.Text := Str; 
 Query.Params[0].AsString := parm;                   // присваивание значения параметра
 Query.ExecSQL;                                      // выполнение запроса

end;

Вся изюминка разбора заключается в применении XSL-шаблона, который сформирован для каждого типа документа индивидуально. Результатом разбора является строка SQL-запроса. Впоследствие выполнение сформированной строки SQL-запроса осуществит необходимые изменения данных в СУБД.

Приимущество использования разбора через щаблон еще и в том, что получается некая гибкость данных, и получается полная независимость работы алгоритма от программного кода. Ниже приведен используемый для обработки документа типа 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>

Поясняя вышеприведенный пример, надо отметить, что использование пары тагов и носит формальный характер, т.к. после разбора в результирующем XML-документе формально должен присутствовать хотябы один узел. Метод ResultDoc.text присваивает текстовае значение полученного в ходе разбора XML-документа ResultDoc. В этом случае значением является все то, что обрамлено пары тегов и , т.е. сформированный нами SQL-запрос.

Другой особенностью написания программы надо отметить возможность использования SQL-параметра :num. Использование параметра позволяет упростить текст xsl-шаблона. Определение значение соответствующих элементов узлов XML-документа определякется первоночально выбора по имени соответствующего узла, например:

FNode:= r.SelectSingleNode("//InvoiceNumber");   // поиск элемента >InvoiceNumber> и далее использование свойства text:
parm:= FNode.text;                               //  и получение значения элемента >InvoiceNumber>

Коротко об XSL

Абревиатура XSL происходит от eXtensible Stylesheet Language - язык форматирования таблиц стилей (XML данных). Как понятно из заголовка eXtensible Stylesheet Language (XSL) используется для форматирования XML данных. По определению W3C XSL состоит из двух частей:

• XSLT - XSL Transformation. Язык, используемый для преобразования или форматирования (трансформирования) XML документов. Таким образом, при помощи XSLT мы можем получить разные разрезы множества данных и формы представления данных.
• Элементы форматирования. К этим элементам относятся все элементы типографического оформления данных, после их обработки их при помощи XSL. Используется только для формирования HTML страниц.

При помощи XSLT мы можем отобрать нужные нам данные из XML файла, и оформить их в виде для предоставления пользователю. Например, в нашем случае мы преобразовали XML данные в виде SQL запроса. Классическое применение XSL - это, как правило форматирование данных в виде HTML страниц или более редкое представление в виде RTF файлов.

XSL файл описывает шаблон (template), согласно которому будет совершаться преобразование XML данных. Возращаясь к xsl-шаблонам, в XSLT можно выделить следующие элементы (директивы):

Заключение

В заключение, необходимо отметить, что использование стандартного XML-парсера msxml.dll является не единственным средством разбора и создания XML-документов. Например, для создание XML документов эффективно использовать компоненты TPageProduser и TТableProduser. Но, данная статья лишь подчеркивает широту и возможность применения на практике DOM модели.

Автор будет очень благодарен за отзывы об актуальности темы, общем содержании, стиле изложения, а также всем остальным комментариям, которые помогут в дальнейшем улучшить качество написания сборника статей и выпуску книги, освещающую тему практической стороны использования XML-документов в электронной коммерции. Более подробную информацию о практической стороне применения электронных документов можно почерпнуть на авторском сайте www.eDocs.al.ru Также на авторском сайте планируется разместить исходные тексты и примеры.