Browser Plugin: New Implementation (Browser Side)

content/browser/browser_plugin/browser_plugin_embedder.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.
+
+// A BrowserPluginEmbedder has a list of guest it manages.
+// In the beginning when a renderer sees one ore more guests (BrowserPlugin

[awong, 2012/09/07 20:51:03]

ore -> or

[lazyboy, 2012/09/08 02:12:22]

Done.

+// instance(s)) and there is a request to navigate to them, the WebContents of

[awong, 2012/09/07 20:51:03]

of -> for

[lazyboy, 2012/09/08 02:12:22]

Done.

+// that renderer creates a BrowserPluginEmbedder for it, which in turn manages

[awong, 2012/09/07 20:51:03]

Do you mean "itself" (aka, the WebContents)?

Breaking the second clause into another will be more clear.

The BrowserPluginEmbedder, in turn, manages a set of BrowserPluginGuests -- one
BrowserPluginGuest for each guest in the embedding WebContents.

[lazyboy, 2012/09/08 02:12:22]

Done.

+// the guest(s). It routes any messages directed to a guest from the renderer

[awong, 2012/09/07 20:51:03]

Same question about "It" :(

Because the previous sentence had so many objects/nouns, it's hard to know.

http://englishplus.com/grammar/00000030.htm

[lazyboy, 2012/09/08 02:12:22]

Done.

+// (BrowserPlugin) to the appropriate guest (identified by the guest's
+// |instance_id|). It is responsible for cleaning up the guests when the
+// embedder frame navigates away to a different page.
+
+#ifndef CONTENT_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_EMBEDDER_H_
+#define CONTENT_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_EMBEDDER_H_
+
+#include <map>
+#include <string>
+
+#include "base/compiler_specific.h"
+#include "content/browser/browser_plugin/browser_plugin_host_factory.h"
+#include "content/public/browser/notification_observer.h"
+#include "content/public/browser/notification_registrar.h"
+#include "content/public/browser/render_view_host_observer.h"
+#include "content/public/browser/web_contents_delegate.h"
+#include "content/public/browser/web_contents_observer.h"
+#include "ipc/ipc_channel_handle.h"
+#include "ipc/ipc_sync_message.h"
+#include "third_party/WebKit/Source/WebKit/chromium/public/WebInputEvent.h"
+#include "ui/surface/transport_dib.h"
+#include "webkit/glue/webcursor.h"
+
+namespace gfx {
+class Size;
+}
+
+class WebContentsImpl;
+
+struct BrowserPluginHostMsg_ResizeGuest_Params;
+struct ViewHostMsg_UpdateRect_Params;
+
+namespace content {
+
+class BrowserPluginGuest;
+class BrowserPluginHostFactory;
+
+typedef std::map<WebContents*, int64> GuestWebContentsMap;
+typedef std::map<int, BrowserPluginGuest*> ContainerInstanceMap;
+
+// A browser plugin embedder provides functionality for WebContents to operate
+// in the 'embedder' role. It manages list of guests inside the embedder.
+// The embedder's WebContents manages the lifetime of the embedder. They are
+// created when a renderer asks WebContents to navigate (for the first time) to
+// some guest. It gets destroyed when either the WebContents goes away or there
+// is a RenderViewHost swap in WebContents.
+class CONTENT_EXPORT BrowserPluginEmbedder : public WebContentsObserver,
+                                             public NotificationObserver {
+ public:
+  virtual ~BrowserPluginEmbedder();
+
+  static BrowserPluginEmbedder* Create(WebContentsImpl* web_contents,
+                                       RenderViewHost* render_view_host);
+
+  // Navigates in a guest (new or existing).
+  void NavigateGuest(RenderViewHost* render_view_host,
+                     int instance_id,
+                     int64 frame_id,
+                     const std::string& src,
+                     const gfx::Size& size);
+
+  // Overrides factory for testing. Default (NULL) value indicates regular
+  // (non-test) environment.
+  static void set_factory_for_testing(BrowserPluginHostFactory* factory) {
+    factory_ = factory;
+  }
+
+ private:
+  friend class BrowserPluginEmbedderHelper;
+  friend class TestBrowserPluginEmbedder;
+
+  BrowserPluginEmbedder(WebContentsImpl* web_contents,
+                        RenderViewHost* render_view_host);
+
+  // Returns a guest browser plugin delegate by its container ID specified
+  // in BrowserPlugin.
+  BrowserPluginGuest* GetGuestByInstanceID(int instance_id) const;
+  // Adds a new guest to the embedder (overridable in test).
+  virtual void AddGuest(int instance_id,
+                        BrowserPluginGuest* guest,
+                        int64 frame_id);
+  void DestroyGuestByInstanceID(int instance_id);
+  void DestroyGuests();
+
+  // Message handlers (direct/indirect via BrowserPluginEmbedderHelper).
+  // Routes update rect ack message to the appropriate guest.
+  void UpdateRectACK(int instance_id, int message_id, const gfx::Size& size);
+  void SetFocus(int instance_id, bool focused);
+  void ResizeGuest(int instance_id,
+                   TransportDIB* damage_buffer,
+                   int width,
+                   int height,
+                   bool resize_pending,
+                   float scale_factor);
+  // Handles input events sent from the BrowserPlugin (embedder's renderer
+  // process) by passing them to appropriate guest's input handler.
+  void HandleInputEvent(int instance_id,
+                        RenderViewHost* render_view_host,
+                        const gfx::Rect& guest_rect,
+                        const WebKit::WebInputEvent& event,
+                        IPC::Message* reply_message);
+  void PluginDestroyed(int instance_id);
+
+  // WebContentsObserver implementation.
+  // Used to monitor frame navigation to clean up guests when a frame navigates
+  // away from the browser plugin it's hosting.
+  virtual void DidCommitProvisionalLoadForFrame(
+      int64 frame_id,
+      bool is_main_frame,
+      const GURL& url,
+      PageTransition transition_type,
+      RenderViewHost* render_view_host) OVERRIDE;
+  virtual void RenderViewDeleted(RenderViewHost* render_view_host) OVERRIDE;
+  virtual void RenderViewGone(base::TerminationStatus status) OVERRIDE;
+
+  // NotificationObserver method override.
+  virtual void Observe(int type,
+                       const NotificationSource& source,
+                       const NotificationDetails& details) OVERRIDE;
+
+  // Called when visiblity of web_contents changes, so the embedder will
+  // show/hide its guest.
+  void WebContentsVisibilityChanged(bool visible);
+
+  // Static factory instance (always NULL for non-test).
+  static BrowserPluginHostFactory* factory_;
+
+  // A scoped container for notification registries.
+  NotificationRegistrar registrar_;
+
+  // Contains guests' WebContents, mapping to their frame ids.
+  GuestWebContentsMap guest_web_contents_container_;
+  ContainerInstanceMap guests_by_instance_id_;
+  RenderViewHost* render_view_host_;
+
+  DISALLOW_COPY_AND_ASSIGN(BrowserPluginEmbedder);
+};
+
+}  // namespace content
+
+#endif  // CONTENT_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_EMBEDDER_H_