Linux чем открыть xml файл

Хочу напомнить вечно спешащим братьям по цеху, чтобы они не забывали удалять номера строк, которые указаны в начале каждой строки в примере. Иначе, они будут долго удивляться — почему это компилятор на этапе трансляции исходного кода вернул ошибку.

Как видим в конце, перед завершением, мы вызываем в строке 41 функцию xmlFreeDoc(), которая освобождает память используемую под маркер типа xmlDoc. Это надо делать всегда, чтобы избежать утечки памяти.

/Work/xml-apps$./xml_metadoc ldapsi-msg.xml
XML document was parsed successfully(xml-file=[./xml_metadoc])!
The name of XML document: unknown
The version of XML standard: 1.0
The external initial encoding: UTF-8

Теперь перейдем к рекурсивному чтению структуры XML-документа, тем самым усложним наш предыдущий пример. Мы будем выводить только имена элементов и их свойств, если они есть в наличии. Пишем функцию xml_looking() рекурсивного обхода структуры XML документа и выводим на stdout то, что прочитали. Рекурсивный обход применяем потому, что мы не знаем название элементов и их свойств. Программу назовем ldap_errmsg_filetest, её исходный код сохраним в файле ldap_errmsg_filetest.с.

Как собирать программу ldap_errmsg_filetest

$(CC) `xml2-config —cflags` ldap_errmsg_filetest.c -o ldap_errmsg_filetest `xml2-config —libs`

Переменная $(CC) указывает на компилятор С, которым собирается программа ldap_errmsg_filetest.

Код программы ldap_errmsg_filetest, версия 0.1

1/*
2 * ldap_errmsg_filetest.c
3 *
4 * Version: 0.1
5 *
6 * This program is parsing XML document that puts into the stdout. This program
7 * as well verifying that the XML document have the ldap error messages and
8 * this document have a right format. It’s return a zero value.
9 * If a error will occur, the program puts a error message into the stderr.
10 * In this case, the program will terminate immediate with non-zero value.
11 *
12 * build:
13 * $(CC) `xml2-config —cflags` ldap_errmsg_filetest.c -o ldap_errmsg_filetest `xml2-config —libs`
14 *
15 * (c) 2009-2010 rjaan aka Rjavskov(Rzhavskov) &ltmalto:rjaan@yandex.ru&gt,&ltmailto:arjavskov@gmail.com>
16 *
17 * This program is free software; you can redistribute it and/or modify it
18 * under the terms of the GNU General Public License as published by
19 * the Free Software Foundation; either version 2 of the License,
20 * or (at your option) any later version.
21 *
22 * This program is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
24 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
25 *
26 * You should have received a copy of the GNU General Public License along with this program;
27 * if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
28 *
29 * (c) rjaan \n», argv[0]);
53 return 1;
54 >
55
56 doc = xmlParseFile ( argv[1] );
57 if ( doc == NULL ) <
58 fprintf(stderr, «This document was not parsed. xml-file=[%s]\n » , argv[0]);
59 return 1;
60 >
61 /*
62 execution the 1st test.
63 */
64 fprintf(stdout, «1st test. XML document looking that is \’%s\’ xml-file\n», argv[1] );
65 root_dn = xmlDocGetRootElement ( doc );
66 if ( root_dn == NULL ) <
67 fprintf(stderr, «The error occur! This document is empty!\n» );
68 xmlFreeDoc (doc);
69 return 1;
70 >
71 fprintf(stdout, «line %06d: \n», line, root_dn->name );
72 xml_document_round( root_dn->children , 1, line );
73 fprintf(stdout, «line %06d: \n», total_line, root_dn->name );
74
75 fprintf ( stdout, «test is passed!\n» );
76 xmlFreeDoc (doc);
77 return 0;
78 >
79
80 static void xml_document_round( xmlNodePtr curr_dn, int level, int line )
81 <
82
83 while( curr_dn ) <
84 if ( curr_dn->type == XML_ELEMENT_NODE ) <
85 int i;
86 fprintf(stdout, «line %06d: «, ++line );
87 for ( i = 0; i properties ) <
91 xmlAttrPtr properties;
92
93 fprintf(stdout, » name );
94 properties = curr_dn->properties;
95 while ( properties ) <
96 fprintf(stdout, «%s=\»%s\» «, properties->name,
97 xmlGetProp ( curr_dn, properties->name ) );
98
99 properties = properties->next;
100 >
101 fprintf(stdout, «>\n»);
102 >else <
103 fprintf(stdout, » \n»,curr_dn->name );
104 >
105 >
106 if ( curr_dn->children ) <
107 xml_document_round( curr_dn->children, ++level , line );
108 >
109 curr_dn = curr_dn->next;
110 >
111 total_line = line + 1;
112 >
113
114 /*eof */

