首页 > 代码库 > Magento 模块开发之DispatchEvent(转)

Magento 模块开发之DispatchEvent(转)

在这一章节中,我们来了解 Magento 中的事件分发机制 Mage::dispatchEvent()
在创建自己的模块时, Event 事件的分发将会变成十分有用且有效

 

以个人的经验, 事件的分发使用频率应该高于对类的重写(overriding), 为什么这么说呢, 当有多个模块的时候, 重写同一个类(class)时,那它们互相将会有冲突, 只有一个模块将会正常工作, 但是如果你使用事件的话, 那么多个模块都可以很轻松的去调用它

 

Magento 中的事件也是根据观察者(Observer)设计模式, 它是这样工作的, 在 Magento 核心代码中, 许多地方都分发了事件, 每一个事件都有自己唯一的名字和其他相关的参数, 在我们自己的模块中, 同样也可以调用这些事件, 当 Magento 分发这些事件的时候, 在我们自己模块中的一个方法将会被触发, 在这个方法中我们可以进行相关的操作

 

Magento 调用 Mage::dispatchEvent() 方法来分发事件, 你全盘搜索一下的话,会发现 Magento 代码中很多地方都调用了

 

现在我们来拿 Mage_Checkout_Model_Type_Onepage 类中的 saveOrder 方法来举例

1
2
3
4
5
6
7
Mage::dispatchEvent(
                ‘checkout_type_onepage_save_order_after‘,
                array(
                    ‘order‘ => $order,
                    ‘quote‘ => $this->getQuote()
                )
);

 

每一个事件都有自己的名字和相关参数
在上述方法中, ‘checkout_type_onepage_save_order_after‘ 就是自己的名字, array(‘order‘=>$order, ‘quote‘=>$this->getQuote()) 就是相关参数

 

在我们的模块中如果想调用(subscribe)或监听(listen)这个事件的时候, 需要添加如下代码至 config.xml 文件中

1
2
3
4
5
6
7
8
9
10
11
<events>
    <checkout_type_onepage_save_order_after> <!-- 事件的名字 -->
        <observers>
            <save_after> <!-- 任何唯一的标示符 -->
                <type>singleton</type>
                <class>Excellence_Test_Model_Observer</class> <!-- 我们自己的类(class) -->
                <method>saveOrderAfter</method> <!-- 方法名 -->
            </save_after>
        </observers>
    </checkout_type_onepage_save_order_after>   
</events>

 

现在在我们自己模块的 Model 文件夹中建立一个 Observer.php 文件, 随后定义一个方法名为: saveOrderAfter()

1
2
3
4
5
6
7
8
9
10
11
12
13
14
class Excellence_Test_Model_Observer
{
    public function saveOrderAfter($evt){
        $order = $evt->getOrder(); //这样就能获得到在 Mage::dispatchEvent() 方法中传的参数
        $quote = $evt->getQuote(); //这样就能获得到在 Mage::dispatchEvent() 方法中传的参数
        /*
        ....
        这里可以执行相关操作
        发送邮件
        等等...
        ....
        */
    }
}

 

另外,每当一个模块(Model)执行完保存之后,这两个事件会被触发:

1
2
3
4
5
6
7
8
9
Mage::dispatchEvent(
                ‘model_save_before‘,
                array(‘object‘ => $this)
);
 
Mage::dispatchEvent(
                ‘model_save_after‘,
                array(‘object‘=>$this)
);

Magento 模块开发之DispatchEvent(转)