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
125
126
127
128
129
130
131
132
133
|
// Copyright 2008, Google Inc.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are
// met:
//
// * Redistributions of source code must retain the above copyright
// notice, this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above
// copyright notice, this list of conditions and the following disclaimer
// in the documentation and/or other materials provided with the
// distribution.
// * Neither the name of Google Inc. nor the names of its
// contributors may be used to endorse or promote products derived from
// this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#ifndef CHROME_RENDERER_AUTOMATION_DOM_AUTOMATION_CONTROLLER_H__
#define CHROME_RENDERER_AUTOMATION_DOM_AUTOMATION_CONTROLLER_H__
#include "chrome/common/ipc_message.h"
#include "webkit/glue/cpp_bound_class.h"
/* DomAutomationController class:
Bound to Javascript window.domAutomationController object.
At the very basic, this object makes any native value (string, numbers,
boolean) from javascript available to the automation host in Cpp.
Any renderer implementation that is built with this binding will allow the
above facility.
The intended use of this object is to expose the DOM Objects and their
attributes to the automation host.
A typical usage would be like following (JS code):
var object = document.getElementById('some_id');
window.domAutomationController.send(object.nodeName); // get the tag name
For the exact mode of usage,
refer AutomationProxyTest.*DomAutomationController tests.
The class provides a single send method that can send variety of native
javascript values. (NPString, Number(double), Boolean)
The actual communication occurs in the following manner:
TEST MASTER RENDERER
(1) (3)
|AProxy| ----->|AProvider|----->|RenderView|------|
/\ | | |
| | | |
|(6) |(2) |(0) |(4)
| | \/ |
| |-------->|DAController|<----|
| |
| |(5)
|---------|WebContents|<----------|
Legends:
- AProxy = AutomationProxy
- AProvider = AutomationProvider
- DAController = DomAutomationController
(0) Initialization step where DAController is bound to the renderer
and the view_id of the renderer is supplied to the DAController for
routing message in (5). (routing_id_)
(1) A 'javascript:' url is sent from the test process to master as an IPC
message. A unique routing id is generated at this stage (automation_id_)
(2) The automation_id_ of step (1) is supplied to DAController by calling
the bound method setAutomationId(). This is required for routing message
in (6).
(3) The 'javascript:' url is sent for execution by calling into
Browser::LoadURL()
(4) A callback is generated as a result of domAutomationController.send()
into Cpp. The supplied value is received as a result of this callback.
(5) The value received in (4) is sent to the master along with the
stored automation_id_ as an IPC message. routing_id_ is used to route
the message. (IPC messages, ViewHostMsg_*DomAutomation* )
(6) The value and the automation_id_ is extracted out of the message received
in (5). This value is relayed to AProxy using another IPC message.
automation_id_ is used to route the message.
(IPC messages, AutomationMsg_Dom*Response)
*/
// TODO(vibhor): Add another method-pair like sendLater() and sendNow()
// sendLater() should keep building a json serializer
// sendNow() should send the above serializer as a string.
class DomAutomationController : public CppBoundClass {
public:
DomAutomationController();
~DomAutomationController() {}
// Makes the renderer send a javascript value to the app.
// The value to be sent can be either of type NPString,
// Number (double casted to int32) or boolean.
// The function returns true/false based on the result of actual send over
// IPC. It sets the return value to null on unexpected errors or arguments.
void send(const CppArgumentList& args, CppVariant* result);
void setAutomationId(const CppArgumentList& args, CppVariant* result);
// TODO(vibhor): Implement later
// static CppBindingObjectMethod sendLater;
// static CppBindingObjectMethod sendNow;
static void set_routing_id(int routing_id) { routing_id_ = routing_id; }
static void set_message_sender(IPC::Message::Sender* sender) {
sender_ = sender;
}
private:
static IPC::Message::Sender* sender_;
// Refer to the comments at the top of the file for more details.
static int routing_id_; // routing id to be used by first channel.
static int automation_id_; // routing id to be used by the next channel.
};
#endif // CHROME_RENDERER_AUTOMATION_DOM_AUTOMATION_CONTROLLER_H__
|
