Quelle  EventDispatcher.h

/* 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_widget_EventDispatcher_h
#define mozilla_widget_EventDispatcher_h

#include "mozilla/java/EventDispatcherNatives.h"
#include "mozilla/widget/EventDispatcherBase.h"

namespace mozilla::widget {

/**
 * EventDispatcher is the Gecko counterpart to the Java EventDispatcher class.
 * Together, they make up a unified event bus. Events dispatched from the Java
 * side may notify event listeners on the Gecko side, and vice versa.
 */
class EventDispatcher final
    : public EventDispatcherBase,
      public java::EventDispatcher::Natives<EventDispatcher> {
  using NativesBase = java::EventDispatcher::Natives<EventDispatcher>;

 public:
  void Attach(java::EventDispatcher::Param aDispatcher);
  void Detach();

  void Activate();

  using EventDispatcherBase::HasGeckoListener;
  bool HasGeckoListener(jni::String::Param aEvent) {
    return EventDispatcherBase::HasGeckoListener(aEvent->ToString());
  }

  using EventDispatcherBase::DispatchToGecko;
  void DispatchToGecko(jni::String::Param aEvent, jni::Object::Param aData,
                       jni::Object::Param aCallback);

  bool HasEmbedderListener(const nsAString& aEvent) override
      MOZ_REQUIRES(sMainThreadCapability);
  nsresult DispatchToEmbedder(JSContext* aCx, const nsAString& aEvent,
                              JS::Handle<JS::Value> aData,
                              nsIGeckoViewEventCallback* aCallback) override
      MOZ_REQUIRES(sMainThreadCapability);

  static nsresult UnboxBundle(JSContext* aCx, jni::Object::Param aData,
                              JS::MutableHandle<JS::Value> aOut);

 private:
  friend class java::EventDispatcher::Natives<EventDispatcher>;

  virtual ~EventDispatcher() = default;

  // NOTE: Can be called from any thread.
  void Shutdown() { mIsShutdown = true; };

  // Gets a LocalRef to the dispatcher. Returns `nullptr` if `mIsShutdown` has
  // been set (e.g. by the Java code).
  java::EventDispatcher::LocalRef GetDispatcher()
      MOZ_REQUIRES(sMainThreadCapability) {
    return mIsShutdown ? nullptr : mDispatcher;
  }

  std::atomic<bool> mIsShutdown{false};
  java::EventDispatcher::WeakRef mDispatcher
      MOZ_GUARDED_BY(sMainThreadCapability);
};

}  // namespace mozilla::widget

#endif  // mozilla_widget_EventDispatcher_h