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 DOMElement* getDOM() const=0;
\r
50 * Sets the DOM representation of this XMLObject.
\r
52 * @param dom DOM representation of this XMLObject
\r
53 * @param bindDocument true if the object should take ownership of the associated Document
\r
55 virtual void setDOM(DOMElement* dom, bool bindDocument=false) const=0;
\r
58 * Assigns ownership of a DOM document to the XMLObject.
\r
59 * This binds the lifetime of the document to the lifetime of the object.
\r
61 * @param doc DOM document bound to this object
\r
63 virtual void setDocument(DOMDocument* doc) const=0;
\r
66 * Releases the DOM representation of this XMLObject, if there is one.
\r
68 virtual void releaseDOM() const=0;
\r
71 * Releases the DOM representation of this XMLObject's parent.
\r
73 * @param propagateRelease true if all ancestors of this element should release their DOM
\r
75 virtual void releaseParentDOM(bool propagateRelease=true) const=0;
\r
78 * Releases the DOM representation of this XMLObject's children.
\r
80 * @param propagateRelease true if all descendants of this element should release their DOM
\r
82 virtual void releaseChildrenDOM(bool propagateRelease=true) const=0;
\r
87 #endif /* __xmltooling_domxmlobj_h__ */
\r