00001 /* 00002 * The Apache Software License, Version 1.1 00003 * 00004 * Copyright (c) 1999-2002 The Apache Software Foundation. All rights 00005 * reserved. 00006 * 00007 * Redistribution and use in source and binary forms, with or without 00008 * modification, are permitted provided that the following conditions 00009 * are met: 00010 * 00011 * 1. Redistributions of source code must retain the above copyright 00012 * notice, this list of conditions and the following disclaimer. 00013 * 00014 * 2. Redistributions in binary form must reproduce the above copyright 00015 * notice, this list of conditions and the following disclaimer in 00016 * the documentation and/or other materials provided with the 00017 * distribution. 00018 * 00019 * 3. The end-user documentation included with the redistribution, 00020 * if any, must include the following acknowledgment: 00021 * "This product includes software developed by the 00022 * Apache Software Foundation (http://www.apache.org/)." 00023 * Alternately, this acknowledgment may appear in the software itself, 00024 * if and wherever such third-party acknowledgments normally appear. 00025 * 00026 * 4. The names "Xerces" and "Apache Software Foundation" must 00027 * not be used to endorse or promote products derived from this 00028 * software without prior written permission. For written 00029 * permission, please contact apache\@apache.org. 00030 * 00031 * 5. Products derived from this software may not be called "Apache", 00032 * nor may "Apache" appear in their name, without prior written 00033 * permission of the Apache Software Foundation. 00034 * 00035 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED 00036 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 00037 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 00038 * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR 00039 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 00040 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 00041 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF 00042 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 00043 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 00044 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT 00045 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 00046 * SUCH DAMAGE. 00047 * ==================================================================== 00048 * 00049 * This software consists of voluntary contributions made by many 00050 * individuals on behalf of the Apache Software Foundation, and was 00051 * originally based on software copyright (c) 1999, International 00052 * Business Machines, Inc., http://www.ibm.com . For more information 00053 * on the Apache Software Foundation, please see 00054 * <http://www.apache.org/>. 00055 */ 00056 00057 /* 00058 * $Log: TreeWalkerImpl.hpp,v $ 00059 * Revision 1.1 2002/05/11 19:58:40 bhavani 00060 * CR#CR062582# adding xercesc 1.7 file 00061 * 00062 * Revision 1.2 2002/02/04 20:03:48 tng 00063 * Add DOM Level missing functions: 00064 * 1. NodeIterator::getRoot 00065 * 2. TreeWalker::getRoot 00066 * 3. Element::hasAttribute 00067 * 4. Element::hasAttributeNS 00068 * 5. Node::hasAttributes 00069 * 6. Node::isSupported 00070 * 00071 * Revision 1.1.1.1 2002/02/01 22:21:49 peiyongz 00072 * sane_include 00073 * 00074 * Revision 1.6 2000/08/08 01:00:37 aruna1 00075 * detach functionality removed from TreeWalker 00076 * 00077 * Revision 1.5 2000/02/24 20:11:31 abagchi 00078 * Swat for removing Log from API docs 00079 * 00080 * Revision 1.4 2000/02/15 23:17:37 andyh 00081 * Update Doc++ API comments 00082 * NameSpace bugfix and update to track W3C 00083 * Chih Hsiang Chou 00084 * 00085 * Revision 1.3 2000/02/06 07:47:34 rahulj 00086 * Year 2K copyright swat. 00087 * 00088 * Revision 1.2 2000/02/04 01:49:24 aruna1 00089 * TreeWalker and NodeIterator changes 00090 * 00091 * Revision 1.1.1.1 1999/11/09 01:09:20 twl 00092 * Initial checkin 00093 * 00094 * Revision 1.3 1999/11/08 20:44:34 rahul 00095 * Swat for adding in Product name and CVS comment log variable. 00096 * 00097 */ 00098 00099 #ifndef TreeWalkerImpl_HEADER_GUARD_ 00100 #define TreeWalkerImpl_HEADER_GUARD_ 00101 00102 00103 #include "DOM_TreeWalker.hpp" 00104 #include "RefCountedImpl.hpp" 00105 00106 00107 class CDOM_EXPORT TreeWalkerImpl : public RefCountedImpl { 00108 00109 public: 00110 // Implementation Note: No state is kept except the data above 00111 // (fWhatToShow, fNodeFilter, fCurrentNode, fRoot) such that 00112 // setters could be created for these data values and the 00113 // implementation will still work. 00114 00116 TreeWalkerImpl ( 00117 DOM_Node root, 00118 unsigned long whatToShow, 00119 DOM_NodeFilter* nodeFilter, 00120 bool expandEntityRef); 00121 TreeWalkerImpl (const TreeWalkerImpl& twi); 00122 TreeWalkerImpl& operator= (const TreeWalkerImpl& twi); 00123 00124 // Return the root DOM_Node. 00125 DOM_Node getRoot (); 00126 00127 // Return the whatToShow value. 00128 unsigned long getWhatToShow (); 00129 00130 // Return the NodeFilter. 00131 DOM_NodeFilter* getFilter (); 00132 00133 00134 // Return the current DOM_Node. 00135 DOM_Node getCurrentNode (); 00136 00137 // Return the current Node. 00138 void setCurrentNode (DOM_Node node); 00139 00140 // Return the parent Node from the current node, 00141 // after applying filter, whatToshow. 00142 // If result is not null, set the current Node. 00143 DOM_Node parentNode (); 00144 00145 // Return the first child Node from the current node, 00146 // after applying filter, whatToshow. 00147 // If result is not null, set the current Node. 00148 DOM_Node firstChild (); 00149 00150 // Return the last child Node from the current node, 00151 // after applying filter, whatToshow. 00152 // If result is not null, set the current Node. 00153 DOM_Node lastChild (); 00154 00155 // Return the previous sibling Node from the current node, 00156 // after applying filter, whatToshow. 00157 // If result is not null, set the current Node. 00158 DOM_Node previousSibling (); 00159 00160 // Return the next sibling Node from the current node, 00161 // after applying filter, whatToshow. 00162 // If result is not null, set the current Node. 00163 00164 DOM_Node nextSibling (); 00165 // Return the previous Node from the current node, 00166 // after applying filter, whatToshow. 00167 // If result is not null, set the current Node. 00168 DOM_Node previousNode (); 00169 00170 // Return the next Node from the current node, 00171 // after applying filter, whatToshow. 00172 // If result is not null, set the current Node. 00173 DOM_Node nextNode (); 00174 00175 void unreferenced (); 00176 00177 // Get the expandEntity reference flag. 00178 bool getExpandEntityReferences(); 00179 00180 protected: 00181 00182 // Internal function. 00183 // Return the parent Node, from the input node 00184 // after applying filter, whatToshow. 00185 // The current node is not consulted or set. 00186 DOM_Node getParentNode (DOM_Node node); 00187 00188 // Internal function. 00189 // Return the nextSibling Node, from the input node 00190 // after applying filter, whatToshow. 00191 // The current node is not consulted or set. 00192 DOM_Node getNextSibling (DOM_Node node); 00193 00194 // Internal function. 00195 // Return the previous sibling Node, from the input node 00196 // after applying filter, whatToshow. 00197 // The current node is not consulted or set. 00198 DOM_Node getPreviousSibling (DOM_Node node); 00199 00200 // Internal function. 00201 // Return the first child Node, from the input node 00202 // after applying filter, whatToshow. 00203 // The current node is not consulted or set. 00204 DOM_Node getFirstChild (DOM_Node node); 00205 00206 // Internal function. 00207 // Return the last child Node, from the input node 00208 // after applying filter, whatToshow. 00209 // The current node is not consulted or set. 00210 DOM_Node getLastChild (DOM_Node node); 00211 00212 // The node is accepted if it passes the whatToShow and the filter. 00213 short acceptNode (DOM_Node node); 00214 00215 00216 private: 00217 // The whatToShow mask. 00218 unsigned long fWhatToShow; 00219 00220 // The NodeFilter reference. 00221 DOM_NodeFilter* fNodeFilter; 00222 00223 // The current Node. 00224 DOM_Node fCurrentNode; 00225 00226 // The root Node. 00227 DOM_Node fRoot; 00228 00229 // The expandEntity reference flag. 00230 bool fExpandEntityReferences; 00231 }; 00232 00233 #endif