mirror of
https://github.com/dart-lang/sdk
synced 2024-09-05 00:13:50 +00:00
![Samir Jindel](/assets/img/avatar_default.png)
Please see go/dart-ffi-callbacks for design context and motivation. Change-Id: Ie5edcb8837157c679954a670fb19d545e22fec69 Cq-Include-Trybots: luci.dart.try:vm-kernel-linux-debug-simdbc64-try, vm-kernel-linux-release-simdbc64-try, vm-kernel-mac-debug-simdbc64-try, vm-kernel-mac-release-simdbc64-try, vm-kernel-reload-mac-debug-simdbc64-try, vm-kernel-reload-mac-release-simdbc64-try, vm-kernel-linux-debug-ia32-try, vm-dartkb-linux-debug-simarm64-try, vm-kernel-win-debug-ia32-try, vm-ffi-android-debug-arm-try Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/101828 Commit-Queue: Samir Jindel <sjindel@google.com> Reviewed-by: Aart Bik <ajcbik@google.com> Reviewed-by: Daco Harkes <dacoharkes@google.com>
171 lines
4.3 KiB
C++
171 lines
4.3 KiB
C++
// Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file
|
|
// for details. All rights reserved. Use of this source code is governed by a
|
|
// BSD-style license that can be found in the LICENSE file.
|
|
|
|
#ifndef RUNTIME_VM_MESSAGE_H_
|
|
#define RUNTIME_VM_MESSAGE_H_
|
|
|
|
#include <memory>
|
|
#include <utility>
|
|
|
|
#include "platform/assert.h"
|
|
#include "vm/allocation.h"
|
|
#include "vm/finalizable_data.h"
|
|
#include "vm/globals.h"
|
|
|
|
// Duplicated from dart_api.h to avoid including the whole header.
|
|
typedef int64_t Dart_Port;
|
|
|
|
namespace dart {
|
|
|
|
class JSONStream;
|
|
class RawObject;
|
|
|
|
class Message {
|
|
public:
|
|
typedef enum {
|
|
kNormalPriority = 0, // Deliver message when idle.
|
|
kOOBPriority = 1, // Deliver message asap.
|
|
|
|
// Iteration.
|
|
kFirstPriority = 0,
|
|
kNumPriorities = 2,
|
|
} Priority;
|
|
|
|
// Values defining the type of OOB messages. OOB messages can only be
|
|
// fixed length arrays where the first element is a Smi with one of the
|
|
// valid values below.
|
|
typedef enum {
|
|
kIllegalOOB = 0,
|
|
kServiceOOBMsg = 1,
|
|
kIsolateLibOOBMsg = 2,
|
|
kDelayedIsolateLibOOBMsg = 3,
|
|
} OOBMsgTag;
|
|
|
|
// A port number which is never used.
|
|
static const Dart_Port kIllegalPort;
|
|
|
|
// A new message to be sent between two isolates. The data handed to this
|
|
// message will be disposed by calling free() once the message object is
|
|
// being destructed (after delivery or when the receiving port is closed).
|
|
Message(Dart_Port dest_port,
|
|
uint8_t* snapshot,
|
|
intptr_t snapshot_length,
|
|
MessageFinalizableData* finalizable_data,
|
|
Priority priority,
|
|
Dart_Port delivery_failure_port = kIllegalPort);
|
|
|
|
// Message objects can also carry RawObject pointers for Smis and objects in
|
|
// the VM heap. This is indicated by setting the len_ field to 0.
|
|
Message(Dart_Port dest_port,
|
|
RawObject* raw_obj,
|
|
Priority priority,
|
|
Dart_Port delivery_failure_port = kIllegalPort);
|
|
|
|
~Message();
|
|
|
|
template <typename... Args>
|
|
static std::unique_ptr<Message> New(Args&&... args) {
|
|
return std::unique_ptr<Message>(new Message(std::forward<Args>(args)...));
|
|
}
|
|
|
|
Dart_Port dest_port() const { return dest_port_; }
|
|
|
|
uint8_t* snapshot() const {
|
|
ASSERT(!IsRaw());
|
|
return snapshot_;
|
|
}
|
|
intptr_t snapshot_length() const { return snapshot_length_; }
|
|
|
|
MessageFinalizableData* finalizable_data() { return finalizable_data_; }
|
|
|
|
intptr_t Size() const {
|
|
intptr_t size = snapshot_length_;
|
|
if (finalizable_data_ != NULL) {
|
|
size += finalizable_data_->external_size();
|
|
}
|
|
return size;
|
|
}
|
|
|
|
RawObject* raw_obj() const {
|
|
ASSERT(IsRaw());
|
|
return reinterpret_cast<RawObject*>(snapshot_);
|
|
}
|
|
Priority priority() const { return priority_; }
|
|
|
|
bool IsOOB() const { return priority_ == Message::kOOBPriority; }
|
|
bool IsRaw() const { return snapshot_length_ == 0; }
|
|
|
|
bool RedirectToDeliveryFailurePort();
|
|
|
|
intptr_t Id() const;
|
|
|
|
static const char* PriorityAsString(Priority priority);
|
|
|
|
private:
|
|
friend class MessageQueue;
|
|
|
|
Message* next_;
|
|
Dart_Port dest_port_;
|
|
Dart_Port delivery_failure_port_;
|
|
uint8_t* snapshot_;
|
|
intptr_t snapshot_length_;
|
|
MessageFinalizableData* finalizable_data_;
|
|
Priority priority_;
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(Message);
|
|
};
|
|
|
|
// There is a message queue per isolate.
|
|
class MessageQueue {
|
|
public:
|
|
MessageQueue();
|
|
~MessageQueue();
|
|
|
|
void Enqueue(std::unique_ptr<Message> msg, bool before_events);
|
|
|
|
// Gets the next message from the message queue or NULL if no
|
|
// message is available. This function will not block.
|
|
std::unique_ptr<Message> Dequeue();
|
|
|
|
bool IsEmpty() { return head_ == NULL; }
|
|
|
|
// Clear all messages from the message queue.
|
|
void Clear();
|
|
|
|
// Iterator class.
|
|
class Iterator : public ValueObject {
|
|
public:
|
|
explicit Iterator(const MessageQueue* queue);
|
|
virtual ~Iterator();
|
|
|
|
void Reset(const MessageQueue* queue);
|
|
|
|
// Returns false when there are no more messages left.
|
|
bool HasNext();
|
|
|
|
// Returns the current message and moves forward.
|
|
Message* Next();
|
|
|
|
private:
|
|
Message* next_;
|
|
};
|
|
|
|
intptr_t Length() const;
|
|
|
|
// Returns the message with id or NULL.
|
|
Message* FindMessageById(intptr_t id);
|
|
|
|
void PrintJSON(JSONStream* stream);
|
|
|
|
private:
|
|
Message* head_;
|
|
Message* tail_;
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(MessageQueue);
|
|
};
|
|
|
|
} // namespace dart
|
|
|
|
#endif // RUNTIME_VM_MESSAGE_H_
|