ListenerBus 事件总线

ListenerBus 事件总线

ListenerBus可以接收事件并将事件送到对应的事件监听器

源码清单和我的理解注释

ListenerBus源码中第一行，创建了一个线程安全的ArrayList——CopyOnWriteArrayList，之后添加、者删除事件等操作都在这个线程安全的ArrayList中执行

private[spark] val listeners = new CopyOnWriteArrayList[L]

private[spark] trait ListenerBus[L <: AnyRef, E] extends Logging {

  // 创建一个线程安全的ArrayList
  private[spark] val listeners = new CopyOnWriteArrayList[L]

  /**
   * 往CopyOnWriteArrayList中添加监听器
   */
  final def addListener(listener: L): Unit = {
    listeners.add(listener)
  }

  /**
   * 在CopyOnWriteArrayList删除监听器
   */
  final def removeListener(listener: L): Unit = {
    listeners.remove(listener)
  }

  /**
   * 把事件发送到CopyOnWriteArrayList中所有的监听器
   * 但这个方法不是线程安全的，对此方法的调用要在同一线程中
   */
  def postToAll(event: E): Unit = {
    val iter = listeners.iterator
    while (iter.hasNext) {
      val listener = iter.next()
      try {
        doPostEvent(listener, event)
      } catch {
        case NonFatal(e) =>
          logError(s"Listener ${Utils.getFormattedClassName(listener)} threw an exception", e)
      }
    }
  }

  /**
   * 把事件发送到指定的监听器，只是定义了接口并没有实现该方法，子类须实现该函数
   */
  protected def doPostEvent(listener: L, event: E): Unit

  /**
   * 查找CopyOnWriteArrayList中与指定类型相同的监听器
   */
  private[spark] def findListenersByClass[T <: L : ClassTag](): Seq[T] = {
    val c = implicitly[ClassTag[T]].runtimeClass
    listeners.asScala.filter(_.getClass == c).map(_.asInstanceOf[T]).toSeq
  }

}