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
|
// 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_WEBUI_WEB_UI_IMPL_H_
#define CONTENT_BROWSER_WEBUI_WEB_UI_IMPL_H_
#include <map>
#include <set>
#include "base/compiler_specific.h"
#include "base/memory/scoped_vector.h"
#include "base/memory/weak_ptr.h"
#include "content/public/browser/web_ui.h"
#include "ipc/ipc_listener.h"
namespace content {
class RenderFrameHost;
class RenderViewHost;
class CONTENT_EXPORT WebUIImpl : public WebUI,
public IPC::Listener,
public base::SupportsWeakPtr<WebUIImpl> {
public:
explicit WebUIImpl(WebContents* contents);
virtual ~WebUIImpl();
// Called by WebContentsImpl when the RenderView is first created. This is
// *not* called for every page load because in some cases
// RenderFrameHostManager will reuse RenderView instances.
void RenderViewCreated(RenderViewHost* render_view_host);
// WebUI implementation:
virtual WebContents* GetWebContents() const OVERRIDE;
virtual WebUIController* GetController() const OVERRIDE;
virtual void SetController(WebUIController* controller) OVERRIDE;
virtual float GetDeviceScaleFactor() const OVERRIDE;
virtual const base::string16& GetOverriddenTitle() const OVERRIDE;
virtual void OverrideTitle(const base::string16& title) OVERRIDE;
virtual PageTransition GetLinkTransitionType() const OVERRIDE;
virtual void SetLinkTransitionType(PageTransition type) OVERRIDE;
virtual int GetBindings() const OVERRIDE;
virtual void SetBindings(int bindings) OVERRIDE;
virtual void OverrideJavaScriptFrame(const std::string& frame_name) OVERRIDE;
virtual void AddMessageHandler(WebUIMessageHandler* handler) OVERRIDE;
typedef base::Callback<void(const base::ListValue*)> MessageCallback;
virtual void RegisterMessageCallback(
const std::string& message,
const MessageCallback& callback) OVERRIDE;
virtual void ProcessWebUIMessage(const GURL& source_url,
const std::string& message,
const base::ListValue& args) OVERRIDE;
virtual void CallJavascriptFunction(
const std::string& function_name) OVERRIDE;
virtual void CallJavascriptFunction(const std::string& function_name,
const base::Value& arg) OVERRIDE;
virtual void CallJavascriptFunction(const std::string& function_name,
const base::Value& arg1,
const base::Value& arg2) OVERRIDE;
virtual void CallJavascriptFunction(const std::string& function_name,
const base::Value& arg1,
const base::Value& arg2,
const base::Value& arg3) OVERRIDE;
virtual void CallJavascriptFunction(const std::string& function_name,
const base::Value& arg1,
const base::Value& arg2,
const base::Value& arg3,
const base::Value& arg4) OVERRIDE;
virtual void CallJavascriptFunction(
const std::string& function_name,
const std::vector<const base::Value*>& args) OVERRIDE;
// IPC::Listener implementation:
virtual bool OnMessageReceived(const IPC::Message& message) OVERRIDE;
private:
// IPC message handling.
void OnWebUISend(const GURL& source_url,
const std::string& message,
const base::ListValue& args);
// Execute a string of raw JavaScript on the page.
void ExecuteJavascript(const base::string16& javascript);
// Finds the frame in which to execute JavaScript (the one specified by
// OverrideJavaScriptFrame). May return NULL if no frame of the specified name
// exists in the page.
RenderFrameHost* TargetFrame();
// A helper function for TargetFrame; adds a frame to the specified set if its
// name matches frame_name_.
void AddToSetIfFrameNameMatches(std::set<RenderFrameHost*>* frame_set,
RenderFrameHost* host);
// A map of message name -> message handling callback.
typedef std::map<std::string, MessageCallback> MessageCallbackMap;
MessageCallbackMap message_callbacks_;
// Options that may be overridden by individual Web UI implementations. The
// bool options default to false. See the public getters for more information.
base::string16 overridden_title_; // Defaults to empty string.
PageTransition link_transition_type_; // Defaults to LINK.
int bindings_; // The bindings from BindingsPolicy that should be enabled for
// this page.
// The WebUIMessageHandlers we own.
ScopedVector<WebUIMessageHandler> handlers_;
// Non-owning pointer to the WebContents this WebUI is associated with.
WebContents* web_contents_;
// The name of the iframe this WebUI is embedded in (empty if not explicitly
// overridden with OverrideJavaScriptFrame).
std::string frame_name_;
scoped_ptr<WebUIController> controller_;
DISALLOW_COPY_AND_ASSIGN(WebUIImpl);
};
} // namespace content
#endif // CONTENT_BROWSER_WEBUI_WEB_UI_IMPL_H_
|