1c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant// Copyright 2014 The Chromium Authors. All rights reserved. 2c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant// Use of this source code is governed by a BSD-style license that can be 3c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant// found in the LICENSE file. 4c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 5b64f8b07c104c6cc986570ac8ee0ed16a9f23976Howard Hinnant#ifndef CONTENT_RENDERER_RENDER_FRAME_PROXY_H_ 6b64f8b07c104c6cc986570ac8ee0ed16a9f23976Howard Hinnant#define CONTENT_RENDERER_RENDER_FRAME_PROXY_H_ 7c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 8c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "base/basictypes.h" 9c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "base/memory/ref_counted.h" 10c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "content/common/content_export.h" 11c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "ipc/ipc_listener.h" 12c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "ipc/ipc_sender.h" 13c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 14c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "third_party/WebKit/public/web/WebRemoteFrame.h" 15c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant#include "third_party/WebKit/public/web/WebRemoteFrameClient.h" 16c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 17c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnantstruct FrameMsg_BuffersSwapped_Params; 18c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnantstruct FrameMsg_CompositorFrameSwapped_Params; 19c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 20c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnantnamespace content { 21c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnant 22c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnantclass ChildFrameCompositingHelper; 23c52f43e72dfcea03037729649da84c23b3beb04aHoward Hinnantclass RenderFrameImpl; 24class RenderViewImpl; 25 26// When a page's frames are rendered by multiple processes, each renderer has a 27// full copy of the frame tree. It has full RenderFrames for the frames it is 28// responsible for rendering and placeholder objects for frames rendered by 29// other processes. This class is the renderer-side object for the placeholder. 30// RenderFrameProxy allows us to keep existing window references valid over 31// cross-process navigations and route cross-site asynchronous JavaScript calls, 32// such as postMessage. 33// 34// For now, RenderFrameProxy is created when RenderFrame is swapped out. It 35// acts as a wrapper and is used for sending and receiving IPC messages. It is 36// deleted when the RenderFrame is swapped back in or the node of the frame 37// tree is deleted. 38// 39// Long term, RenderFrameProxy will be created to replace the RenderFrame in the 40// frame tree and the RenderFrame will be deleted after its unload handler has 41// finished executing. It will still be responsible for routing IPC messages 42// which are valid for cross-site interactions between frames. 43// RenderFrameProxy will be deleted when the node in the frame tree is deleted 44// or when navigating the frame causes it to return to this process and a new 45// RenderFrame is created for it. 46class CONTENT_EXPORT RenderFrameProxy 47 : public IPC::Listener, 48 public IPC::Sender, 49 NON_EXPORTED_BASE(public blink::WebRemoteFrameClient) { 50 public: 51 // This method should be used to create a RenderFrameProxy, which will replace 52 // an existing RenderFrame during its cross-process navigation from the 53 // current process to a different one. |routing_id| will be ID of the newly 54 // created RenderFrameProxy. |frame_to_replace| is the frame that the new 55 // proxy will eventually swap places with. 56 static RenderFrameProxy* CreateProxyToReplaceFrame( 57 RenderFrameImpl* frame_to_replace, 58 int routing_id); 59 60 // This method should be used to create a RenderFrameProxy, when there isn't 61 // an existing RenderFrame. It should be called to construct a local 62 // representation of a RenderFrame that has been created in another process -- 63 // for example, after a cross-process navigation or after the addition of a 64 // new frame local to some other process. |routing_id| will be the ID of the 65 // newly created RenderFrameProxy. |parent_routing_id| is the routing ID of 66 // the RenderFrameProxy to which the new frame is parented. 67 // |render_view_routing_id| identifies the RenderView to be associated with 68 // this frame. 69 // 70 // |parent_routing_id| always identifies a RenderFrameProxy (never a 71 // RenderFrame) because a new child of a local frame should always start out 72 // as a frame, not a proxy. 73 static RenderFrameProxy* CreateFrameProxy(int routing_id, 74 int parent_routing_id, 75 int render_view_routing_id); 76 77 // Returns the RenderFrameProxy for the given routing ID. 78 static RenderFrameProxy* FromRoutingID(int routing_id); 79 80 // Returns the RenderFrameProxy given a WebFrame. 81 static RenderFrameProxy* FromWebFrame(blink::WebFrame* web_frame); 82 83 virtual ~RenderFrameProxy(); 84 85 // IPC::Sender 86 virtual bool Send(IPC::Message* msg) OVERRIDE; 87 88 // Out-of-process child frames receive a signal from RenderWidgetCompositor 89 // when a compositor frame has committed. 90 void DidCommitCompositorFrame(); 91 92 int routing_id() { return routing_id_; } 93 RenderViewImpl* render_view() { return render_view_; } 94 blink::WebRemoteFrame* web_frame() { return web_frame_; } 95 96 // blink::WebRemoteFrameClient implementation: 97 virtual void postMessageEvent( 98 blink::WebLocalFrame* sourceFrame, 99 blink::WebRemoteFrame* targetFrame, 100 blink::WebSecurityOrigin target, 101 blink::WebDOMMessageEvent event); 102 virtual void initializeChildFrame( 103 const blink::WebRect& frame_rect, 104 float scale_factor); 105 106 private: 107 RenderFrameProxy(int routing_id, int frame_routing_id); 108 109 void Init(blink::WebRemoteFrame* frame, RenderViewImpl* render_view); 110 111 // IPC::Listener 112 virtual bool OnMessageReceived(const IPC::Message& msg) OVERRIDE; 113 114 // IPC handlers 115 void OnDeleteProxy(); 116 void OnChildFrameProcessGone(); 117 void OnCompositorFrameSwapped(const IPC::Message& message); 118 void OnDisownOpener(); 119 120 // The routing ID by which this RenderFrameProxy is known. 121 const int routing_id_; 122 123 // The routing ID of the local RenderFrame (if any) which this 124 // RenderFrameProxy is meant to replace in the frame tree. 125 const int frame_routing_id_; 126 127 // Stores the WebRemoteFrame we are associated with. 128 blink::WebRemoteFrame* web_frame_; 129 scoped_refptr<ChildFrameCompositingHelper> compositing_helper_; 130 131 RenderViewImpl* render_view_; 132 133 DISALLOW_COPY_AND_ASSIGN(RenderFrameProxy); 134}; 135 136} // namespace 137 138#endif // CONTENT_RENDERER_RENDER_FRAME_PROXY_H_ 139