michael@0: /* This Source Code Form is subject to the terms of the Mozilla Public
michael@0:  * License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0:  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0:  
michael@0: #ifndef nsHtml5SpeculativeLoad_h
michael@0: #define nsHtml5SpeculativeLoad_h
michael@0: 
michael@0: #include "nsString.h"
michael@0: 
michael@0: class nsHtml5TreeOpExecutor;
michael@0: 
michael@0: enum eHtml5SpeculativeLoad {
michael@0: #ifdef DEBUG
michael@0:   eSpeculativeLoadUninitialized,
michael@0: #endif
michael@0:   eSpeculativeLoadBase,
michael@0:   eSpeculativeLoadImage,
michael@0:   eSpeculativeLoadScript,
michael@0:   eSpeculativeLoadScriptFromHead,
michael@0:   eSpeculativeLoadStyle,
michael@0:   eSpeculativeLoadManifest,
michael@0:   eSpeculativeLoadSetDocumentCharset
michael@0: };
michael@0: 
michael@0: class nsHtml5SpeculativeLoad {
michael@0:   public:
michael@0:     nsHtml5SpeculativeLoad();
michael@0:     ~nsHtml5SpeculativeLoad();
michael@0:     
michael@0:     inline void InitBase(const nsAString& aUrl)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = eSpeculativeLoadBase;
michael@0:       mUrl.Assign(aUrl);
michael@0:     }
michael@0: 
michael@0:     inline void InitImage(const nsAString& aUrl,
michael@0:                           const nsAString& aCrossOrigin)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = eSpeculativeLoadImage;
michael@0:       mUrl.Assign(aUrl);
michael@0:       mCrossOrigin.Assign(aCrossOrigin);
michael@0:     }
michael@0: 
michael@0:     inline void InitScript(const nsAString& aUrl,
michael@0:                            const nsAString& aCharset,
michael@0:                            const nsAString& aType,
michael@0:                            const nsAString& aCrossOrigin,
michael@0:                            bool aParserInHead)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = aParserInHead ?
michael@0:           eSpeculativeLoadScriptFromHead : eSpeculativeLoadScript;
michael@0:       mUrl.Assign(aUrl);
michael@0:       mCharset.Assign(aCharset);
michael@0:       mTypeOrCharsetSource.Assign(aType);
michael@0:       mCrossOrigin.Assign(aCrossOrigin);
michael@0:     }
michael@0:     
michael@0:     inline void InitStyle(const nsAString& aUrl, const nsAString& aCharset,
michael@0: 			  const nsAString& aCrossOrigin)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = eSpeculativeLoadStyle;
michael@0:       mUrl.Assign(aUrl);
michael@0:       mCharset.Assign(aCharset);
michael@0:       mCrossOrigin.Assign(aCrossOrigin);
michael@0:     }
michael@0: 
michael@0:     /**
michael@0:      * "Speculative" manifest loads aren't truly speculative--if a manifest
michael@0:      * gets loaded, we are committed to it. There can never be a <script>
michael@0:      * before the manifest, so the situation of having to undo a manifest due
michael@0:      * to document.write() never arises. The reason why a parser
michael@0:      * thread-discovered manifest gets loaded via the speculative load queue
michael@0:      * as opposed to tree operation queue is that the manifest must get
michael@0:      * processed before any actual speculative loads such as scripts. Thus,
michael@0:      * manifests seen by the parser thread have to maintain the queue order
michael@0:      * relative to true speculative loads. See bug 541079.
michael@0:      */
michael@0:     inline void InitManifest(const nsAString& aUrl)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = eSpeculativeLoadManifest;
michael@0:       mUrl.Assign(aUrl);
michael@0:     }
michael@0: 
michael@0:     /**
michael@0:      * "Speculative" charset setting isn't truly speculative. If the charset
michael@0:      * is set via this operation, we are committed to it unless chardet or
michael@0:      * a late meta cause a reload. The reason why a parser
michael@0:      * thread-discovered charset gets communicated via the speculative load
michael@0:      * queue as opposed to tree operation queue is that the charset change
michael@0:      * must get processed before any actual speculative loads such as style
michael@0:      * sheets. Thus, encoding decisions by the parser thread have to maintain
michael@0:      * the queue order relative to true speculative loads. See bug 675499.
michael@0:      */
michael@0:     inline void InitSetDocumentCharset(nsACString& aCharset,
michael@0:                                        int32_t aCharsetSource)
michael@0:     {
michael@0:       NS_PRECONDITION(mOpCode == eSpeculativeLoadUninitialized,
michael@0:                       "Trying to reinitialize a speculative load!");
michael@0:       mOpCode = eSpeculativeLoadSetDocumentCharset;
michael@0:       CopyUTF8toUTF16(aCharset, mCharset);
michael@0:       mTypeOrCharsetSource.Assign((char16_t)aCharsetSource);
michael@0:     }
michael@0: 
michael@0:     void Perform(nsHtml5TreeOpExecutor* aExecutor);
michael@0:     
michael@0:   private:
michael@0:     eHtml5SpeculativeLoad mOpCode;
michael@0:     nsString mUrl;
michael@0:     /**
michael@0:      * If mOpCode is eSpeculativeLoadStyle or eSpeculativeLoadScript[FromHead]
michael@0:      * then this is the value of the "charset" attribute. For
michael@0:      * eSpeculativeLoadSetDocumentCharset it is the charset that the
michael@0:      * document's charset is being set to. Otherwise it's empty.
michael@0:      */
michael@0:     nsString mCharset;
michael@0:     /**
michael@0:      * If mOpCode is eSpeculativeLoadSetDocumentCharset, this is a
michael@0:      * one-character string whose single character's code point is to be
michael@0:      * interpreted as a charset source integer. Otherwise, it is empty or
michael@0:      * the value of the type attribute.
michael@0:      */
michael@0:     nsString mTypeOrCharsetSource;
michael@0:     /**
michael@0:      * If mOpCode is eSpeculativeLoadImage or eSpeculativeLoadScript[FromHead],
michael@0:      * this is the value of the "crossorigin" attribute.  If the
michael@0:      * attribute is not set, this will be a void string.
michael@0:      */
michael@0:     nsString mCrossOrigin;
michael@0: };
michael@0: 
michael@0: #endif // nsHtml5SpeculativeLoad_h