Как видим по сравнению с программой xml_metadoc, которая выводит метаданные XML документа из маркера xmlDoc, программа ldap_errmsg_filetest значительно усложнилась, что видим из её кода в файле ldap_errmsg_filetest.c .

Изменился заголовок, строки 1-30, он приведён в соответствии с указаниями, которые приводятся в конце лицензии GNU General Public License.

В строках 36-38 указываются заголовочные файлы прототипов API-функций и типов данных XML библиотеки libxml2, которые мы используем в этой программе. А в строках 32-34, заголовочные файлы прототипов API-функций и типов данных С библиотеки, известной всем как GLIBC .

В строке 44, 45 объявляем два указателя на маркеры — документа XML и корневого элемента в этом документе. Маркер документа XML(xmlDoc) рассматривался нами выше, а корневой элемента(xmlNode) будем разберём чуточку ниже.

В строке 44, 45 объявляем два указателя на маркеры — документа XML и корневого элемента в этом документе. Маркер документа XML(xmlDoc) рассматривался нами выше, а корневого элемента(xmlNode) разберём чуточку ниже.

В строке 46 объявляем целочисленную переменную line, которая будет являться номером строки. Так корневой элемент будет всегда в нулевой строке XML-документа. Строка с XML-декларацией игнорируется.

В строке 49 инициализируем статическую переменную total_line типа int которая будет содержать итоговое количество прочитанных элементов XML-документа. Эта переменная была объявлена ранее в строке 40.

В строке 56 мы производим разбор XML-документа через API функцию xmlParseFile() библиотеки libxml2. Если указатель на маркер у нас не нулевой мы переходим к анализу дерева XML-документа. Иначе, мы немедленно завершимся с ненулевым значением и передачей на stderr сообщения, что этот XML-документ не был разобран с именем файла, указанного в первом и единственном аргументе программы. Любые отклонения от стандарта XML могут привести к такому плачевному результату.

В строке 65, мы пытаемся получить указатель на корневой элемент, который описывается типом xmlNode Этот тип мы будем встречать не только как описание элементов XML-документа, но и их свойств. Тип xmlNode является структурой _xmlNode. Из этой структуры нам будут интересны поля связанные с указателем на дочерние и соседние элементы, а так же тип элемента, который нам понадобится при анализе его структуры, но об этом позже. Ниже привожу декларацию самой структуры _xmlNode и интересующих нас полей.

Structure xmlNode struct _xmlNode <
· · ·
xmlElementType type; /*Тип элемента у нас он будет имет либо
текстовый тип, имеющее значение 2, либо
тип определяющий элемент*/
const xmlChar *name;/* Имя элемента */
struct _xmlNode *children; /* Указатель на дочерние элементы */
· · ·
struct _xmlNode * next; /* Следующий соседний элемент */
struct _xmlNode * prev; /* Предыдущий соседний элемент */
struct _xmlAttr * properties; /* Указатель на свойства элемента */
· · ·
>;

В строке 66, если указатель на корневой элемент не был получен, считаем, что документ пустой и завершаемся с ненулевым значением, т.к. не достигли цели. Иначе, мы переходим к рекурсивному обходу с помощью вызова функции xml_document_round(), которая реализует его в строках 80-112.

В основном цикле этой функции, строки 83-110, мы просматриваем соседние элементы, до тех пор пока указатель curr_dn — текущим элемент не будет равен нулю. Если null-указатель будет передан в 1-м аргументе самой функции xml_document_round(), то как мы видим по условию выполнения цикла, строка 83, функция будет немедленно завершена. Кстати, на манипуляции с этой переменной и самой функции xml_document_round(), которая вызывается из собственного тела функции, строится рекурсия.

В строки 87- 89 мы осуществляем кол-во отступов от первого символа в строке, которые задаются уровнем вложения элемента в иерархической структуре XML-документа. Его значение содержится в 2-ом аргумент level функции xml_document_round(), значение которого приращивается в строке 107 перед рекурсивным вызовом функции xml_document_round().

В строках 90-102 мы выводим содержимое свойств элемента. Как мы уже говорили свойства элемента описываются одной и той же структурой, что и сам элемент. Поэтому имя свойства и элемента всегда находится в поле _xmlNode::name, а вот само значение свойства возвращает API-функция xmlGetProp() библиотеки libxml2, который мы передаем в 1-м аргументе.

Пример использования программы ldap_errmsg_filetest

/Work/xml-apps$. ./ldap_errmsg_filetest ldapsi-msg.xml
1st test. XML document looking that is ‘ldapsi-msg.xml’ xml-file
line 000000:
line 000001:
line 000002:
line 000003:
line 000004:
line 000005:
line 000006:
line 000007:
line 000008:
line 000009:
line 000010:
line 000011:
line 000012:
line 000013:
line 000014:
line 000015:
line 000016:
line 000017:
line 000018:
line 000019:
line 000020:
test is passed!

