Default support for arbitrary DOM objects.
[shibboleth/cpp-xmltooling.git] / xmltooling / impl / UnknownElement.cpp
1 /*\r
2 *  Copyright 2001-2006 Internet2\r
3  * \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
7  *\r
8  *     http://www.apache.org/licenses/LICENSE-2.0\r
9  *\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
15  */\r
16 \r
17 /**\r
18  * UnknownElement.cpp\r
19  * \r
20  * Basic implementations suitable for use as defaults for unrecognized content\r
21  */\r
22 \r
23 #include "internal.h"\r
24 #include "exceptions.h"\r
25 #include "impl/UnknownElement.h"\r
26 #include "util/NDC.h"\r
27 \r
28 #include <log4cpp/Category.hh>\r
29 #include <xercesc/framework/MemBufFormatTarget.hpp>\r
30 #include <xercesc/framework/MemBufInputSource.hpp>\r
31 #include <xercesc/framework/Wrapper4InputSource.hpp>\r
32 #include <xercesc/util/XMLUniDefs.hpp>\r
33 \r
34 using namespace xmltooling;\r
35 using namespace log4cpp;\r
36 using namespace std;\r
37 \r
38 void UnknownElementImpl::releaseDOM()\r
39 {\r
40 #ifdef _DEBUG\r
41     xmltooling::NDC ndc("releaseDOM");\r
42 #endif\r
43     Category& log=Category::getInstance(XMLTOOLING_LOGCAT".UnknownElementImpl");\r
44     log.debug("releasing DOM for unknown content, preserving current DOM in XML form");\r
45 \r
46     // We're losing our DOM, so assuming we have one, we preserve it.\r
47     serialize(m_xml);\r
48 \r
49     // This takes care of the generic housekeeping now that we've preserved things.\r
50     AbstractDOMCachingXMLObject::releaseDOM();\r
51 }\r
52 \r
53 XMLObject* UnknownElementImpl::clone() const\r
54 {\r
55     UnknownElementImpl* ret=new UnknownElementImpl();\r
56 \r
57     // If there's no XML locally, serialize this object into the new one.\r
58     // Otherwise just copy it over.\r
59     if (m_xml.empty())\r
60         serialize(ret->m_xml);\r
61     else\r
62         ret->m_xml=m_xml;\r
63 \r
64     return ret;\r
65 }\r
66 \r
67 void UnknownElementImpl::serialize(string& s) const\r
68 {\r
69     if (getDOM()) {\r
70         static const XMLCh impltype[] = { chLatin_L, chLatin_S, chNull };\r
71         static const XMLCh UTF8[]={ chLatin_U, chLatin_T, chLatin_F, chDigit_8, chNull };\r
72         DOMImplementation* impl=DOMImplementationRegistry::getDOMImplementation(impltype);\r
73         DOMWriter* serializer=(static_cast<DOMImplementationLS*>(impl))->createDOMWriter();\r
74         serializer->setEncoding(UTF8);\r
75         try {\r
76             MemBufFormatTarget target;\r
77             if (!serializer->writeNode(&target,*(getDOM())))\r
78                 throw XMLObjectException("unable to serialize XML to preserve DOM");\r
79             s.erase();\r
80             s.append(reinterpret_cast<const char*>(target.getRawBuffer()),target.getLen());\r
81             serializer->release();\r
82         }\r
83         catch (...) {\r
84             serializer->release();\r
85             throw;\r
86         }\r
87     }\r
88 }\r
89 \r
90 DOMElement* UnknownElementMarshaller::marshall(XMLObject* xmlObject, DOMDocument* document) const\r
91 {\r
92 #ifdef _DEBUG\r
93     xmltooling::NDC ndc("marshall");\r
94 #endif\r
95     \r
96     Category& log=Category::getInstance(XMLTOOLING_LOGCAT".Marshaller");\r
97     log.debug("marshalling unknown content");\r
98 \r
99     UnknownElementImpl* unk=dynamic_cast<UnknownElementImpl*>(xmlObject);\r
100     if (!unk)\r
101         throw MarshallingException("Only objects of class UnknownElementImpl can be marshalled.");\r
102     \r
103     DOMElement* cachedDOM=unk->getDOM();\r
104     if (cachedDOM) {\r
105         if (!document || document==cachedDOM->getOwnerDocument()) {\r
106             log.debug("XMLObject has a usable cached DOM, using it");\r
107             return cachedDOM;\r
108         }\r
109         \r
110         // We have a DOM but it doesn't match the document we were given. This both sucks and blows.\r
111         // Without an adoptNode option to maintain the child pointers, we rely on our custom\r
112         // implementation class to preserve the XML when we release the existing DOM.\r
113         unk->releaseDOM();\r
114     }\r
115     \r
116     // If we get here, we didn't have a usable DOM (and/or we flushed the one we had).\r
117     // We need to reparse the XML we saved off into a new DOM.\r
118     bool bindDocument=false;\r
119     MemBufInputSource src(reinterpret_cast<const XMLByte*>(unk->m_xml.c_str()),unk->m_xml.length(),"UnknownElementImpl");\r
120     Wrapper4InputSource dsrc(&src,false);\r
121     log.debug("parsing XML back into DOM tree");\r
122     DOMDocument* internalDoc=XMLToolingInternalConfig::getInternalConfig().m_parserPool->parse(dsrc);\r
123     if (document) {\r
124         // The caller insists on using his own document, so we now have to import the damn thing\r
125         // into it. Then we're just dumping the one we built.\r
126         log.debug("reimporting new DOM into caller-supplied document");\r
127         cachedDOM=static_cast<DOMElement*>(document->importNode(internalDoc->getDocumentElement(), true));\r
128         internalDoc->release();\r
129     }\r
130     else {\r
131         // We just bind the document we built to the object as the result.\r
132         document=internalDoc;\r
133         bindDocument=true;\r
134     }\r
135 \r
136     // Recache the DOM and clear the serialized copy.\r
137     log.debug("caching DOM for XMLObject");\r
138     unk->setDOM(cachedDOM, bindDocument);\r
139     unk->m_xml.erase();\r
140     return cachedDOM;\r
141 }\r
142 \r
143 XMLObject* UnknownElementUnmarshaller::unmarshall(DOMElement* element, bool bindDocument) const\r
144 {\r
145     UnknownElementImpl* ret=new UnknownElementImpl();\r
146     ret->setDOM(element, bindDocument);\r
147     return ret;\r
148 }\r