source: NonGTP/Xerces/xercesc/dom/deprecated/ParentNode.hpp @ 188

Revision 188, 6.3 KB checked in by mattausch, 19 years ago (diff)

added xercesc to support

Line 
1#ifndef ParentNode_HEADER_GUARD_
2#define ParentNode_HEADER_GUARD_
3/*
4 * The Apache Software License, Version 1.1
5 *
6 * Copyright (c) 1999-2002 The Apache Software Foundation.  All rights
7 * reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 *
13 * 1. Redistributions of source code must retain the above copyright
14 *    notice, this list of conditions and the following disclaimer.
15 *
16 * 2. Redistributions in binary form must reproduce the above copyright
17 *    notice, this list of conditions and the following disclaimer in
18 *    the documentation and/or other materials provided with the
19 *    distribution.
20 *
21 * 3. The end-user documentation included with the redistribution,
22 *    if any, must include the following acknowledgment:
23 *       "This product includes software developed by the
24 *        Apache Software Foundation (http://www.apache.org/)."
25 *    Alternately, this acknowledgment may appear in the software itself,
26 *    if and wherever such third-party acknowledgments normally appear.
27 *
28 * 4. The names "Xerces" and "Apache Software Foundation" must
29 *    not be used to endorse or promote products derived from this
30 *    software without prior written permission. For written
31 *    permission, please contact apache\@apache.org.
32 *
33 * 5. Products derived from this software may not be called "Apache",
34 *    nor may "Apache" appear in their name, without prior written
35 *    permission of the Apache Software Foundation.
36 *
37 * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
38 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
39 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
40 * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
41 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
42 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
43 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
44 * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
45 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
46 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
47 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
48 * SUCH DAMAGE.
49 * ====================================================================
50 *
51 * This software consists of voluntary contributions made by many
52 * individuals on behalf of the Apache Software Foundation, and was
53 * originally based on software copyright (c) 1999, International
54 * Business Machines, Inc., http://www.ibm.com .  For more information
55 * on the Apache Software Foundation, please see
56 * <http://www.apache.org/>.
57 */
58
59//
60//  This file is part of the internal implementation of the C++ XML DOM.
61//  It should NOT be included or used directly by application programs.
62//
63//  Applications should include the file <xercesc/dom/deprecated/DOM.hpp> for the entire
64//  DOM API, or DOM_*.hpp for individual DOM classes, where the class
65//  name is substituded for the *.
66//
67
68/*
69 * $Id: ParentNode.hpp,v 1.3 2002/11/04 15:04:44 tng Exp $
70 */
71
72/**
73 * ParentNode inherits from ChildImpl and adds the capability of having child
74 * nodes. Not every node in the DOM can have children, so only nodes that can
75 * should inherit from this class and pay the price for it.
76 * <P>
77 * ParentNode, just like NodeImpl, also implements NodeList, so it can
78 * return itself in response to the getChildNodes() query. This eliminiates
79 * the need for a separate ChildNodeList object. Note that this is an
80 * IMPLEMENTATION DETAIL; applications should _never_ assume that
81 * this identity exists.
82 * <P>
83 * While we have a direct reference to the first child, the last child is
84 * stored as the previous sibling of the first child. First child nodes are
85 * marked as being so, and getNextSibling hides this fact.
86 * <P>Note: Not all parent nodes actually need to also be a child. At some
87 * point we used to have ParentNode inheriting from NodeImpl and another class
88 * called ChildAndParentNode that inherited from ChildNode. But due to the lack
89 * of multiple inheritance a lot of code had to be duplicated which led to a
90 * maintenance nightmare. At the same time only a few nodes (Document,
91 * DocumentFragment, Entity, and Attribute) cannot be a child so the gain is
92 * memory wasn't really worth it. The only type for which this would be the
93 * case is Attribute, but we deal with there in another special way, so this is
94 * not applicable.
95 *
96 * <p><b>WARNING</b>: Some of the code here is partially duplicated in
97 * AttrImpl, be careful to keep these two classes in sync!
98 *
99 **/
100
101#include <xercesc/util/XercesDefs.hpp>
102#include "ChildNode.hpp"
103
104XERCES_CPP_NAMESPACE_BEGIN
105
106class CDOM_EXPORT ParentNode: public ChildNode {
107public:
108    DocumentImpl            *ownerDocument; // Document this node belongs to
109
110    ChildNode                *firstChild;
111
112public:
113    ParentNode(DocumentImpl *ownerDocument);
114    ParentNode(const ParentNode &other);
115
116    virtual DocumentImpl * getOwnerDocument();
117    virtual void setOwnerDocument(DocumentImpl *doc);
118
119    virtual NodeListImpl *getChildNodes();
120    virtual NodeImpl * getFirstChild();
121    virtual NodeImpl * getLastChild();
122    virtual unsigned int getLength();
123    virtual bool        hasChildNodes();
124    virtual NodeImpl    *insertBefore(NodeImpl *newChild, NodeImpl *refChild);
125    virtual NodeImpl    *item(unsigned int index);
126    virtual NodeImpl    * removeChild(NodeImpl *oldChild);
127    virtual NodeImpl    *replaceChild(NodeImpl *newChild, NodeImpl *oldChild);
128    virtual void        setReadOnly(bool isReadOnly, bool deep);
129
130    //Introduced in DOM Level 2
131    virtual void        normalize();
132
133    // NON-DOM
134    // unlike getOwnerDocument this never returns null, even for Document nodes
135    virtual DocumentImpl * getDocument();
136protected:
137    void cloneChildren(const NodeImpl &other);
138    ChildNode * lastChild();
139    void lastChild(ChildNode *);
140
141    /** Cached node list length. */
142    int fCachedLength;
143
144    /** Last requested child. */
145    ChildNode * fCachedChild;
146
147    /** Last requested child index. */
148    int fCachedChildIndex;
149};
150
151XERCES_CPP_NAMESPACE_END
152
153#endif
Note: See TracBrowser for help on using the repository browser.