committed latest 1.3 snapshot

XML/include/Poco/DOM/AbstractContainerNode.h

@@ -1,7 +1,7 @@
 //
 // AbstractContainerNode.h
 //
-// $Id: //poco/Main/XML/include/Poco/DOM/AbstractContainerNode.h#2 $
+// $Id: //poco/Main/XML/include/Poco/DOM/AbstractContainerNode.h#3 $
 //
 // Library: XML
 // Package: DOM
@@ -77,6 +77,7 @@ private:
 	AbstractNode* _pFirstChild;
 
 	friend class AbstractNode;
+	friend class NodeAppender;
 };
 
 

XML/include/Poco/DOM/AbstractNode.h

@@ -1,7 +1,7 @@
 //
 // AbstractNode.h
 //
-// $Id: //poco/Main/XML/include/Poco/DOM/AbstractNode.h#2 $
+// $Id: //poco/Main/XML/include/Poco/DOM/AbstractNode.h#3 $
 //
 // Library: XML
 // Package: DOM
@@ -135,6 +135,7 @@ private:
 	friend class Attr;
 	friend class CharacterData;
 	friend class DOMBuilder;
+	friend class NodeAppender;
 };
 
 

XML/include/Poco/DOM/DOMWriter.h

@@ -1,7 +1,7 @@
 //
 // DOMWriter.h
 //
-// $Id: //poco/Main/XML/include/Poco/DOM/DOMWriter.h#3 $
+// $Id: //poco/Main/XML/include/Poco/DOM/DOMWriter.h#4 $
 //
 // Library: XML
 // Package: DOM
@@ -94,7 +94,7 @@ public:
 
 	void writeNode(const std::string& systemId, const Node* pNode);
 		/// Writes the XML for the given node to the file specified in systemId,
-		/// using a standard file output stream (std::ofstream).
+		/// using a standard file output stream (Poco::FileOutputStream).
 
 private:
 	std::string         _encodingName;

XML/include/Poco/DOM/NodeAppender.h

@@ -0,0 +1,103 @@
+//
+// NodeAppender.h
+//
+// $Id: //poco/Main/XML/include/Poco/DOM/NodeAppender.h#1 $
+//
+// Library: XML
+// Package: DOM
+// Module:  NodeAppender
+//
+// Definition of the NodeAppender class.
+//
+// Copyright (c) 2007, Applied Informatics Software Engineering GmbH.
+// and Contributors.
+//
+// Permission is hereby granted, free of charge, to any person or organization
+// obtaining a copy of the software and accompanying documentation covered by
+// this license (the "Software") to use, reproduce, display, distribute,
+// execute, and transmit the Software, and to prepare derivative works of the
+// Software, and to permit third-parties to whom the Software is furnished to
+// do so, all subject to the following:
+// 
+// The copyright notices in the Software and this entire statement, including
+// the above license grant, this restriction and the following disclaimer,
+// must be included in all copies of the Software, in whole or in part, and
+// all derivative works of the Software, unless such copies or derivative
+// works are solely in the form of machine-executable object code generated by
+// a source language processor.
+// 
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+// SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+// FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+// ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+// DEALINGS IN THE SOFTWARE.
+//
+
+
+#ifndef DOM_NodeAppender_INCLUDED
+#define DOM_NodeAppender_INCLUDED
+
+
+#include "Poco/XML/XML.h"
+#include "Poco/DOM/Node.h"
+
+
+namespace Poco {
+namespace XML {
+
+
+class AbstractNode;
+class Element;
+
+
+class XML_API NodeAppender
+	/// The NodeAppender class provides a very fast way to
+	/// build larger DOM documents.
+	///
+	/// In the DOM, child nodes are usually appended to a parent
+	/// node using the appendChild() method. For nodes containing
+	/// more than a few children, this method can be quite slow,
+	/// due to the way it's implemented, and because of the 
+	/// requirements of the DOM specification.
+	///
+	/// While the NodeAppender is being used on an Element, no
+	/// children-modifying methods of that Element must be used.
+	///
+	/// This class is not part of the DOM specification.
+{
+public:
+	NodeAppender(Element* parent);
+		/// Creates the NodeAppender for the given parent node,
+		/// which must be an Element.
+
+	~NodeAppender();
+		/// Destroys the NodeAppender.
+
+	void appendChild(Node* newChild);
+		/// Appends the node newChild to the end of the list of children of
+		/// the parent node specified in the constructor.
+		/// If the newChild is already in the tree, it is first removed.
+		///
+		/// NewChild can be a DocumentFragment. In this case, all children
+		/// of the fragment become children of the parent element.
+		///
+		/// In order to speed up the function, no DOM events
+		/// are fired.
+
+private:
+	NodeAppender();
+	NodeAppender(const NodeAppender&);
+	NodeAppender& operator = (const NodeAppender&);
+	
+	Element*      _pParent;
+	AbstractNode* _pLast;
+};
+
+
+} } // namespace Poco::XML
+
+
+#endif // #include "Poco/XML/XML.h"
+

XML/include/Poco/SAX/EntityResolverImpl.h

@@ -1,7 +1,7 @@
 //
 // EntityResolverImpl.h
 //
-// $Id: //poco/Main/XML/include/Poco/SAX/EntityResolverImpl.h#2 $
+// $Id: //poco/Main/XML/include/Poco/SAX/EntityResolverImpl.h#3 $
 //
 // Library: XML
 // Package: SAX
@@ -58,7 +58,7 @@ class XML_API EntityResolverImpl: public EntityResolver
 	/// for an InputSource.
 	///
 	/// If the system ID is not a valid URI, it is
-	/// interpreted as a filesystem path and a ifstream
+	/// interpreted as a filesystem path and a Poco::FileInputStream
 	/// is opened for it.
 {
 public:
@@ -78,7 +78,7 @@ public:
 		/// for the given systemId, which is interpreted as an URI.
 		///
 		/// If the systemId is not a valid URI, it is interpreted as
-		/// a local filesystem path and an ifstream is opened for it.
+		/// a local filesystem path and a Poco::FileInputStream is opened for it.
 		
 	void releaseInputSource(InputSource* pSource);
 		/// Deletes the InputSource's stream.