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
|
/* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* vim: set ts=8 sts=2 et sw=2 tw=80: */
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
#ifndef mozilla_dom_SharedMessageBody_h
#define mozilla_dom_SharedMessageBody_h
#include "mozilla/Maybe.h"
#include "mozilla/dom/ipc/StructuredCloneData.h"
namespace mozilla {
namespace ipc {
class PBackgroundChild;
}
namespace dom {
class MessagePort;
class RefMessageBody;
class RefMessageBodyService;
class SharedMessageBody final {
public:
NS_INLINE_DECL_REFCOUNTING(SharedMessageBody)
SharedMessageBody(
StructuredCloneHolder::TransferringSupport aSupportsTransferring,
const Maybe<nsID>& aAgentClusterId);
// Note that the populated MessageData borrows the underlying
// JSStructuredCloneData from the SharedMessageBody, so the caller is
// required to ensure that the MessageData instances are destroyed prior to
// the SharedMessageBody instances.
static void FromSharedToMessageChild(
mozilla::ipc::PBackgroundChild* aBackgroundManager,
SharedMessageBody* aData, MessageData& aMessage);
static void FromSharedToMessagesChild(
mozilla::ipc::PBackgroundChild* aBackgroundManager,
const nsTArray<RefPtr<SharedMessageBody>>& aData,
nsTArray<MessageData>& aArray);
// Const MessageData.
static already_AddRefed<SharedMessageBody> FromMessageToSharedChild(
MessageData& aMessage,
StructuredCloneHolder::TransferringSupport aSupportsTransferring =
StructuredCloneHolder::TransferringSupported);
// Non-const MessageData.
static already_AddRefed<SharedMessageBody> FromMessageToSharedChild(
const MessageData& aMessage,
StructuredCloneHolder::TransferringSupport aSupportsTransferring =
StructuredCloneHolder::TransferringSupported);
// Array of MessageData objects
static bool FromMessagesToSharedChild(
nsTArray<MessageData>& aArray,
FallibleTArray<RefPtr<SharedMessageBody>>& aData,
StructuredCloneHolder::TransferringSupport aSupportsTransferring =
StructuredCloneHolder::TransferringSupported);
// Note that the populated MessageData borrows the underlying
// JSStructuredCloneData from the SharedMessageBody, so the caller is
// required to ensure that the MessageData instances are destroyed prior to
// the SharedMessageBody instances.
static bool FromSharedToMessagesParent(
mozilla::ipc::PBackgroundParent* aManager,
const nsTArray<RefPtr<SharedMessageBody>>& aData,
nsTArray<MessageData>& aArray);
static already_AddRefed<SharedMessageBody> FromMessageToSharedParent(
MessageData& aMessage,
StructuredCloneHolder::TransferringSupport aSupportsTransferring =
StructuredCloneHolder::TransferringSupported);
static bool FromMessagesToSharedParent(
nsTArray<MessageData>& aArray,
FallibleTArray<RefPtr<SharedMessageBody>>& aData,
StructuredCloneHolder::TransferringSupport aSupportsTransferring =
StructuredCloneHolder::TransferringSupported);
enum ReadMethod {
StealRefMessageBody,
KeepRefMessageBody,
};
void Read(JSContext* aCx, JS::MutableHandle<JS::Value> aValue,
RefMessageBodyService* aRefMessageBodyService,
ReadMethod aReadMethod, ErrorResult& aRv);
void Write(JSContext* aCx, JS::Handle<JS::Value> aValue,
JS::Handle<JS::Value> aTransfers, nsID& aPortID,
RefMessageBodyService* aRefMessageBodyService, ErrorResult& aRv);
bool TakeTransferredPortsAsSequence(
Sequence<OwningNonNull<mozilla::dom::MessagePort>>& aPorts);
private:
~SharedMessageBody() = default;
UniquePtr<ipc::StructuredCloneData> mCloneData;
RefPtr<RefMessageBody> mRefData;
Maybe<nsID> mRefDataId;
const StructuredCloneHolder::TransferringSupport mSupportsTransferring;
const Maybe<nsID> mAgentClusterId;
};
} // namespace dom
} // namespace mozilla
#endif // mozilla_dom_SharedMessageBody_h
|
