1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
|
// 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_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_HOST_H__
#define CONTENT_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_HOST_H__
#pragma once
#include <map>
#include "content/public/browser/notification_observer.h"
#include "content/public/browser/notification_registrar.h"
#include "content/public/browser/web_contents_delegate.h"
#include "content/public/browser/web_contents_observer.h"
#include "ppapi/c/pp_instance.h"
#include "ui/gfx/size.h"
class WebContentsImpl;
namespace content {
class RenderProcessHost;
// A BrowserPluginHost object is used by both embedders and guests.
// The primary purpose of BrowserPluginHost is to allow an embedder
// to manage the lifetime of its guests. It cleans up its guests
// on navigation, crashes, and "hides" guests when it hides.
// For the guest, BrowserPluginHost keeps track of its embedder,
// and its BrowserPlugin instance ID.
class BrowserPluginHost : public WebContentsObserver,
public NotificationObserver,
public WebContentsDelegate {
public:
// BrowserPluginHost is owned by a WebContentsImpl. Here it takes in its
// owner. The owner can be either a guest or embedder WebContents.
explicit BrowserPluginHost(WebContentsImpl* web_contents);
virtual ~BrowserPluginHost();
void ConnectEmbedderToChannel(RenderViewHost* render_view_host,
const IPC::ChannelHandle& handle);
// This is called on the first navigation of the browser plugin. It creates
// a new WebContentsImpl for the guest, associates it with its embedder, sets
// its size and navigates it to the src URL.
void NavigateGuestFromEmbedder(RenderViewHost* render_view_host,
int container_instance_id,
long long frame_id,
const std::string& src);
RenderProcessHost* embedder_render_process_host() const {
return embedder_render_process_host_;
}
int instance_id() const { return instance_id_; }
private:
typedef std::map<WebContentsImpl*, int64> GuestMap;
typedef std::map<int, BrowserPluginHost*> ContainerInstanceMap;
// Get a guest BrowserPluginHost by its container ID specified
// in BrowserPlugin.
BrowserPluginHost* GetGuestByContainerID(int container_id);
// Associate a guest with its container instance ID.
void RegisterContainerInstance(
int container_id,
BrowserPluginHost* observer);
// An embedder BrowserPluginHost keeps track of
// its guests so that if it navigates away, its associated RenderView
// crashes or it is hidden, it takes appropriate action on the guest.
void AddGuest(WebContentsImpl* guest, int64 frame_id);
// This removes a guest from an embedder's guest list.
// TODO(fsamuel): Use this when deleting guest after they crash.
// ToT plugin crash handling seems to be broken in this case and so I can't
// test this scenario at the moment. Delete this comment once fixed.
void RemoveGuest(WebContentsImpl* guest);
void set_embedder_render_process_host(
RenderProcessHost* embedder_render_process_host) {
embedder_render_process_host_ = embedder_render_process_host;
}
void set_instance_id(int instance_id) { instance_id_ = instance_id; }
void OnNavigateFromGuest(PP_Instance instance,
const std::string& src);
void DestroyGuests();
// WebContentObserver implementation.
virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
// Used to monitor frame navigation to cleanup 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;
virtual void WebContentsDestroyed(WebContents* web_contents) OVERRIDE;
// NotificationObserver method override.
virtual void Observe(int type,
const NotificationSource& source,
const NotificationDetails& details) OVERRIDE;
// A scoped container for notification registries.
NotificationRegistrar registrar_;
RenderProcessHost* embedder_render_process_host_;
std::string embedder_channel_name_;
// An identifier that uniquely identifies a browser plugin container
// within an embedder.
int instance_id_;
gfx::Size initial_size_;
GuestMap guests_;
ContainerInstanceMap guests_by_container_id_;
};
} // namespace content
#endif // CONTENT_BROWSER_BROWSER_PLUGIN_BROWSER_PLUGIN_HOST_H_
|
