// // Copyright Aliaksei Levin (levlam@telegram.org), Arseny Smirnov (arseny30@gmail.com) 2014-2024 // // Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // #pragma once #include "td/actor/impl/Actor-decl.h" #include "td/actor/impl/ActorId-decl.h" #include "td/actor/impl/EventFull-decl.h" #include "td/utils/Closure.h" #include "td/utils/common.h" #include "td/utils/FlatHashMap.h" #include "td/utils/Heap.h" #include "td/utils/List.h" #include "td/utils/logging.h" #include "td/utils/MovableValue.h" #include "td/utils/MpscPollableQueue.h" #include "td/utils/ObjectPool.h" #include "td/utils/port/detail/PollableFd.h" #include "td/utils/port/Poll.h" #include "td/utils/port/PollFlags.h" #include "td/utils/port/thread_local.h" #include "td/utils/Promise.h" #include "td/utils/Slice.h" #include "td/utils/Time.h" #include "td/utils/type_traits.h" #include #include #include #include namespace td { extern int VERBOSITY_NAME(actor); class ActorInfo; enum class ActorSendType { Immediate, Later }; class Scheduler; class SchedulerGuard { public: explicit SchedulerGuard(Scheduler *scheduler, bool lock = true); ~SchedulerGuard(); SchedulerGuard(const SchedulerGuard &) = delete; SchedulerGuard &operator=(const SchedulerGuard &) = delete; SchedulerGuard(SchedulerGuard &&) = default; SchedulerGuard &operator=(SchedulerGuard &&) = delete; private: MovableValue is_valid_ = true; bool is_locked_; Scheduler *scheduler_; ActorContext *save_context_; Scheduler *save_scheduler_; const char *save_tag_; }; class Scheduler { public: class Callback { public: Callback() = default; Callback(const Callback &) = delete; Callback &operator=(const Callback &) = delete; virtual ~Callback() = default; virtual void on_finish() = 0; virtual void register_at_finish(std::function) = 0; }; Scheduler() = default; Scheduler(const Scheduler &) = delete; Scheduler &operator=(const Scheduler &) = delete; Scheduler(Scheduler &&) = delete; Scheduler &operator=(Scheduler &&) = delete; ~Scheduler(); void init(int32 id, std::vector>> outbound, Callback *callback); int32 sched_id() const; int32 sched_count() const; template TD_WARN_UNUSED_RESULT ActorOwn create_actor(Slice name, Args &&...args); template TD_WARN_UNUSED_RESULT ActorOwn create_actor_on_scheduler(Slice name, int32 sched_id, Args &&...args); template TD_WARN_UNUSED_RESULT ActorOwn register_actor(Slice name, ActorT *actor_ptr, int32 sched_id = -1); template TD_WARN_UNUSED_RESULT ActorOwn register_actor(Slice name, unique_ptr actor_ptr, int32 sched_id = -1); template TD_WARN_UNUSED_RESULT ActorOwn register_existing_actor(unique_ptr actor_ptr); void send_to_scheduler(int32 sched_id, const ActorId<> &actor_id, Event &&event); void send_to_other_scheduler(int32 sched_id, const ActorId<> &actor_id, Event &&event); void run_on_scheduler(int32 sched_id, Promise action); // TODO Action template void destroy_on_scheduler(int32 sched_id, T &value); template void destroy_on_scheduler(int32 sched_id, ArgsT &...values); template void send_lambda(ActorRef actor_ref, EventT &&lambda); template void send_closure(ActorRef actor_ref, EventT &&closure); template void send(ActorRef actor_ref, Event &&event); void before_tail_send(const ActorId<> &actor_id); static void subscribe(PollableFd fd, PollFlags flags = PollFlags::ReadWrite()); static void unsubscribe(PollableFdRef fd); static void unsubscribe_before_close(PollableFdRef fd); void yield_actor(Actor *actor); void stop_actor(Actor *actor); void do_stop_actor(Actor *actor); uint64 get_link_token(Actor *actor); void migrate_actor(Actor *actor, int32 dest_sched_id); void do_migrate_actor(Actor *actor, int32 dest_sched_id); void start_migrate_actor(Actor *actor, int32 dest_sched_id); void finish_migrate_actor(Actor *actor); double get_actor_timeout(const Actor *actor) const; void set_actor_timeout_in(Actor *actor, double timeout); void set_actor_timeout_at(Actor *actor, double timeout_at); void cancel_actor_timeout(Actor *actor); void finish(); void yield(); void run(Timestamp timeout); void run_no_guard(Timestamp timeout); void wakeup(); static Scheduler *instance(); static ActorContext *&context(); static void on_context_updated(); SchedulerGuard get_guard(); SchedulerGuard get_const_guard(); Timestamp get_timeout(); private: static void set_scheduler(Scheduler *scheduler); void destroy_on_scheduler_impl(int32 sched_id, Promise action); class ServiceActor final : public Actor { public: void set_queue(std::shared_ptr> queues); private: std::shared_ptr> inbound_; bool subscribed_{false}; void start_up() final; void loop() final; void tear_down() final; }; friend class ServiceActor; void clear(); void do_event(ActorInfo *actor, Event &&event); void enter_actor(ActorInfo *actor_info); void exit_actor(ActorInfo *actor_info); void yield_actor(ActorInfo *actor_info); void stop_actor(ActorInfo *actor_info); void do_stop_actor(ActorInfo *actor_info); uint64 get_link_token(ActorInfo *actor_info); void migrate_actor(ActorInfo *actor_info, int32 dest_sched_id); void do_migrate_actor(ActorInfo *actor_info, int32 dest_sched_id); void start_migrate_actor(ActorInfo *actor_info, int32 dest_sched_id); double get_actor_timeout(const ActorInfo *actor_info) const; void set_actor_timeout_in(ActorInfo *actor_info, double timeout); void set_actor_timeout_at(ActorInfo *actor_info, double timeout_at); void cancel_actor_timeout(ActorInfo *actor_info); void register_migrated_actor(ActorInfo *actor_info); void add_to_mailbox(ActorInfo *actor_info, Event &&event); void clear_mailbox(ActorInfo *actor_info); template void flush_mailbox(ActorInfo *actor_info, const RunFuncT &run_func, const EventFuncT &event_func); template void send_impl(const ActorId<> &actor_id, const RunFuncT &run_func, const EventFuncT &event_func); Timestamp run_timeout(); void run_mailbox(); Timestamp run_events(Timestamp timeout); void run_poll(Timestamp timeout); template ActorOwn register_actor_impl(Slice name, ActorT *actor_ptr, Actor::Deleter deleter, int32 sched_id); void destroy_actor(ActorInfo *actor_info); static TD_THREAD_LOCAL Scheduler *scheduler_; static TD_THREAD_LOCAL ActorContext *context_; Callback *callback_ = nullptr; unique_ptr> actor_info_pool_; int32 actor_count_ = 0; ListNode pending_actors_list_; ListNode ready_actors_list_; KHeap timeout_queue_; FlatHashMap> pending_events_; ServiceActor service_actor_; Poll poll_; bool yield_flag_ = false; bool has_guard_ = false; bool close_flag_ = false; int32 sched_id_ = 0; int32 sched_n_ = 0; std::shared_ptr> inbound_queue_; std::vector>> outbound_queues_; std::shared_ptr save_context_; struct EventContext { int32 dest_sched_id{0}; enum Flags { Stop = 1, Migrate = 2 }; int32 flags{0}; uint64 link_token{0}; ActorInfo *actor_info{nullptr}; }; EventContext *event_context_ptr_{nullptr}; friend class GlobalScheduler; friend class SchedulerGuard; friend class EventGuard; }; /*** Interface to current scheduler ***/ template TD_WARN_UNUSED_RESULT ActorOwn create_actor(Slice name, Args &&...args); template TD_WARN_UNUSED_RESULT ActorOwn create_actor_on_scheduler(Slice name, int32 sched_id, Args &&...args); template TD_WARN_UNUSED_RESULT ActorOwn register_actor(Slice name, ActorT *actor_ptr, int32 sched_id = -1); template TD_WARN_UNUSED_RESULT ActorOwn register_actor(Slice name, unique_ptr actor_ptr, int32 sched_id = -1); template TD_WARN_UNUSED_RESULT ActorOwn register_existing_actor(unique_ptr actor_ptr); template void send_closure(ActorIdT &&actor_id, FunctionT function, ArgsT &&...args) { using ActorT = typename std::decay_t::ActorT; using FunctionClassT = member_function_class_t; static_assert(std::is_base_of::value, "unsafe send_closure"); Scheduler::instance()->send_closure( std::forward(actor_id), create_immediate_closure(function, std::forward(args)...)); } template void send_closure_later(ActorIdT &&actor_id, FunctionT function, ArgsT &&...args) { using ActorT = typename std::decay_t::ActorT; using FunctionClassT = member_function_class_t; static_assert(std::is_base_of::value, "unsafe send_closure"); Scheduler::instance()->send(std::forward(actor_id), Event::delayed_closure(function, std::forward(args)...)); } template void send_lambda(ActorRef actor_ref, ArgsT &&...args) { Scheduler::instance()->send_lambda(actor_ref, std::forward(args)...); } template void send_event(ActorRef actor_ref, ArgsT &&...args) { Scheduler::instance()->send(actor_ref, std::forward(args)...); } template void send_event_later(ActorRef actor_ref, ArgsT &&...args) { Scheduler::instance()->send(actor_ref, std::forward(args)...); } } // namespace td