转载请注明链接:http://www.cnblogs.com/liuwanqiu/p/6739880.html

Event是所有事件的基类,它继承Object类

Event类上面的注释的大致意思:

 * Event是所有事件类的基类,它封装了与事件关联的参数
* sender属性指的是谁发起来的事件.
* handled属性指的是事件的处理方式. 如果一个事件处理程序设置了handled为true,其它未处理的事件处理程序将不会被调用。
*
* 当附加事件处理程序时,可能会通过额外的数据 ,当事件处理程序被调用时,可通过[ data]属性提供
class Event extends Object
{
/**
* 事件的名字,通过[[Component::trigger()]] 和 [[trigger()]]方法设置,事件处理程序可以使用此属性来检查它的处理事件
*/
public $name;
/**
* 触发事件的对象,如果未设置,则设置为调用"trigger()"方法的对象,如果是在静态环境下触发的类级别的事件,属性为空
*/
public $sender;
/**
*如果一个事件处理程序设置了handled为true,其它未处理的事件处理程序将不会被执行,默认值为false
*/
public $handled = false;
/**
* 附加一个事件处理程序时通过[[Component::on()]]传入data,且对应当前执行的事件处理程序
* 注意,这取决于哪个事件处理程序当前正在执行。
*/
public $data; /**
* @var 数组包含所有全局注册的事件处理程序,存储所有的 event,所有的 event 对象/类都共用这一数据
*/
private static $_events = []; /**
* 为一个类添加事件
* 当一个类级别事件触发,将调用该类和所有父类的事件处理程序
* 例如:
* 该处理程序是将每一个成功的[[ActiveRecord]]插入调用
* ```php
* Event::on(ActiveRecord::className(), ActiveRecord::EVENT_AFTER_INSERT, function ($event) {
* Yii::trace(get_class($event->sender) . ' is inserted.');
* });
* ```
*
* @param string $class 定义的类级别的对象或者类名称.
* @param string $name 事件名.
* @param callable $handler 事件处理程序.
* @param mixed $data 当事件被触发时,将传递给事件处理程序的数据。当调用事件处理程序时,该数据可以通过[[Event::data]]传递
* @param boolean $append 是否将新事件处理程序附加到现有的处理程序列表的结尾。
* 如果false,新的处理程序将被插入到现有的处理程序列表开头
* @see off()
*/
public static function on($class, $name, $handler, $data = null, $append = true)
{
// 去掉 class 最左边的反斜杠,主要是针对类的静态方法
$class = ltrim($class, '\\');
if ($append || empty(self::$_events[$name][$class])) {
//如果 append 为true,附加到$_events中名字为 $name 的数组结尾
self::$_events[$name][$class][] = [$handler, $data];
} else {
//如果false,被插入列表开头
array_unshift(self::$_events[$name][$class], [$handler, $data]);
}
} /**
* [[on()]]的反方法,移除一个类的事件
*
* @param string $class 定义类级别的对象或者类名称.
* @param string $name 事件名
* @param callable $handler 事件处理程序.如果是null,移除所有相关事件
* @return boolean 一个处理程序是否被发现且分离.
* @see on()
*/
public static function off($class, $name, $handler = null)
{
// 去掉最左边的反斜线,主要是针对类的静态方法
$class = ltrim($class, '\\');
if (empty(self::$_events[$name][$class])) {
// 该事件不存在,返回false
return false;
}
if ($handler === null) {
// 如果 $handler 为空,该类下该所有是这个名字的事件移除,
unset(self::$_events[$name][$class]);
return true;
} else {
$removed = false;
foreach (self::$_events[$name][$class] as $i => $event) {
// 如果 $handler 不为空,循环 $_events 找到相应的 $handler,只移除这个 $handler 和 data 组成的数组
if ($event[0] === $handler) {
unset(self::$_events[$name][$class][$i]);
$removed = true;
}
}
if ($removed) {
// 移除成功,使数组重新变成一个自然数组
self::$_events[$name][$class] = array_values(self::$_events[$name][$class]);
} return $removed;
}
} /**
* 解除所有的事件处理程序
* @since 2.0.10
*/
public static function offAll()
{
self::$_events = [];
} /**
* 是否给某个类绑定了某个事件
* 检测在某个类或者对象是否具有某个事件 同时检测父类
* @param string|object $class 定义类级别的对象或者类名称.
* @param string $name the event name.事件名
* @return boolean 是否有处理程序连接到事件.
*/
public static function hasHandlers($class, $name)
{
if (empty(self::$_events[$name])) {
//如果不存在事件,返回false
return false;
}
if (is_object($class)) {
//如果是对象,获取类名
$class = get_class($class);
} else {
//如果是类名,去掉左边的反斜杠,主要是针对类的静态方法
$class = ltrim($class, '\\');
}
//将当前类,当前类的父类,父类所实现的接口合并成一个数组
$classes = array_merge(
[$class],
class_parents($class, true),
class_implements($class, true)
); foreach ($classes as $class) {
if (!empty(self::$_events[$name][$class])) {
//找到了就返回true
return true;
}
} return false;
} /**
* 触发类级别事件。
* 该方法将调用指定类中的事件处理程序
* @param string|object $class 定义的类级别的对象或者类名称.
* @param string $name 事件名.
* @param Event $event 事件参数,未设置则默认创建
*/
public static function trigger($class, $name, $event = null)
{
if (empty(self::$_events[$name])) {
//如果事件为空,直接返回
return;
}
if ($event === null) {
// 事件不存在,就创建一个静态 Event 对象
$event = new static;
}
$event->handled = false;//事件是否被处理标志,默认未处理
$event->name = $name;//事件名 if (is_object($class)) {
if ($event->sender === null) {
// 如果 $class 是个对象,并且sender为空,就将 $class赋给sender,即$class发起事件
$event->sender = $class;
}
$class = get_class($class);//获取类名
} else {
//不是对象,去掉左边的反斜线
$class = ltrim($class, '\\');
}
//将当前类,当前类的父类,父类所实现的接口合并成一个数组
$classes = array_merge(
[$class],
class_parents($class, true),
class_implements($class, true)
); foreach ($classes as $class) {
if (!empty(self::$_events[$name][$class])) {
foreach (self::$_events[$name][$class] as $handler) {
// 将参数赋到 event 对象的 data 属性上
$event->data = $handler[1];
// 调用 $handler 方法
call_user_func($handler[0], $event);
if ($event->handled) {
//事件处理程序handled为true,其它未处理的事件处理程序将不会被调用。
return;
}
}
}
}
}
}

  

