WebCore/platform/KURLGooglePrivate.h
changeset 0 4f2f89ce4247
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/WebCore/platform/KURLGooglePrivate.h	Fri Sep 17 09:02:29 2010 +0300
@@ -0,0 +1,115 @@
+/*
+ * Copyright (c) 2008, 2009, Google Inc. All rights reserved.
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are
+ * met:
+ * 
+ *     * Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ *     * Redistributions in binary form must reproduce the above
+ * copyright notice, this list of conditions and the following disclaimer
+ * in the documentation and/or other materials provided with the
+ * distribution.
+ *     * Neither the name of Google Inc. nor the names of its
+ * contributors may be used to endorse or promote products derived from
+ * this software without specific prior written permission.
+ * 
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#ifndef KURLGooglePrivate_h
+#define KURLGooglePrivate_h
+
+#include <wtf/text/CString.h>
+
+#include <googleurl/src/url_parse.h>
+#include <googleurl/src/url_canon.h>
+
+namespace WebCore {
+
+    class KURL;
+    class TextEncoding;
+
+    // Wraps the internals related to using Google-URL as the bnackend for KURL.
+    // This maintains the state and has auxiliary functions so that we don't need
+    // to uglify KURL.h while allowing Google-URL to be evaluated.
+    class KURLGooglePrivate {
+    public:
+        KURLGooglePrivate();
+        KURLGooglePrivate(const url_parse::Parsed&, bool isValid);
+
+        // Initializes the object. This will call through to one of the backend
+        // initializers below depending on whether the string's internal
+        // representation is 8 or 16 bit.
+        void init(const KURL& base, const String& relative,
+                  const TextEncoding* queryEncoding);
+
+        // Backend initializers. The query encoding parameters are optional and can
+        // be NULL (this implies UTF-8). These initializers require that the object
+        // has just been created and the strings are NULL. Do not call on an
+        // already-constructed object.
+        void init(const KURL& base, const char* rel, int relLength,
+                  const TextEncoding* queryEncoding);
+        void init(const KURL& base, const UChar* rel, int relLength,
+                  const TextEncoding* queryEncoding);
+
+        // Does a deep copy to the given output object.
+        void copyTo(KURLGooglePrivate* dest) const;
+
+        // Returns the substring of the input identified by the given component.
+        String componentString(const url_parse::Component&) const;
+
+        // Replaces the given components, modifying the current URL. The current
+        // URL must be valid.
+        typedef url_canon::Replacements<url_parse::UTF16Char> Replacements;
+        void replaceComponents(const Replacements&);
+
+        // Setters for the data. Using the ASCII version when you know the
+        // data is ASCII will be slightly more efficient. The UTF-8 version
+        // will always be correct if the caller is unsure.
+        void setUtf8(const CString&);
+        void setAscii(const CString&);
+
+        // TODO(brettw) we can support an additional optimization.  Make this
+        // buffer support both optinal Strings and UTF-8 data. This way, we can use
+        // the optimization from the original KURL which uses = with the original
+        // string when canonicalization did not change it. This allows the strings
+        // to share a buffer internally, and saves a malloc.
+
+        // Getters for the data.
+        const CString& utf8String() const { return m_utf8; }
+        const String& string() const;
+
+        bool m_isValid;
+        bool m_protocolInHTTPFamily;
+        url_parse::Parsed m_parsed; // Indexes into the UTF-8 version of the string.
+
+    private:
+        void initProtocolInHTTPFamily();
+
+        CString m_utf8;
+
+        // Set to true when the caller set us using the ASCII setter. We can
+        // be more efficient when we know there is no UTF-8 to worry about.
+        // This flag is currently always correct, but should be changed to be a
+        // hint (see setUtf8).
+        bool m_utf8IsASCII;
+
+        mutable bool m_stringIsValid;
+        mutable String m_string;
+    };
+
+} // namespace WebCore
+
+#endif