main/xml.c

   1 /*
   2  * Asterisk -- An open source telephony toolkit.
   3  *
   4  * Copyright (C) 2008, Eliel C. Sardanons (LU1ALY) <eliels@gmail.com>
   5  *
   6  * See http://www.asterisk.org for more information about
   7  * the Asterisk project. Please do not directly contact
   8  * any of the maintainers of this project for assistance;
   9  * the project provides a web site, mailing lists and IRC
  10  * channels for your use.
  11  *
  12  * This program is free software, distributed under the terms of
  13  * the GNU General Public License Version 2. See the LICENSE file
  14  * at the top of the source tree.
  15  */
  16
  17 /*! \file
  18  *
  19  * \brief XML abstraction layer
  20  *
  21  * \author Eliel C. Sardanons (LU1ALY) <eliels@gmail.com>
  22  */
  23
  24 #include "asterisk.h"
  25 #include "asterisk/xml.h"
  26
  27 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
  28
  29 #if defined(HAVE_LIBXML2)
  30 #include <libxml/parser.h>
  31 #include <libxml/tree.h>
  32 /* libxml2 ast_xml implementation. */
  33
  34
  35 int ast_xml_init(void)
  36 {
  37         LIBXML_TEST_VERSION
  38
  39         return 0;
  40 }
  41
  42 int ast_xml_finish(void)
  43 {
  44         xmlCleanupParser();
  45
  46         return 0;
  47 }
  48
  49 struct ast_xml_doc *ast_xml_open(char *filename)
  50 {
  51         xmlDoc *doc;
  52
  53         if (!filename) {
  54                 return NULL;
  55         }
  56
  57         doc = xmlReadFile(filename, NULL, XML_PARSE_RECOVER);
  58
  59         return (struct ast_xml_doc *) doc;
  60 }
  61
  62
  63 void ast_xml_close(struct ast_xml_doc *doc)
  64 {
  65         if (!doc) {
  66                 return;
  67         }
  68
  69         xmlFreeDoc((xmlDoc *) doc);
  70         doc = NULL;
  71 }
  72
  73
  74 struct ast_xml_node *ast_xml_get_root(struct ast_xml_doc *doc)
  75 {
  76         xmlNode *root_node;
  77
  78         if (!doc) {
  79                 return NULL;
  80         }
  81
  82         root_node = xmlDocGetRootElement((xmlDoc *) doc);
  83
  84         return (struct ast_xml_node *) root_node;
  85 }
  86
  87 void ast_xml_free_node(struct ast_xml_node *node)
  88 {
  89         if (!node) {
  90                 return;
  91         }
  92
  93         xmlFreeNode((xmlNode *) node);
  94         node = NULL;
  95 }
  96
  97 void ast_xml_free_attr(const char *attribute)
  98 {
  99         if (attribute) {
 100                 xmlFree((char *) attribute);
 101         }
 102 }
 103
 104 void ast_xml_free_text(const char *text)
 105 {
 106         if (text) {
 107                 xmlFree((char *) text);
 108         }
 109 }
 110
 111 const char *ast_xml_get_attribute(struct ast_xml_node *node, const char *attrname)
 112 {
 113         xmlChar *attrvalue;
 114
 115         if (!node) {
 116                 return NULL;
 117         }
 118
 119         if (!attrname) {
 120                 return NULL;
 121         }
 122
 123         attrvalue = xmlGetProp((xmlNode *) node, (xmlChar *) attrname);
 124
 125         return (const char *) attrvalue;
 126 }
 127
 128 struct ast_xml_node *ast_xml_find_element(struct ast_xml_node *root_node, const char *name, const char *attrname, const char *attrvalue)
 129 {
 130         struct ast_xml_node *cur;
 131         const char *attr;
 132
 133         if (!root_node) {
 134                 return NULL;
 135         }
 136
 137         for (cur = root_node; cur; cur = ast_xml_node_get_next(cur)) {
 138                 /* Check if the name matchs */
 139                 if (strcmp(ast_xml_node_get_name(cur), name)) {
 140                         continue;
 141                 }
 142                 /* We need to check for a specific attribute name? */
 143                 if (!attrname || !attrvalue) {
 144                         return cur;
 145                 }
 146                 /* Get the attribute, we need to compare it. */
 147                 if ((attr = ast_xml_get_attribute(cur, attrname))) {
 148                         /* does attribute name/value matches? */
 149                         if (!strcmp(attr, attrvalue)) {
 150                                 ast_xml_free_attr(attr);
 151                                 return cur;
 152                         }
 153                         ast_xml_free_attr(attr);
 154                 }
 155         }
 156
 157         return NULL;
 158 }
 159
 160 const char *ast_xml_get_text(struct ast_xml_node *node)
 161 {
 162         if (!node) {
 163                 return NULL;
 164         }
 165
 166         return (const char *) xmlNodeGetContent((xmlNode *) node);
 167 }
 168
 169 const char *ast_xml_node_get_name(struct ast_xml_node *node)
 170 {
 171         return (const char *) ((xmlNode *) node)->name;
 172 }
 173
 174 struct ast_xml_node *ast_xml_node_get_children(struct ast_xml_node *node)
 175 {
 176         return (struct ast_xml_node *) ((xmlNode *) node)->children;
 177 }
 178
 179 struct ast_xml_node *ast_xml_node_get_next(struct ast_xml_node *node)
 180 {
 181         return (struct ast_xml_node *) ((xmlNode *) node)->next;
 182 }
 183
 184 struct ast_xml_node *ast_xml_node_get_prev(struct ast_xml_node *node)
 185 {
 186         return (struct ast_xml_node *) ((xmlNode *) node)->prev;
 187 }
 188
 189 struct ast_xml_node *ast_xml_node_get_parent(struct ast_xml_node *node)
 190 {
 191         return (struct ast_xml_node *) ((xmlNode *) node)->parent;
 192 }
 193
 194 #endif /* defined(HAVE_LIBXML2) */
 195