blob: 66d8bef0f4aa0988846d2de887a89c9f7e560831 (
plain)
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
|
// Copyright (c) 2013 Intel Corporation. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMMON_EXTENSION_H_
#define COMMON_EXTENSION_H_
// This is a C++ wrapper over Crosswalk Extension C API. It implements once the
// boilerplate for the common case of mapping XW_Extension and XW_Instance to
// objects of their own. The wrapper deals automatically with creating and
// destroying the objects.
//
// Extension object lives during the lifetime of the extension, and when the
// extension process is properly shutdown, it's destructor will be
// called. Instance objects (there can be many) live during the lifetime of a
// script context associated with a frame in the page. These objects serves as
// storage points for extension specific objects, use them for that.
#include <sys/types.h>
#include <string>
#include "common/XW_Extension.h"
#include "common/XW_Extension_EntryPoints.h"
#include "common/XW_Extension_Permissions.h"
#include "common/XW_Extension_Runtime.h"
#include "common/XW_Extension_SyncMessage.h"
namespace common {
class Instance;
class Extension;
} // namespace common
// This function should be implemented by each extension and should return
// an appropriate Extension subclass.
common::Extension* CreateExtension();
namespace common {
class Extension {
public:
Extension();
virtual ~Extension();
// These should be called in the subclass constructor.
void SetExtensionName(const char* name);
void SetJavaScriptAPI(const char* api);
void SetExtraJSEntryPoints(const char** entry_points);
bool RegisterPermissions(const char* perm_table);
// This API should be called in the message handler of extension
bool CheckAPIAccessControl(const char* api_name);
virtual Instance* CreateInstance();
static std::string GetRuntimeVariable(const char* var_name, unsigned len);
private:
friend int32_t ::XW_Initialize(XW_Extension extension,
XW_GetInterface get_interface);
// XW_Extension callbacks.
static void OnShutdown(XW_Extension xw_extension);
static void OnInstanceCreated(XW_Instance xw_instance);
static void OnInstanceDestroyed(XW_Instance xw_instance);
static void HandleMessage(XW_Instance xw_instance, const char* msg);
static void HandleSyncMessage(XW_Instance xw_instance, const char* msg);
};
class Instance {
public:
Instance();
virtual ~Instance();
void PostMessage(const char* msg);
void SendSyncReply(const char* reply);
virtual void Initialize() {}
virtual void HandleMessage(const char* msg) = 0;
virtual void HandleSyncMessage(const char* msg) {}
XW_Instance xw_instance() const { return xw_instance_; }
private:
friend class Extension;
XW_Instance xw_instance_;
};
} // namespace common
#endif // COMMON_EXTENSION_H_
|