VXmlParser.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:5k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #ifndef VXmlParser_hxx
  2. #define VXmlParser_hxx
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const VXmlParser_hxx_Version =
  53.     "$Id: VXmlParser.hxx,v 1.6 2001/01/24 22:23:41 bko Exp $";
  54. #include <list>
  55. #include <string>
  56. #include "VFile.hxx"
  57. #include "VFileBrowser.hxx"
  58. #include "parser.h"
  59. #include "VBadDataException.hxx"
  60. class VXmlParser
  61. {
  62.     public:
  63.         ///Constructor
  64.         VXmlParser(const VFile& fileName) throw (VBadDataException&);
  65.         ///Constructor
  66.         VXmlParser(const string& data) throw (VBadDataException&);
  67.         ///Destructor
  68.         ~VXmlParser();
  69.         /** Get an attribute for a particular node **/
  70.         string getAttribute(xmlNodePtr node, const string& attr)
  71.         throw (VBadDataException&);
  72.         /**Get a tag content relative to the node, throws exception
  73.          * if tag is not found
  74.          */
  75.         string getContent(xmlNodePtr root, const string& tag)
  76.         throw (VBadDataException&);
  77.         /**Get a subtag content within a tag, throws exception
  78.          * if tag or subtag is not found
  79.          */
  80.         string getContent(const string& tag, const string& subtag)
  81.         throw (VBadDataException&);
  82.         /**Get a tag contents within tree , if tag maches elements in the
  83.            tree, returns the list if contents
  84.            e.g.  <x>
  85.                    <y>
  86.                      <z></z>
  87.                    </y>
  88.                    <y>
  89.                      <z></z>
  90.                    </y>
  91.                   </x>
  92.          */
  93.         void getContent(const string& tag, const string& subTag,
  94.                         list < string > & retList) throw (VBadDataException&);
  95.         /**Get a tag content within a node, if tag maches multiple
  96.            elements in the DOM tree, return a list
  97.            e.g.  <x>
  98.                     <y></y>
  99.                     <y></y>
  100.                  </x>
  101.          */
  102.         void getContent(xmlNodePtr root, const string& tag,
  103.                         const string& subTag, list < string > & retList) throw (VBadDataException&);
  104.         ///Dump the parsed XML tree into a file
  105.         void dump(FILE* file);
  106.         ///Dump the parsed XML tree to stdout
  107.         void dump();
  108.         ///Finds the very first node from the XML tree that matches the name.
  109.         xmlNodePtr findNode(xmlNodePtr root, const string& name) throw (VBadDataException&);
  110.         /**Finds the list of nodes that matches the tag in the tree
  111.            if root=NULL, the top of the tree is taken as root
  112.          */
  113.         void findNode(xmlNodePtr root, const string& name,
  114.                       list < xmlNodePtr > & retList) throw (VBadDataException&);
  115.     private:
  116.         ///Prase the XML contents and create element tree in memory
  117.         void parseContents(const string& contents) throw (VBadDataException&);
  118.         xmlDocPtr _doc;
  119. };
  120. #endif