src/node_diagnostics_channel.h - main - githubmirror/node

src/node_diagnostics_channel.h
112 строк3 KB
Stephen Belanger
diagnostics_channel: grow native channel storage
22 июл 2026, 06:40
22 июл 2026, 06:40594d0c5
#ifndef SRC_NODE_DIAGNOSTICS_CHANNEL_H_
#define SRC_NODE_DIAGNOSTICS_CHANNEL_H_

#if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#include <cinttypes>
#include <string>
#include <unordered_map>
#include <vector>
#include "aliased_buffer.h"
#include "base_object.h"
#include "node_snapshotable.h"

namespace node {
class ExternalReferenceRegistry;

namespace diagnostics_channel {

class Channel;

class BindingData : public SnapshotableObject {
 public:
  static constexpr size_t kInitialChannelCapacity = 1024;

  struct InternalFieldInfo : public node::InternalFieldInfoBase {
    AliasedBufferIndex subscribers;
    size_t subscribers_capacity;
  };

  BindingData(Realm* realm,
              v8::Local<v8::Object> wrap,
              InternalFieldInfo* info = nullptr);

  SERIALIZABLE_OBJECT_METHODS()
  SET_BINDING_ID(diagnostics_channel_binding_data)

  void MemoryInfo(MemoryTracker* tracker) const override;
  SET_SELF_SIZE(BindingData)
  SET_MEMORY_INFO_NAME(BindingData)

  AliasedUint32Array subscribers_;

  uint32_t next_channel_index_ = 0;
  std::unordered_map<std::string, uint32_t> channel_indices_;

  uint32_t GetOrCreateChannelIndex(const std::string& name);

  v8::Global<v8::Function> link_callback_;
  v8::Global<v8::FunctionTemplate> channel_wrap_template_;
  std::vector<BaseObjectPtr<Channel>> channels_;

  static void LinkNativeChannel(
      const v8::FunctionCallbackInfo<v8::Value>& args);

  static void CreatePerIsolateProperties(IsolateData* isolate_data,
                                         v8::Local<v8::ObjectTemplate> target);
  static void CreatePerContextProperties(v8::Local<v8::Object> target,
                                         v8::Local<v8::Value> unused,
                                         v8::Local<v8::Context> context,
                                         void* priv);
  static void RegisterExternalReferences(ExternalReferenceRegistry* registry);

 private:
  InternalFieldInfo* internal_field_info_ = nullptr;
};

class Channel : public BaseObject {
 public:
  // Public for MakeDetachedBaseObject.
  Channel(Environment* env,
          v8::Local<v8::Object> wrap,
          BindingData* binding_data,
          uint32_t index,
          std::string name);

  // Returns a non-owning pointer. Lifetime is managed by BindingData.
  static Channel* Get(Environment* env, const char* name);

  inline bool HasSubscribers() const {
    return binding_data_ != nullptr && binding_data_->subscribers_[index_] > 0;
  }

  void Publish(Environment* env, v8::Local<v8::Value> message);

  void Link(v8::Isolate* isolate, v8::Local<v8::Object> js_channel);

  inline bool IsLinked() const { return !js_channel_.IsEmpty(); }

  void Unlink();

  void MemoryInfo(MemoryTracker* tracker) const override;
  SET_MEMORY_INFO_NAME(Channel)
  SET_SELF_SIZE(Channel)

 private:
  friend class BindingData;

  void CachePublishFn(v8::Isolate* isolate, v8::Local<v8::Object> js_channel);

  BindingData* binding_data_;
  uint32_t index_;
  std::string name_;
  v8::Global<v8::Object> js_channel_;
  v8::Global<v8::Function> publish_fn_;
};

}  // namespace diagnostics_channel
}  // namespace node

#endif  // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS

#endif  // SRC_NODE_DIAGNOSTICS_CHANNEL_H_