WebCore/dom/DocumentParser.h
changeset 0 4f2f89ce4247
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/WebCore/dom/DocumentParser.h	Fri Sep 17 09:02:29 2010 +0300
@@ -0,0 +1,82 @@
+/*
+ * Copyright (C) 2000 Peter Kelly (pmk@post.com)
+ * Copyright (C) 2005, 2006 Apple Computer, Inc.
+ * Copyright (C) 2007 Samuel Weinig (sam@webkit.org)
+ * Copyright (C) 2010 Google, Inc.
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public License
+ * along with this library; see the file COPYING.LIB.  If not, write to
+ * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301, USA.
+ *
+ */
+
+#ifndef DocumentParser_h
+#define DocumentParser_h
+
+#include <wtf/Noncopyable.h>
+
+namespace WebCore {
+
+class Document;
+class DocumentWriter;
+class LegacyHTMLTreeBuilder;
+class SegmentedString;
+class ScriptableDocumentParser;
+
+class DocumentParser : public Noncopyable {
+public:
+    virtual ~DocumentParser() { }
+
+    virtual ScriptableDocumentParser* asScriptableDocumentParser() { return 0; }
+
+    // insert is used by document.write
+    virtual void insert(const SegmentedString&) = 0;
+
+    // appendBytes is used by DocumentWriter (the loader)
+    virtual void appendBytes(DocumentWriter*, const char* bytes, int length, bool flush) = 0;
+
+    // FIXME: append() should be private, but DocumentWriter::replaceDocument
+    // uses it for now.
+    virtual void append(const SegmentedString&) = 0;
+
+    virtual void finish() = 0;
+    virtual bool finishWasCalled() = 0;
+
+    virtual void stopParsing() { m_parserStopped = true; }
+    // FIXME: processingData() is only used by DocumentLoader::isLoadingInAPISense
+    // and is very unclear as to what it actually means.  Only LegacyHTMLDocumentParser
+    // actually implements it.
+    virtual bool processingData() const { return false; }
+
+    // FIXME: Exposed for HTMLFormControlElement::removedFromTree.  HTML DOM
+    // code should not need to reach into implementation details of the parser.
+    virtual LegacyHTMLTreeBuilder* htmlTreeBuilder() const { return 0; }
+
+    Document* document() const { return m_document; }
+
+protected:
+    DocumentParser(Document*);
+
+    // The parser has buffers, so parsing may continue even after
+    // it stops receiving data. We use m_parserStopped to stop the parser
+    // even when it has buffered data.
+    bool m_parserStopped;
+
+    // Every DocumentParser needs a pointer back to the document.
+    Document* m_document;
+};
+
+} // namespace WebCore
+
+#endif // DocumentParser_h