2 * Copyright 2001-2006 Internet2
\r
4 * Licensed under the Apache License, Version 2.0 (the "License");
\r
5 * you may not use this file except in compliance with the License.
\r
6 * You may obtain a copy of the License at
\r
8 * http://www.apache.org/licenses/LICENSE-2.0
\r
10 * Unless required by applicable law or agreed to in writing, software
\r
11 * distributed under the License is distributed on an "AS IS" BASIS,
\r
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
13 * See the License for the specific language governing permissions and
\r
14 * limitations under the License.
\r
18 * @file DOMCachingXMLObject.h
\r
20 * An XMLObject that can cached a DOM representation of itself.
\r
23 #if !defined(__xmltooling_domxmlobj_h__)
\r
24 #define __xmltooling_domxmlobj_h__
\r
26 #include <xercesc/dom/DOM.hpp>
\r
27 #include <xmltooling/XMLObject.h>
\r
29 using namespace xercesc;
\r
31 namespace xmltooling {
\r
34 * An XMLObject that can cached a DOM representation of itself.
\r
36 class XMLTOOL_API DOMCachingXMLObject : public virtual XMLObject
\r
39 DOMCachingXMLObject() {}
\r
40 virtual ~DOMCachingXMLObject() {}
\r
43 * Gets the DOM representation of this XMLObject, if one exists.
\r
45 * @return the DOM representation of this XMLObject
\r
47 virtual const DOMElement* getDOM() const=0;
\r
50 * Sets the DOM representation of this XMLObject.
\r
52 * @param dom DOM representation of this XMLObject
\r
54 virtual void setDOM(DOMElement* dom)=0;
\r
57 * Assigns ownership of a DOM document to the XMLObject.
\r
58 * This binds the lifetime of the document to the lifetime of the object.
\r
60 * @param doc DOM document bound to this object
\r
62 virtual DOMDocument* setDocument(DOMDocument* doc)=0;
\r
65 * Releases the DOM representation of this XMLObject, if there is one.
\r
67 virtual void releaseDOM()=0;
\r
70 * Releases the DOM representation of this XMLObject's parent.
\r
72 * @param propagateRelease true if all ancestors of this element should release their DOM
\r
74 virtual void releaseParentDOM(bool propagateRelease=true)=0;
\r
77 * Releases the DOM representation of this XMLObject's children.
\r
79 * @param propagateRelease true if all descendants of this element should release their DOM
\r
81 virtual void releaseChildrenDOM(bool propagateRelease=true)=0;
\r
86 #endif /* __xmltooling_domxmlobj_h__ */
\r