DOMNodeIteratorImpl.cpp
上传用户:zhuqijet
上传日期:2013-06-25
资源大小:10074k
文件大小:12k
源码类别:

词法分析

开发平台:

Visual C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  *
  4.  * Copyright (c) 2001-2002 The Apache Software Foundation.  All rights
  5.  * reserved.
  6.  *
  7.  * Redistribution and use in source and binary forms, with or without
  8.  * modification, are permitted provided that the following conditions
  9.  * are met:
  10.  *
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer.
  13.  *
  14.  * 2. Redistributions in binary form must reproduce the above copyright
  15.  *    notice, this list of conditions and the following disclaimer in
  16.  *    the documentation and/or other materials provided with the
  17.  *    distribution.
  18.  *
  19.  * 3. The end-user documentation included with the redistribution,
  20.  *    if any, must include the following acknowledgment:
  21.  *       "This product includes software developed by the
  22.  *        Apache Software Foundation (http://www.apache.org/)."
  23.  *    Alternately, this acknowledgment may appear in the software itself,
  24.  *    if and wherever such third-party acknowledgments normally appear.
  25.  *
  26.  * 4. The names "Xerces" and "Apache Software Foundation" must
  27.  *    not be used to endorse or promote products derived from this
  28.  *    software without prior written permission. For written
  29.  *    permission, please contact apache@apache.org.
  30.  *
  31.  * 5. Products derived from this software may not be called "Apache",
  32.  *    nor may "Apache" appear in their name, without prior written
  33.  *    permission of the Apache Software Foundation.
  34.  *
  35.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46.  * SUCH DAMAGE.
  47.  * ====================================================================
  48.  *
  49.  * This software consists of voluntary contributions made by many
  50.  * individuals on behalf of the Apache Software Foundation, and was
  51.  * originally based on software copyright (c) 2001, International
  52.  * Business Machines, Inc., http://www.ibm.com .  For more information
  53.  * on the Apache Software Foundation, please see
  54.  * <http://www.apache.org/>.
  55.  */
  56. /*
  57.  * $Id: DOMNodeIteratorImpl.cpp,v 1.5 2003/01/16 19:10:41 tng Exp $
  58.  */
  59. //////////////////////////////////////////////////////////////////////
  60. // DOMNodeIteratorImpl.cpp: implementation of the DOMNodeIteratorImpl class.
  61. //
  62. //////////////////////////////////////////////////////////////////////
  63. #include "DOMNodeIteratorImpl.hpp"
  64. #include "DOMDocumentImpl.hpp"
  65. #include <xercesc/dom/DOMDocument.hpp>
  66. #include <xercesc/dom/DOMException.hpp>
  67. XERCES_CPP_NAMESPACE_BEGIN
  68. //////////////////////////////////////////////////////////////////////
  69. // Construction/Destruction
  70. //////////////////////////////////////////////////////////////////////
  71. DOMNodeIteratorImpl::DOMNodeIteratorImpl (DOMDocument* doc,
  72.                                     DOMNode* root,
  73.                                     unsigned long whatToShow,
  74.                                     DOMNodeFilter* nodeFilter,
  75.                                     bool expandEntityRef)
  76. :   fDetached(false),
  77.     fRoot(root),
  78.     fCurrentNode(0),
  79.     fWhatToShow(whatToShow),
  80.     fNodeFilter(nodeFilter),
  81.     fForward(true),
  82.     fExpandEntityReferences(expandEntityRef),
  83.     fDocument(doc)
  84. {
  85. }
  86. DOMNodeIteratorImpl::DOMNodeIteratorImpl ( const DOMNodeIteratorImpl& toCopy)
  87.     :   fDetached(toCopy.fDetached),
  88.     fRoot(toCopy.fRoot),
  89.     fCurrentNode(toCopy.fCurrentNode),
  90.     fWhatToShow(toCopy.fWhatToShow),
  91.     fNodeFilter(toCopy.fNodeFilter),
  92.     fForward(toCopy.fForward),
  93.     fExpandEntityReferences(toCopy.fExpandEntityReferences),
  94.     fDocument(toCopy.fDocument)
  95. {
  96. }
  97. DOMNodeIteratorImpl& DOMNodeIteratorImpl::operator= (const DOMNodeIteratorImpl& other) {
  98.     fRoot                   = other.fRoot;
  99.     fCurrentNode            = other.fRoot;
  100.     fWhatToShow             = other.fWhatToShow;
  101.     fNodeFilter             = other.fNodeFilter;
  102.     fForward                = other.fForward;
  103.     fDetached               = other.fDetached;
  104.     fExpandEntityReferences = other.fExpandEntityReferences;
  105.     fDocument               = other.fDocument;
  106.     return *this;
  107. }
  108. DOMNodeIteratorImpl::~DOMNodeIteratorImpl ()
  109. {
  110. fDetached = false;
  111. }
  112. void DOMNodeIteratorImpl::detach ()
  113. {
  114. fDetached = true;
  115.    ((DOMDocumentImpl *)fDocument)->removeNodeIterator(this);
  116. }
  117. DOMNode* DOMNodeIteratorImpl::getRoot() {
  118.     return fRoot;
  119. }
  120. // Implementation Note: Note that the iterator looks at whatToShow
  121. // and filter values at each call, and therefore one _could_ add
  122. // setters for these values and alter them while iterating!
  123. /** Return the whatToShow value */
  124. unsigned long DOMNodeIteratorImpl::getWhatToShow () {
  125.     return fWhatToShow;
  126. }
  127. /** Return the filter */
  128. DOMNodeFilter* DOMNodeIteratorImpl::getFilter () {
  129.     return fNodeFilter;
  130. }
  131. /** Get the expandEntity reference flag. */
  132. bool DOMNodeIteratorImpl::getExpandEntityReferences()
  133. {
  134.     return fExpandEntityReferences;
  135. }
  136. /** Return the next DOMNode* in the Iterator. The node is the next node in
  137.  *  depth-first order which also passes the filter, and whatToShow.
  138.  *  A 0 return means either that
  139.  */
  140. DOMNode* DOMNodeIteratorImpl::nextNode () {
  141. if (fDetached)
  142. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  143.     // if root is 0 there is no next node->
  144.     if (!fRoot)
  145. return 0;
  146.     DOMNode* aNextNode = fCurrentNode;
  147.     bool accepted = false; // the next node has not been accepted.
  148.     while (!accepted) {
  149.         // if last direction is not forward, repeat node->
  150.         if (!fForward && (aNextNode != 0)) {
  151.             //System.out.println("nextNode():!fForward:"+fCurrentNode.getNodeName());
  152.             aNextNode = fCurrentNode;
  153.         } else {
  154.         // else get the next node via depth-first
  155.             aNextNode = nextNode(aNextNode, true);
  156.         }
  157.         fForward = true; //REVIST: should direction be set forward before 0 check?
  158.         // nothing in the list. return 0.
  159.         if (!aNextNode) return 0;
  160.         // does node pass the filters and whatToShow?
  161.         accepted = acceptNode(aNextNode);
  162.         if (accepted) {
  163.             // if so, then the node is the current node->
  164.             fCurrentNode = aNextNode;
  165.             return fCurrentNode;
  166.         }
  167.     }
  168.     // no nodes, or no accepted nodes.
  169.     return 0;
  170. }
  171. /** Return the previous Node in the Iterator. The node is the next node in
  172.  *  _backwards_ depth-first order which also passes the filter, and whatToShow.
  173.  */
  174. DOMNode* DOMNodeIteratorImpl::previousNode () {
  175. if (fDetached)
  176. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  177.     // if the root is 0, or the current node is 0, return 0.
  178.     if (!fRoot || !fCurrentNode) return 0;
  179.     DOMNode* aPreviousNode = fCurrentNode;
  180.     bool accepted = false;
  181.     while (!accepted) {
  182.         if (fForward && (aPreviousNode != 0)) {
  183.             //repeat last node->
  184.             aPreviousNode = fCurrentNode;
  185.         } else {
  186.             // get previous node in backwards depth first order.
  187.             aPreviousNode = previousNode(aPreviousNode);
  188.         }
  189.         // we are going backwards
  190.         fForward = false;
  191.         // if the new previous node is 0, we're at head or past the root,
  192.         // so return 0.
  193.         if (!aPreviousNode) return 0;
  194.         // check if node passes filters and whatToShow.
  195.         accepted = acceptNode(aPreviousNode);
  196.         if (accepted) {
  197.             // if accepted, update the current node, and return it.
  198.             fCurrentNode = aPreviousNode;
  199.             return fCurrentNode;
  200.         }
  201.     }
  202.     // there are no nodes?
  203.     return 0;
  204. }
  205. /** The node is accepted if it passes the whatToShow and the filter. */
  206. bool DOMNodeIteratorImpl::acceptNode (DOMNode* node) {
  207. if (fDetached)
  208. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  209.     if (fNodeFilter == 0) {
  210.         return ((fWhatToShow & (1 << (node->getNodeType() - 1))) != 0);
  211.     } else {
  212.         return ((fWhatToShow & (1 << (node->getNodeType() - 1))) != 0)
  213.             && fNodeFilter->acceptNode(node) == DOMNodeFilter::FILTER_ACCEPT;
  214.     }
  215. }
  216. /** Return node, if matches or any parent if matches. */
  217. DOMNode* DOMNodeIteratorImpl::matchNodeOrParent (DOMNode* node) {
  218.     for (DOMNode* n = fCurrentNode; n != fRoot; n = n->getParentNode()) {
  219.         if (node == n) return n;
  220.     }
  221.     return 0;
  222. }
  223. /** The method nextNode(DOMNode, bool) returns the next node
  224.  *  from the actual DOM tree.
  225.  *
  226.  *  The bool visitChildren determines whether to visit the children.
  227.  *  The result is the nextNode.
  228.  */
  229. DOMNode* DOMNodeIteratorImpl::nextNode (DOMNode* node, bool visitChildren) {
  230. if (fDetached)
  231. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  232.     if (!node) return fRoot;
  233.     DOMNode* result = 0;
  234.     // only check children if we visit children.
  235.     if (visitChildren) {
  236.         //if hasChildren, return 1st child.
  237.         if (node->hasChildNodes()) {
  238.             result = node->getFirstChild();
  239.             return result;
  240.         }
  241.     }
  242.     // if hasSibling, return sibling
  243.     if (node != fRoot) {
  244.         result = node->getNextSibling();
  245.         if (result != 0) return result;
  246.         // return parent's 1st sibling.
  247.         DOMNode* parent = node->getParentNode();
  248.         while ((parent != 0) && parent != fRoot) {
  249.             result = parent->getNextSibling();
  250.             if (result != 0) {
  251.                 return result;
  252.             } else {
  253.                 parent = parent->getParentNode();
  254.             }
  255.         } // while (parent != 0 && parent != fRoot) {
  256.     }
  257.     // end of list, return 0
  258.     return 0;
  259. }
  260. /** The method previousNode(DOMNode) returns the previous node
  261.  *  from the actual DOM tree.
  262.  */
  263. DOMNode* DOMNodeIteratorImpl::previousNode (DOMNode* node) {
  264. if (fDetached)
  265. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  266.     DOMNode* result = 0;
  267.     // if we're at the root, return 0.
  268.     if (node == fRoot)
  269. return 0;
  270.     // get sibling
  271.     result = node->getPreviousSibling();
  272.     if (!result) {
  273.         //if 1st sibling, return parent
  274.         result = node->getParentNode();
  275.         return result;
  276.     }
  277.     // if sibling has children, keep getting last child of child.
  278.     if (result->hasChildNodes()) {
  279.         while (result->hasChildNodes()) {
  280.             result = result->getLastChild();
  281.         }
  282.     }
  283.     return result;
  284. }
  285. /** Fix-up the iterator on a remove. Called by DOM or otherwise,
  286.  *  before an actual DOM remove.
  287.  */
  288. void DOMNodeIteratorImpl::removeNode (DOMNode* node) {
  289. if (fDetached)
  290. throw DOMException(DOMException::INVALID_STATE_ERR, 0);
  291.     // Implementation note: Fix-up means setting the current node properly
  292.     // after a remove.
  293.     if (!node) return;
  294.     DOMNode* deleted = matchNodeOrParent(node);
  295.     if (!deleted) return;
  296.     if (fForward) {
  297.         fCurrentNode = previousNode(deleted);
  298.     } else
  299.     // if (!fForward)
  300.     {
  301.         DOMNode* next = nextNode(deleted, false);
  302.         if (next != 0) {
  303.             // normal case: there _are_ nodes following this in the iterator.
  304.             fCurrentNode = next;
  305.         } else {
  306.             // the last node in the iterator is to be removed,
  307.             // so we set the current node to be the previous one.
  308.             fCurrentNode = previousNode(deleted);
  309.             fForward = true;
  310.         }
  311.     }
  312. }
  313. void DOMNodeIteratorImpl::release()
  314. {
  315.     detach();
  316.     // for performance reason, do not recycle pointer
  317.     // chance that this is allocated again and again is not usual
  318. }
  319. XERCES_CPP_NAMESPACE_END