src/chrome/browser/guestview/guestview.h

   1 // Copyright 2013 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef CHROME_BROWSER_GUESTVIEW_GUESTVIEW_H_
   6 #define CHROME_BROWSER_GUESTVIEW_GUESTVIEW_H_
   7
   8 #include <queue>
   9
  10 #include "base/memory/weak_ptr.h"
  11 #include "base/values.h"
  12 #include "content/public/browser/browser_plugin_guest_delegate.h"
  13 #include "content/public/browser/web_contents.h"
  14
  15 class AdViewGuest;
  16 class WebViewGuest;
  17 struct RendererContentSettingRules;
  18
  19 // A GuestView is the base class browser-side API implementation for a <*view>
  20 // tag. GuestView maintains an association between a guest WebContents and an
  21 // embedder WebContents. It receives events issued from the guest and relays
  22 // them to the embedder.
  23 class GuestView : public content::BrowserPluginGuestDelegate {
  24  public:
  25   enum Type {
  26     WEBVIEW,
  27     ADVIEW,
  28     UNKNOWN
  29   };
  30
  31   class Event {
  32    public:
  33      Event(const std::string& name, scoped_ptr<base::DictionaryValue> args);
  34      ~Event();
  35
  36     const std::string& name() const { return name_; }
  37
  38     scoped_ptr<base::DictionaryValue> GetArguments();
  39
  40    private:
  41     const std::string name_;
  42     scoped_ptr<base::DictionaryValue> args_;
  43   };
  44
  45   static Type GetViewTypeFromString(const std::string& api_type);
  46
  47   static GuestView* Create(content::WebContents* guest_web_contents,
  48                            const std::string& embedder_extension_id,
  49                            Type view_type);
  50
  51   static GuestView* FromWebContents(content::WebContents* web_contents);
  52
  53   static GuestView* From(int embedder_process_id, int instance_id);
  54
  55   // For GuestViews, we create special guest processes, which host the
  56   // tag content separately from the main application that embeds the tag.
  57   // A GuestView can specify both the partition name and whether the storage
  58   // for that partition should be persisted. Each tag gets a SiteInstance with
  59   // a specially formatted URL, based on the application it is hosted by and
  60   // the partition requested by it. The format for that URL is:
  61   // chrome-guest://partition_domain/persist?partition_name
  62   static bool GetGuestPartitionConfigForSite(const GURL& site,
  63                                              std::string* partition_domain,
  64                                              std::string* partition_name,
  65                                              bool* in_memory);
  66
  67   // By default, JavaScript and images are enabled in guest content.
  68   static void GetDefaultContentSettingRules(
  69       RendererContentSettingRules* rules, bool incognito);
  70
  71   virtual void Attach(content::WebContents* embedder_web_contents,
  72                       const base::DictionaryValue& args);
  73
  74   content::WebContents* embedder_web_contents() const {
  75     return embedder_web_contents_;
  76   }
  77
  78   // Returns the guest WebContents.
  79   content::WebContents* guest_web_contents() const {
  80     return guest_web_contents_;
  81   }
  82
  83   virtual Type GetViewType() const;
  84
  85   // Returns a WebViewGuest if this GuestView belongs to a <webview>.
  86   virtual WebViewGuest* AsWebView() = 0;
  87
  88   // Returns an AdViewGuest if the GuestView belongs to an <adview>.
  89   virtual AdViewGuest* AsAdView() = 0;
  90
  91   // Returns whether this guest has an associated embedder.
  92   bool attached() const { return !!embedder_web_contents_; }
  93
  94   // Returns the instance ID of the <*view> element.
  95   int view_instance_id() const { return view_instance_id_; }
  96
  97   // Returns the instance ID of the guest WebContents.
  98   int guest_instance_id() const { return guest_instance_id_; }
  99
 100   // Returns the extension ID of the embedder.
 101   const std::string& embedder_extension_id() const {
 102     return embedder_extension_id_;
 103   }
 104
 105   // Returns whether this GuestView is embedded in an extension/app.
 106   bool in_extension() const {
 107     return !embedder_extension_id_.empty();
 108   }
 109
 110   // Returns the user browser context of the embedder.
 111   content::BrowserContext* browser_context() const { return browser_context_; }
 112
 113   // Returns the embedder's process ID.
 114   int embedder_render_process_id() const { return embedder_render_process_id_; }
 115
 116  protected:
 117   GuestView(content::WebContents* guest_web_contents,
 118             const std::string& embedder_extension_id);
 119   virtual ~GuestView();
 120
 121   // Dispatches an event |event_name| to the embedder with the |event| fields.
 122   void DispatchEvent(Event* event);
 123
 124  private:
 125   void SendQueuedEvents();
 126
 127   content::WebContents* const guest_web_contents_;
 128   content::WebContents* embedder_web_contents_;
 129   const std::string embedder_extension_id_;
 130   int embedder_render_process_id_;
 131   content::BrowserContext* const browser_context_;
 132   // |guest_instance_id_| is a profile-wide unique identifier for a guest
 133   // WebContents.
 134   const int guest_instance_id_;
 135   // |view_instance_id_| is an identifier that's unique within a particular
 136   // embedder RenderViewHost for a particular <*view> instance.
 137   int view_instance_id_;
 138
 139   // This is a queue of Events that are destined to be sent to the embedder once
 140   // the guest is attached to a particular embedder.
 141   std::queue<Event*> pending_events_;
 142
 143   // This is used to ensure pending tasks will not fire after this object is
 144   // destroyed.
 145   base::WeakPtrFactory<GuestView> weak_ptr_factory_;
 146
 147   DISALLOW_COPY_AND_ASSIGN(GuestView);
 148 };
 149
 150 #endif  // CHROME_BROWSER_GUESTVIEW_GUESTVIEW_H_