在 AS3 中分派事件时合适的形式是什么？

Question

我想知道创建自定义事件时合适的形式是什么？应该创建一个 CustomEvent 类，然后在函数中创建一个临时调度程序，并调度 CustomEvent。或者最好尝试创建 CustomEventDispatcher 类，并将 CustomEvent 类创建为该类的内部类，例如：

package
{

   public class CustomEventDispatcher extends EventDispatcher
   {
     public function CustomEventDispatcher()
     {
       super(new CustomEvent());
     }

   }
}

class CustomEvent
{
   public function CustomEvent(type:String, bubbles:Boolean=false, cancelable:Boolean=false)
   {
      super(type, bubbles, cancelable)
   }                                               
}

Answer 1

单方面来说，最好让事件公开。通过这种方式，您可以输入侦听器（有利于代码提示和调试），并使事件具有公共静态 const 类型（您也可能想要查看）。

Answer 2

在构思事件机制时，有两个基本问题需要回答。

1) 如何为我的事件创建调度程序实例？

一般选项是：扩展EventDispatcher，或聚合调度程序实例。

最基本和常见的做法（官方文档也指出了这一点）是扩展 EventDispatcher 类，从而为您的类提供事件调度功能。

优点：易于实现——只需输入 extends EventDispatcher 即可完成。

缺点：你不能扩展其他东西。显然，这就是为什么许多本机类是 EventDispatcher 的孙子类的原因。我想只是为了免去我们的麻烦。

第二种通用​​方法是聚合调度程序实例。

package
{
    import flash.events.Event;
    import flash.events.EventDispatcher;
    import flash.events.IEventDispatcher;

    public class ClassA implements IEventDispatcher
    {
        private var dispatcher:EventDispatcher;

        public function ClassA()
        {
            initialize();
        }

        private function initialize():void
        {
            dispatcher = new EventDispatcher(this);
        }

        public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
        {
            dispatcher.addEventListener(type, listener, useCapture, priority, useWeakReference);
        }

        public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
        {
            dispatcher.removeEventListener(type, listener, useCapture);
        }

        public function dispatchEvent(event:Event):Boolean
        {
            return dispatcher.dispatchEvent(event);
        }

        public function hasEventListener(type:String):Boolean
        {
            return dispatcher.hasEventListener(type);
        }

        public function willTrigger(type:String):Boolean
        {
            return dispatcher.willTrigger(type);
        }
    }
}

注意：我们将对聚合类的引用传递给调度程序构造函数。
这样做是为了使 event.target 引用您的类实例而不是调度程序实例本身。

优点：您可以自由扩展任何您喜欢的内容。您可以使用调度程序挂钩执行一些技巧，例如维护侦听器列表或类似的操作。

缺点：不像第一种方法那么简单。

2) 如何通过我的事件传递自定义数据？

一般选项是：在事件实例中传递数据，或者仅在事件处理程序中使用 event.target 引用来访问源中的某些数据。

如果您选择通过 event.target 访问所有必需的数据 - 不需要额外的工作，只需将此事件处理程序中的引用转换为适当的类即可。

如果您想随事件一起传递一些数据，则可以对 Event 进行子类化，并且该类应该对处理事件的代码公开可见，如上面的答案所述。 AS3 是关于严格和强类型的，所以你为什么要抗拒呢？

仅当您要重新分派已处理的事件时，才需要重写 Event 子类中的 clone() 方法。官方文档说，为了安全起见，每次创建自定义事件类时都必须这样做。

Answer 3

不要忘记覆盖克隆。重写 toString 进行调试也是一个好主意。

这是我的一个自定义事件的示例：

package com.mattie.events
{
//Imports
import flash.events.Event;

//Class
public class SearchFieldEvent extends Event
    {
    //Constants
    public static const SEARCH_COMPLETE:String = "search complete";

    //Variables
    public var totalResults:uint;
    public var duration:uint;
    public var searchText:String;

    //Constructor
    public function SearchFieldEvent(type:String, totalResults:uint = 0, duration:uint = 0, searchText:String = "") 
        {
        super(type);

        this.totalResults = totalResults;
        this.duration = duration;
        this.searchText = searchText;
        }

    //Override clone
    public override function clone():Event
        {
        return new SearchFieldEvent(type, totalResults, duration, searchText);
        }

    //Override toString
    public override function toString():String
        {
        return formatToString("SearchFieldEvent", "type", "totalResults", "duration", "searchText");
        }
    }
}