yii2 源码分析Event类分析 (三)的更多相关文章

  1. JDK源码之Integer类分析

    一 简介 Integer是int基本类型的包装类,同样继承了Number类,实现了Comparable接口,String类中的一些转化方法就使用了Integer类中的一些API,且fianl修饰不可继 ...

  2. JDK源码之Byte类分析

    一 简介 byte,即字节,由8位的二进制组成.在Java中,byte类型的数据是8位带符号的二进制数,以二进制补码表示的整数 取值范围:默认值为0,最小值为-128(-2^7);最大值是127(2^ ...

  3. JDK源码之Boolean类分析

    一 简介 boolean类型的封装类,将基本类型为boolean的值包装在一个对象中,实现序列化接口,和Comparable接口 额外提供了许多便捷方法,比较简单,直接贴代码分析 二 源码分析 //t ...

  4. [Android FrameWork 6.0源码学习] LayoutInflater 类分析

    LayoutInflater是用来解析XML布局文件,然后生成对象的ViewTree的工具类.是这个工具类的存在,才能让我们写起Layout来那么省劲. 我们接下来进去刨析,看看里边的奥秘 //调用i ...

  5. JDK源码之AbstractStringBuilder类分析

    一 概述 二 实现接口 AbstractStringBuilder实现了两个接口: Appendable 概述: Appendable的实现类的对象可以附加字符序列和值. 要追加的字符应该是Unico ...

  6. Yii2源码分析(一):入口

    写在前面,写这些随笔是记录下自己看Yii2源码的过程,可能会有些流水账,大部分解析放在注释里说明,由于个人水平有限,有不正确的地方还望斧正. web入口文件Index.php // 定义全局的常量,Y ...

  7. Okhttp3源码解析(2)-Request分析

    ### 前言 前面我们讲了 [Okhttp的基本用法](https://www.jianshu.com/p/8e404d9c160f) [Okhttp3源码解析(1)-OkHttpClient分析]( ...

  8. HashMap的源码学习以及性能分析

    HashMap的源码学习以及性能分析 一).Map接口的实现类 HashTable.HashMap.LinkedHashMap.TreeMap 二).HashMap和HashTable的区别 1).H ...

  9. Okhttp3源码解析(3)-Call分析(整体流程)

    ### 前言 前面我们讲了 [Okhttp的基本用法](https://www.jianshu.com/p/8e404d9c160f) [Okhttp3源码解析(1)-OkHttpClient分析]( ...

随机推荐

  1. Oracle数据库之SQL基础(一)

    主要内容:用户与表空间:表与约束:查询语句. 一.概述 Oracle安装:访问官网,下载 二.用户与表空间 在安装Oracle时在开始菜单里可以用sql puls登录oracle. ★1.系统用户 s ...

  2. 关于C#中的弱引用

    本文前部分来自:http://www.cnblogs.com/mokey/archive/2011/11/24/2261605.html 分割线后为作者补充部分. 一:什么是弱引用 了解弱引用之前,先 ...

  3. 配置sphinx

    1.先安装sphinxclient    #cd /usr/local/src    #wget http://sphinxsearch.com/files/sphinx-0.9.9.tar.gz   ...

  4. Hibernate工作流程

    Hibernate创建步骤 (五大核心接口:Configuration/SessionFactory/Session/Transaction/Query) 1.新建工程,导入需要的jar包. 2.利用 ...

  5. 分享非常有用的Java程序 (关键代码)(五)---把 Array 转换成 Map

    原文:分享非常有用的Java程序 (关键代码)(五)---把 Array 转换成 Map import java.util.Map; import org.apache.commons.lang.Ar ...

  6. Passenger/Nginx/Debian快速部署Rails

    安装所需的linux包 sudo apt-get install build-essential bison openssl libreadline6 libreadline6-dev curl gi ...

  7. C指针1

    //定义:指针是一个特殊的数据类型,指针指向内存中的地址,因此,指针变量存储的是内存中的一个地址 //例子,%p表示打印一个地址,打印p表示打印p指向的地址 //输出结果为0x7fff5fbff7dc ...

  8. vue 使用canvas仿芝麻分信用表

    如图所示: 画布组件:dashboard.vue <template> <div> <canvas ref="canvas" v-if="c ...

  9. 一套能体现 RBAC 的表结构设计

    1.RBAC 概述 2.表结构设计 2.1.用户表 2.2.角色表 2.3.权限表 2.4.用户角色(关系)表 2.5.角色权限(关系)表 3.总结 1.RBAC 概述 RBAC(Role-Based ...

  10. Apache自带压力测试工具----linux环境中ab命令简介及结果分析

    ab(apache bench)是apache下的一个工具,主要用于对web站点做压力测试, 基础用法: 其中-c选项为一次发送的请求数量,及并发量.-n选项为请求次数. 实验测试: [dev@web ...