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
|
// Copyright 2013 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 MOJO_PUBLIC_CPP_BINDINGS_LIB_BINDINGS_SERIALIZATION_H_
#define MOJO_PUBLIC_CPP_BINDINGS_LIB_BINDINGS_SERIALIZATION_H_
#include <stddef.h>
#include <stdint.h>
#include <vector>
#include "base/memory/ref_counted.h"
#include "mojo/public/cpp/bindings/associated_interface_ptr_info.h"
#include "mojo/public/cpp/bindings/interface_ptr.h"
#include "mojo/public/cpp/bindings/lib/bindings_internal.h"
#include "mojo/public/cpp/system/core.h"
namespace mojo {
namespace internal {
class MultiplexRouter;
// Please note that this is a different value than |mojo::kInvalidHandleValue|,
// which is the "decoded" invalid handle.
const MojoHandle kEncodedInvalidHandleValue = static_cast<MojoHandle>(-1);
size_t Align(size_t size);
char* AlignPointer(char* ptr);
bool IsAligned(const void* ptr);
// Pointers are encoded as relative offsets. The offsets are relative to the
// address of where the offset value is stored, such that the pointer may be
// recovered with the expression:
//
// ptr = reinterpret_cast<char*>(offset) + *offset
//
// A null pointer is encoded as an offset value of 0.
//
void EncodePointer(const void* ptr, uint64_t* offset);
// Note: This function doesn't validate the encoded pointer value.
const void* DecodePointerRaw(const uint64_t* offset);
// Note: This function doesn't validate the encoded pointer value.
template <typename T>
inline void DecodePointer(const uint64_t* offset, T** ptr) {
*ptr = reinterpret_cast<T*>(const_cast<void*>(DecodePointerRaw(offset)));
}
// Handles are encoded as indices into a vector of handles. These functions
// manipulate the value of |handle|, mapping it to and from an index.
void EncodeHandle(Handle* handle, std::vector<Handle>* handles);
void EncodeHandle(Interface_Data* data, std::vector<Handle>* handles);
void EncodeHandle(MojoHandle* handle, std::vector<Handle>* handles);
// Note: The following three functions don't validate the encoded handle value.
void DecodeHandle(Handle* handle, std::vector<Handle>* handles);
void DecodeHandle(Interface_Data* data, std::vector<Handle>* handles);
void DecodeHandle(MojoHandle* handle, std::vector<Handle>* handles);
// The following 2 functions are used to encode/decode all objects (structs and
// arrays) in a consistent manner.
template <typename T>
inline void Encode(T* obj, std::vector<Handle>* handles) {
if (obj->ptr)
obj->ptr->EncodePointersAndHandles(handles);
EncodePointer(obj->ptr, &obj->offset);
}
// Note: This function doesn't validate the encoded pointer and handle values.
template <typename T>
inline void Decode(T* obj, std::vector<Handle>* handles) {
DecodePointer(&obj->offset, &obj->ptr);
if (obj->ptr)
obj->ptr->DecodePointersAndHandles(handles);
}
template <typename T>
inline void InterfacePointerToData(InterfacePtr<T> input,
Interface_Data* output) {
InterfacePtrInfo<T> info = input.PassInterface();
output->handle = info.PassHandle().release();
output->version = info.version();
}
template <typename T>
inline void InterfaceDataToPointer(Interface_Data* input,
InterfacePtr<T>* output) {
output->Bind(InterfacePtrInfo<T>(
MakeScopedHandle(FetchAndReset(&input->handle)), input->version));
}
template <typename T>
inline void AssociatedInterfacePtrInfoToData(
AssociatedInterfacePtrInfo<T> input,
AssociatedInterface_Data* output) {
output->version = input.version();
output->interface_id =
AssociatedInterfacePtrInfoHelper::PassHandle(&input).release();
}
template <typename T>
inline void AssociatedInterfaceDataToPtrInfo(
AssociatedInterface_Data* input,
AssociatedInterfacePtrInfo<T>* output,
MultiplexRouter* router) {
AssociatedInterfacePtrInfoHelper::SetHandle(
output,
router->CreateLocalEndpointHandle(FetchAndReset(&input->interface_id)));
output->set_version(input->version);
}
// Context information for serialization/deserialization routines.
struct SerializationContext {
SerializationContext();
explicit SerializationContext(scoped_refptr<MultiplexRouter> in_router);
~SerializationContext();
// Used to serialize/deserialize associated interface pointers and requests.
scoped_refptr<MultiplexRouter> router;
};
} // namespace internal
} // namespace mojo
#endif // MOJO_PUBLIC_CPP_BINDINGS_LIB_BINDINGS_SERIALIZATION_H_
|
