ae97a78496e5dba0cf4d41732d4669a03b668518
[WebKit.git] / Source / WebKit2 / UIProcess / WebFrameProxy.h
1 /*
2  * Copyright (C) 2010 Apple 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
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS''
14  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
15  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS
17  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
18  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
19  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
20  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
21  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
22  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
23  * THE POSSIBILITY OF SUCH DAMAGE.
24  */
25
26 #ifndef WebFrameProxy_h
27 #define WebFrameProxy_h
28
29 #include "APIObject.h"
30 #include "ImmutableArray.h"
31 #include "GenericCallback.h"
32 #include "WebFrameListenerProxy.h"
33 #include <WebCore/FrameLoaderTypes.h>
34 #include <wtf/Forward.h>
35 #include <wtf/PassRefPtr.h>
36 #include <wtf/text/WTFString.h>
37
38 namespace CoreIPC {
39     class ArgumentDecoder;
40     class Connection;
41     class MessageID;
42 }
43
44 namespace WebKit {
45
46 class ImmutableArray;
47 class PlatformCertificateInfo;
48 class WebCertificateInfo;
49 class WebFormSubmissionListenerProxy;
50 class WebFramePolicyListenerProxy;
51 class WebPageProxy;
52
53 typedef GenericCallback<WKDataRef> DataCallback;
54
55 class WebFrameProxy : public APIObject {
56 public:
57     static const Type APIType = TypeFrame;
58
59     static PassRefPtr<WebFrameProxy> create(WebPageProxy* page, uint64_t frameID)
60     {
61         return adoptRef(new WebFrameProxy(page, frameID));
62     }
63
64     virtual ~WebFrameProxy();
65
66     enum LoadState {
67         LoadStateProvisional,
68         LoadStateCommitted,
69         LoadStateFinished
70     };
71
72     uint64_t frameID() const { return m_frameID; }
73     WebPageProxy* page() { return m_page; }
74
75     WebFrameProxy* parentFrame() { return m_parentFrame; }
76     WebFrameProxy* nextSibling() { return m_nextSibling; }
77     WebFrameProxy* previousSibling() { return m_previousSibling; }
78     WebFrameProxy* firstChild() { return m_firstChild; }
79     WebFrameProxy* lastChild() { return m_lastChild; }
80
81     void disconnect();
82
83     bool isMainFrame() const;
84
85     void setIsFrameSet(bool value) { m_isFrameSet = value; }
86     bool isFrameSet() const { return m_isFrameSet; }
87
88     LoadState loadState() const { return m_loadState; }
89
90     const String& url() const { return m_url; }
91     const String& provisionalURL() const { return m_provisionalURL; }
92
93     void setUnreachableURL(const String& unreachableURL) { m_unreachableURL = unreachableURL; }
94     const String& unreachableURL() const { return m_unreachableURL; }
95
96     const String& mimeType() const { return m_MIMEType; }
97
98     const String& title() const { return m_title; }
99
100     WebCertificateInfo* certificateInfo() const { return m_certificateInfo.get(); }
101
102     bool canProvideSource() const;
103     bool canShowMIMEType(const String& mimeType) const;
104
105     bool isDisplayingStandaloneImageDocument() const;
106     bool isDisplayingMarkupDocument() const;
107
108     void getWebArchive(PassRefPtr<DataCallback>);
109     void getMainResourceData(PassRefPtr<DataCallback>);
110     void getResourceData(WebURL*, PassRefPtr<DataCallback>);
111
112     void didStartProvisionalLoad(const String& url);
113     void didReceiveServerRedirectForProvisionalLoad(const String& url);
114     void didFailProvisionalLoad();
115     void didCommitLoad(const String& contentType, const PlatformCertificateInfo&);
116     void didFinishLoad();
117     void didFailLoad();
118     void didSameDocumentNavigation(const String&); // eg. anchor navigation, session state change.
119     void didChangeTitle(const String&);
120
121     // Frame tree operations.
122     void appendChild(WebFrameProxy*);
123     void removeChild(WebFrameProxy*);
124     void didRemoveFromHierarchy();
125     PassRefPtr<ImmutableArray> childFrames();
126     bool isDescendantOf(const WebFrameProxy* ancestor) const;
127     void dumpFrameTreeToSTDOUT(unsigned indent = 0);
128
129     // Policy operations.
130     void receivedPolicyDecision(WebCore::PolicyAction, uint64_t listenerID);
131     WebFramePolicyListenerProxy* setUpPolicyListenerProxy(uint64_t listenerID);
132     WebFormSubmissionListenerProxy* setUpFormSubmissionListenerProxy(uint64_t listenerID);
133
134 private:
135     WebFrameProxy(WebPageProxy* page, uint64_t frameID);
136
137     virtual Type type() const { return APIType; }
138
139     WebPageProxy* m_page;
140     WebFrameProxy* m_parentFrame;
141     WebFrameProxy* m_nextSibling;
142     WebFrameProxy* m_previousSibling;
143     WebFrameProxy* m_firstChild;
144     WebFrameProxy* m_lastChild;
145
146     LoadState m_loadState;
147     String m_url;
148     String m_provisionalURL;
149     String m_unreachableURL;
150     String m_MIMEType;
151     String m_title;
152     bool m_isFrameSet;
153     RefPtr<WebCertificateInfo> m_certificateInfo;
154     RefPtr<WebFrameListenerProxy> m_activeListener;
155     uint64_t m_frameID;
156 };
157
158 } // namespace WebKit
159
160 #endif // WebFrameProxy_h