Make <webview> use out-of-process iframe architecture.

content/public/browser/web_contents.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_
 #define CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_
 
 #include <set>
 
 #include "base/basictypes.h"
@@ skipping 62 matching lines @@
 //
 // That's it; go to your kitchen, grab a scone, and chill. WebContents will do
 // all the multi-process stuff behind the scenes. More details are at
 // http://www.chromium.org/developers/design-documents/multi-process-architecture .
 //
 // Each WebContents has exactly one NavigationController; each
 // NavigationController belongs to one WebContents. The NavigationController can
 // be obtained from GetController(), and is used to load URLs into the
 // WebContents, navigate it backwards/forwards, etc. See navigation_controller.h
 // for more details.
 class WebContents : public PageNavigator,

[Charlie Reis, 2015/05/22 23:44:31]

We may want to add a small paragraph about inner/outer WebContents, now that
we're adding it as a first class concept.  Something like:

One WebContents can be nested inside another for the purpose of embedding
out-of-process top-level pages inside a page.  The outer WebContents can host a
tree of inner WebContentses using |AttachToOuterWebContentsFrame|.

                     public IPC::Sender,
                     public base::SupportsUserData {
  public:
   struct CONTENT_EXPORT CreateParams {
     explicit CreateParams(BrowserContext* context);
     ~CreateParams();
     CreateParams(BrowserContext* context, SiteInstance* site);
 
     BrowserContext* browser_context;
 
@@ skipping 275 matching lines @@
   // SwapOut in RenderViewHost, which run the unload handler.
   //
   // |for_cross_site_transition| indicates whether this call is for the current
   // frame during a cross-process navigation. False means we're closing the
   // entire tab.
   //
   // TODO(creis): We should run the beforeunload handler for every frame that
   // has one.
   virtual void DispatchBeforeUnload(bool for_cross_site_transition) = 0;
 
+  // Attaches or associates this inner WebContents to its container frame

[nasko, 2015/05/22 16:32:28]

nit: What is the difference between "attach" and "associate"?

[lazyboy, 2015/05/26 16:32:55]

None, removed "associates".

+  // |outer_contents_frame| in |outer_web_contents|.
+  virtual void AttachToOuterWebContentsFrame(
+      WebContents* outer_web_contents,
+      RenderFrameHost* outer_contents_frame) = 0;
+
   // Commands ------------------------------------------------------------------
 
   // Stop any pending navigation.
   virtual void Stop() = 0;
 
   // Creates a new WebContents with the same state as this one. The returned
   // heap-allocated pointer is owned by the caller.
   virtual WebContents* Clone() = 0;
 
   // Reloads the focused frame.
@@ skipping 270 matching lines @@
 
  private:
   // This interface should only be implemented inside content.
   friend class WebContentsImpl;
   WebContents() {}
 };
 
 }  // namespace content
 
 #endif  // CONTENT_PUBLIC_BROWSER_WEB_CONTENTS_H_