1 | #ifndef ParentNode_HEADER_GUARD_ |
---|
2 | #define ParentNode_HEADER_GUARD_ |
---|
3 | /* |
---|
4 | * Licensed to the Apache Software Foundation (ASF) under one or more |
---|
5 | * contributor license agreements. See the NOTICE file distributed with |
---|
6 | * this work for additional information regarding copyright ownership. |
---|
7 | * The ASF licenses this file to You under the Apache License, Version 2.0 |
---|
8 | * (the "License"); you may not use this file except in compliance with |
---|
9 | * the License. You may obtain a copy of the License at |
---|
10 | * |
---|
11 | * http://www.apache.org/licenses/LICENSE-2.0 |
---|
12 | * |
---|
13 | * Unless required by applicable law or agreed to in writing, software |
---|
14 | * distributed under the License is distributed on an "AS IS" BASIS, |
---|
15 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
---|
16 | * See the License for the specific language governing permissions and |
---|
17 | * limitations under the License. |
---|
18 | */ |
---|
19 | |
---|
20 | // |
---|
21 | // This file is part of the internal implementation of the C++ XML DOM. |
---|
22 | // It should NOT be included or used directly by application programs. |
---|
23 | // |
---|
24 | // Applications should include the file <xercesc/dom/deprecated/DOM.hpp> for the entire |
---|
25 | // DOM API, or DOM_*.hpp for individual DOM classes, where the class |
---|
26 | // name is substituded for the *. |
---|
27 | // |
---|
28 | |
---|
29 | /* |
---|
30 | * $Id: ParentNode.hpp 568078 2007-08-21 11:43:25Z amassari $ |
---|
31 | */ |
---|
32 | |
---|
33 | /** |
---|
34 | * ParentNode inherits from ChildImpl and adds the capability of having child |
---|
35 | * nodes. Not every node in the DOM can have children, so only nodes that can |
---|
36 | * should inherit from this class and pay the price for it. |
---|
37 | * <P> |
---|
38 | * ParentNode, just like NodeImpl, also implements NodeList, so it can |
---|
39 | * return itself in response to the getChildNodes() query. This eliminiates |
---|
40 | * the need for a separate ChildNodeList object. Note that this is an |
---|
41 | * IMPLEMENTATION DETAIL; applications should _never_ assume that |
---|
42 | * this identity exists. |
---|
43 | * <P> |
---|
44 | * While we have a direct reference to the first child, the last child is |
---|
45 | * stored as the previous sibling of the first child. First child nodes are |
---|
46 | * marked as being so, and getNextSibling hides this fact. |
---|
47 | * <P>Note: Not all parent nodes actually need to also be a child. At some |
---|
48 | * point we used to have ParentNode inheriting from NodeImpl and another class |
---|
49 | * called ChildAndParentNode that inherited from ChildNode. But due to the lack |
---|
50 | * of multiple inheritance a lot of code had to be duplicated which led to a |
---|
51 | * maintenance nightmare. At the same time only a few nodes (Document, |
---|
52 | * DocumentFragment, Entity, and Attribute) cannot be a child so the gain is |
---|
53 | * memory wasn't really worth it. The only type for which this would be the |
---|
54 | * case is Attribute, but we deal with there in another special way, so this is |
---|
55 | * not applicable. |
---|
56 | * |
---|
57 | * <p><b>WARNING</b>: Some of the code here is partially duplicated in |
---|
58 | * AttrImpl, be careful to keep these two classes in sync! |
---|
59 | * |
---|
60 | **/ |
---|
61 | |
---|
62 | #include <xercesc/util/XercesDefs.hpp> |
---|
63 | #include "ChildNode.hpp" |
---|
64 | |
---|
65 | XERCES_CPP_NAMESPACE_BEGIN |
---|
66 | |
---|
67 | class DEPRECATED_DOM_EXPORT ParentNode: public ChildNode { |
---|
68 | public: |
---|
69 | DocumentImpl *ownerDocument; // Document this node belongs to |
---|
70 | |
---|
71 | ChildNode *firstChild; |
---|
72 | |
---|
73 | public: |
---|
74 | ParentNode(DocumentImpl *ownerDocument); |
---|
75 | ParentNode(const ParentNode &other); |
---|
76 | |
---|
77 | virtual DocumentImpl * getOwnerDocument(); |
---|
78 | virtual void setOwnerDocument(DocumentImpl *doc); |
---|
79 | |
---|
80 | virtual NodeListImpl *getChildNodes(); |
---|
81 | virtual NodeImpl * getFirstChild(); |
---|
82 | virtual NodeImpl * getLastChild(); |
---|
83 | virtual unsigned int getLength(); |
---|
84 | virtual bool hasChildNodes(); |
---|
85 | virtual NodeImpl *insertBefore(NodeImpl *newChild, NodeImpl *refChild); |
---|
86 | virtual NodeImpl *item(unsigned int index); |
---|
87 | virtual NodeImpl * removeChild(NodeImpl *oldChild); |
---|
88 | virtual NodeImpl *replaceChild(NodeImpl *newChild, NodeImpl *oldChild); |
---|
89 | virtual void setReadOnly(bool isReadOnly, bool deep); |
---|
90 | |
---|
91 | //Introduced in DOM Level 2 |
---|
92 | virtual void normalize(); |
---|
93 | |
---|
94 | // NON-DOM |
---|
95 | // unlike getOwnerDocument this never returns null, even for Document nodes |
---|
96 | virtual DocumentImpl * getDocument(); |
---|
97 | protected: |
---|
98 | void cloneChildren(const NodeImpl &other); |
---|
99 | ChildNode * lastChild(); |
---|
100 | void lastChild(ChildNode *); |
---|
101 | |
---|
102 | /** Cached node list length. */ |
---|
103 | int fCachedLength; |
---|
104 | |
---|
105 | /** Last requested child. */ |
---|
106 | ChildNode * fCachedChild; |
---|
107 | |
---|
108 | /** Last requested child index. */ |
---|
109 | int fCachedChildIndex; |
---|
110 | }; |
---|
111 | |
---|
112 | XERCES_CPP_NAMESPACE_END |
---|
113 | |
---|
114 | #endif |
---|