Files
sdk/runtime/vm/native_message_handler.h
T
Vyacheslav Egorov e2efffa005 [vm] Simplify implementation of native ports
This reland commit 5a32d8bc7c with a fix
for thread leak (Issue #56717): when `ThreadPool` is shutting down
asynchronously the last worker should detach itself to prevent
leaking associated low-level data structures, because no thread will
join it.

A hang in service isolate shutdown (caused by an existing bug) was fixed by commit 157a0dc7f9.

This CL turns native ports into a thin abstraction over underlying
thread pool instead of building them as full fledged MessageHandler.

This allows to easily implement a variation of native ports which can
handle messages concurrently with the given degree of concurrency.
This type of port can be used to greatly simplify implementation of
IOService - which previously had to do its own concurrency management
on top of "single threaded" native ports. This capability is exposed
as `Dart_NewConcurrentNativePort` API.

The new implementation is in general much cleaner then the old one
with one exception: `Dart_CloseNativePort` API has unfortunate design
where underlying message handler is destroyed asynchronously and
`Dart_CloseNativePort` returns immediately without waiting for pending
tasks to complete. Implementing this on top of `ThreadPool` requires
some changes to thread pool implementation.

Issue https://github.com/dart-lang/sdk/issues/55844

Closes https://github.com/dart-lang/sdk/issues/56717

TEST=ci

Change-Id: Ic68bfb60757685afd75c80a70cdec66cc13c149b
Reviewed-on: https://dart-review.googlesource.com/c/sdk/+/385000
Reviewed-by: Martin Kustermann <kustermann@google.com>
Commit-Queue: Slava Egorov <vegorov@google.com>
2024-09-12 15:16:12 +00:00

70 lines
2.2 KiB
C++

// Copyright (c) 2012, 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_NATIVE_MESSAGE_HANDLER_H_
#define RUNTIME_VM_NATIVE_MESSAGE_HANDLER_H_
#include <memory>
#include "include/dart_api.h"
#include "include/dart_native_api.h"
#include "vm/message_handler.h"
namespace dart {
// A NativeMessageHandler accepts messages and dispatches them to
// native C handlers on worker threads. It will spawn up to
// |max_concurrency| worker threads which will handle incomming messages
// concurrently.
class NativeMessageHandler final : public PortHandler {
public:
NativeMessageHandler(const char* name,
Dart_NativeMessageHandler func,
intptr_t max_concurrency);
~NativeMessageHandler() override;
const char* name() const override { return name_.get(); }
Dart_NativeMessageHandler func() const { return func_; }
#if defined(DEBUG)
// Check that it is safe to access this handler.
void CheckAccess() const override;
#endif
void OnPortClosed(Dart_Port port) override {}
Isolate* isolate() const override { return nullptr; }
// Posts a message on this handler's message queue.
// If before_events is true, then the message is enqueued before any pending
// events, but after any pending isolate library events.
void PostMessage(std::unique_ptr<Message> message,
bool before_events = false) override;
// Request deletion of the given handler once it is down with the currently
// running Dart_NativeMessageHandler callbacks. No new callbacks will be
// scheduled after this call.
//
// Note: |handler| might be deleted synchronously if no callback is running,
// or it can be deleted later on a worker thread.
static void RequestDeletion(NativeMessageHandler* handler);
void Shutdown() override;
private:
PortSet<PortSetEntry>* ports(PortMap::Locker& locker) override {
return nullptr;
}
CStringUniquePtr name_;
const Dart_NativeMessageHandler func_;
ThreadPool pool_;
};
} // namespace dart
#endif // RUNTIME_VM_NATIVE_MESSAGE_HANDLER_H_