1 /* 2 * Copyright (C) 2009 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 #ifndef WebDataSource_h 32 #define WebDataSource_h 33 34 #include "../platform/WebCommon.h" 35 #include "WebNavigationType.h" 36 #include "WebTextDirection.h" 37 38 namespace blink { 39 40 class WebApplicationCacheHost; 41 class WebString; 42 class WebURL; 43 class WebURLRequest; 44 class WebURLResponse; 45 template <typename T> class WebVector; 46 47 class WebDataSource { 48 public: 49 class ExtraData { 50 public: ~ExtraData()51 virtual ~ExtraData() { } 52 }; 53 54 // Returns the original request that resulted in this datasource. 55 virtual const WebURLRequest& originalRequest() const = 0; 56 57 // Returns the request corresponding to this datasource. It may 58 // include additional request headers added by WebKit that were not 59 // present in the original request. This request may also correspond 60 // to a location specified by a redirect that was followed. 61 virtual const WebURLRequest& request() const = 0; 62 63 // Returns the response associated with this datasource. 64 virtual const WebURLResponse& response() const = 0; 65 66 // When this datasource was created as a result of WebFrame::loadData, 67 // there may be an associated unreachableURL. 68 virtual bool hasUnreachableURL() const = 0; 69 virtual WebURL unreachableURL() const = 0; 70 71 // Allows the embedder to append redirects to the chain as a navigation 72 // is starting, in case it is being transferred from another process. 73 virtual void appendRedirect(const WebURL&) = 0; 74 75 // Returns all redirects that occurred (both client and server) before 76 // at last committing the current page. This will contain one entry 77 // for each intermediate URL, and one entry for the last URL (so if 78 // there are no redirects, it will contain exactly the current URL, and 79 // if there is one redirect, it will contain the source and destination 80 // URL). 81 virtual void redirectChain(WebVector<WebURL>&) const = 0; 82 83 // Returns whether the navigation associated with this datasource is a 84 // client redirect. 85 virtual bool isClientRedirect() const = 0; 86 87 // Returns whether the navigation associated with this datasource should 88 // replace the current history item. 89 virtual bool replacesCurrentHistoryItem() const = 0; 90 91 // The type of navigation that triggered the creation of this datasource. 92 virtual WebNavigationType navigationType() const = 0; 93 94 // The time in seconds (since the epoch) of the event that triggered 95 // the creation of this datasource. Returns 0 if unknown. 96 virtual double triggeringEventTime() const = 0; 97 98 // Extra data associated with this datasource. If non-null, the extra 99 // data pointer will be deleted when the datasource is destroyed. 100 // Setting the extra data pointer will cause any existing non-null 101 // extra data pointer to be deleted. 102 virtual ExtraData* extraData() const = 0; 103 virtual void setExtraData(ExtraData*) = 0; 104 105 // Sets the navigation start time for this datasource. Ordinarily, 106 // navigation start is determined in WebCore. But, in some situations, 107 // the embedder might have a better value and can override it here. This 108 // should be called before WebFrameClient::didCommitProvisionalLoad. 109 // Calling it later may confuse users, because JavaScript may have run and 110 // the user may have already recorded the original value. 111 virtual void setNavigationStartTime(double) = 0; 112 113 protected: ~WebDataSource()114 ~WebDataSource() { } 115 }; 116 117 } // namespace blink 118 119 #endif 120