Теперь, как только мы научились выводить содержимое XML-документа, мы можем приступить к его анализу для выявления нарушений в декларации элемента , который должен содержать код ошибки LDAP(свойство id) и следующее за ним текстовое сообщение(свойство — msg). Такой формат элемента , который мы разбирали выше, является обязательным и отсутствие какого-либо одного из двух свойств этого элемента будем считать грубой ошибкой и завершать немедленно дальнейшую проверку содержимого XML-документа выходом из программы. Поэтому мы добавляем второй тест, который будет на самом деле искать отклонения от формата элемента и выводить их на stderr. Так же мы будем проверять имя элемента , чтобы выявить ошибки в его написании.

Тестирование будет производится случайным перебором кодов ошибок LDAP(свойство id) в диапазоне значений от 0 до 25 с количеством итераций равным 30-ти, что непременно приведет к ошибки теста в нахождении элемента по значению свойства id, в связи c отсутствием таких в нашем файле ldapsi-msg.xml, которые содержали бы значения от 22 до 25. Эту ошибку теста, мы будем игнорировать, так как она не относится к нарушению формата представления элемента , а скорее просто указывает, что такой код ошибки в библиотеки LDAP не используется.

Код программы ldap_errmsg_filetest, версия 0.2

1 /*
2 * ldap_errmsg_filetest.c
3 *
4 * Version: 0.2
5 *
6 * This program is parsing XML document that puts into the stdout. This program
7 * as well verifying that the XML document have the ldap error messages and
8 * this document have a right format. It’s return a zero value.
9 * If a error will occur, the program puts a error message into the stderr.
10 * In this case, the program will terminate immediate with non-zero value.
11 *
12 * build:
13 * $(CC) `xml2-config —cflags` ldap_errmsg_filetest.c -o ldap_errmsg_filetest `xml2-config —libs`
14 *
15 * Copyright (c) 2009-2010 rjaan aka Andrey Rjavskov(Rzhavskov)
16 *
17 *
18 * This program is free software; you can redistribute it and/or modify it
19 * under the terms of the GNU General Public License as published by
20 * the Free Software Foundation; either version 2 of the License,
21 * or (at your option) any later version.
22 *
23 * This program is distributed in the hope that it will be useful,
24 * but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
25 * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
26 *
27 * You should have received a copy of the GNU General Public License along with this program;
28 * if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
29 *
30 */
31/
32#include
33#include
34#include
35
36#include

По сравнению с версией 0.1 текущая версия 0.2 имеет значительные отличия. Добавляется код, начиная с строки 42, код ошибки — переменная my_errno, которая будет содержать целочисленные значения макросов перечисленных в строках 44 -48 , являющиеся ошибками формата элемента . Значения представлены в шестнадцатеричной системе счисления. Значения присваиваются переменной my_errno только в функции ldap_message_get_by_id(), на которой строится весь второй тест.

Макрос NONE_MYERROR с кодом 0x00 обозначает, что ошибки в формате элементов в текущем XML-документе не были найдены

Макрос DOC_EMPTY_MYERROR с кодом 0x10 указывает, что в данном XML-документе корневой элемент не обнаружен, а указатель, который возвратит функция xmlDocGetRootElement() в строке 182 будет равен нулю.

Макрос DOC_INVALID_FORMAT_MYERRROR с кодом 0x11 указывает, что неправильно введено имя элемента или его свойства. Так же, если не была соблюдена последовательность следования свойств id и msg или один из них не будет указан, той же переменной my_errno будет присвоен этот код ошибки. Проверки на этот макрос производится:

В строках 192-195, проверяется имя корневого элемента с помощью функции xmlStrcmp(), которая производит сравнение имени элемента полученного в результате разбора и ожидаемого. Если они не совпадают функция xmlStrcmp() возвращает ненулевое значение. В обратном случае, она возвратит нулевое значение, когда сравниваемые проверяемые символьные строки будут эквивалентны.

В строках 216-220, тем же самым способ проверяем, что текущий элемент имеет имя message. Если же в элементе отсутсвуют свойства как таковые или проверка в строке 234 показала, что отсутствует свойство msg или неправильно указано его имя, переменной my_errno будет присвоено значение макроса DOC_INVALID_FORMAT_MYERRROR.

Макрос DOC_INVALID_FORMAT_MYERRROR с кодом 0x12 указывает, что элементы не найдены, т.е. XML-документ не содержит ни одного кода ошибки библиотеки LDAP.

Макрос DOC_NOT_FOUND_LDAP_MSG_MYERROR с кодом 0x13 указывает, что такое сообщение с таким id, указанного в переменной check_id в строке 170, не было найдено.