写PHP的老王-Yii2 源码学习 Behavior

Yii2 源码学习 Behavior

10 Nov 2016 Category: PHP

Yii2的行为，用来在不修改组件主体代码的情况下，增强组件的功能。行为可以将自己的方法以及属性注入到组件中。在组件中可以像使用自己的方法和属性一样使用，通过$this直接调用。行为通过组件能响应被触发的事件，从而自定义或调整组件正常执行的代码。

Behavior类:

class Behavior extends Object
{

    public $owner;

    public function events()
    {
        return [];
    }

    public function attach($owner)
    {
        $this->owner = $owner;
        foreach ($this->events() as $event => $handler) {
            $owner->on($event, is_string($handler) ? [$this, $handler] : $handler);
        }
    }

    public function detach()
    {
        if ($this->owner) {
            foreach ($this->events() as $event => $handler) {
                $this->owner->off($event, is_string($handler) ? [$this, $handler] : $handler);
            }
            $this->owner = null;
        }
    }
}

行为主要提供两个方法，一个是行为绑定，一个是行为解绑。绑定的过程中，通过events属性，对定义的组件事件以及事件响应函数进行绑定。实现在行为中响应组件事件的功能。

比如要实现一个将数据添加排序字段的行为SortrableModelBehavior

class SortrableModelBehavior extends Behavior{
	 public function events()
    {
        return [
            ActiveRecord::EVENT_BEFORE_INSERT => 'findMaxOrderNum',
        ];
    }

    public function findMaxOrderNum($event)
    {
        if(!$this->owner->order_num) {
            $maxOrderNum = (int)(new \yii\db\Query())
                ->select('MAX(`order_num`)')
                ->from($this->owner->tableName())
                ->scalar();
            $this->owner->order_num = ++$maxOrderNum;
        }
    }
}

这样在ActiveRecord组件执行对象插入的时候就会获取当前最大排序值并加一赋值给新数据。而在ActiveRecord组件中不需要做任何更改。

behavior中注意事项:

在behavior中访问组件:$this->owner
behavior中$this指代行为本身
如果behavior中的函数名或属性跟组件冲突的时候，访问的是组件的方法和属性，这个从Component的属性获取的方式，和函数调用的魔术方法中就可以看出

    public function __get($name)
    {
        $getter = 'get' . $name;
        if (method_exists($this, $getter)) {
            // read property, e.g. getName()
            return $this->$getter();
        } else {
            // behavior property
            $this->ensureBehaviors();
            foreach ($this->_behaviors as $behavior) {
                if ($behavior->canGetProperty($name)) {
                    return $behavior->$name;
                }
            }
        }
        if (method_exists($this, 'set' . $name)) {
            throw new InvalidCallException('Getting write-only property: ' . get_class($this) . '::' . $name);
        } else {
            throw new UnknownPropertyException('Getting unknown property: ' . get_class($this) . '::' . $name);
        }
    }

    public function __call($name, $params)
    {
        $this->ensureBehaviors();
        foreach ($this->_behaviors as $object) {
            if ($object->hasMethod($name)) {
                return call_user_func_array([$object, $name], $params);
            }
        }
        throw new UnknownMethodException('Calling unknown method: ' . get_class($this) . "::$name()");
    }

只用当组件中属性，方法不存在才会去检查所绑定行为中的属性和方法。

Yii2 源码学习 Behavior

评论