在项目中,使用as3内置事件框架必须通过自定义事件才可以实现值的传递,大量自定义事件、定义常量和整个事件派发的管理、添加侦听器、移除侦听器,或多或少都会带来大量的代码,而signals这个框架思想原来在C#中原本就有,作者整合了C#中的signals思想,实现起来比as3内置的事件更快捷,可以很轻松的实现多个强类型值的传递,的在一定程度上也会简化很多代码。有朋友测试,signals里面用内置的事件竟然是as3内置事件运行速度的4倍。
但是我想大家已经对Event事件机制已经非常熟悉了,那么我们就从Event框架机制开始吧。
var sprite:Sprite = new Sprite()sprite.addEventListner(MouseEvent.CLICK, onEventHandler)function onEventHandler(me:MouseEvent):void{ //执行代码}
稍微解释一下,以方便理解Signals框架,首先定义一个Sprite的实例,使用addEventListener()方法为sprite添加事件侦听,事件类型是MouseEvent.CLICK事件,事件响应函数为onEventHandler函数。如果想使用AS3.0 Event框架来自定义事件那绝对是个体力活,但使用Signals框架来自定义却非常简单。首先从最基本的开始。
Signal类
AlarmClock.as
这个类用来定义一个AlarmClock,同时使用Signals框架自定义事件以被AlarmClock的实例来捕获。
package insideria.basicSignal{ import org.osflash.signals.Signal; public class AlarmClock { //定义一个alarm事件,设定为public属性以被访问,相当于Event框架中所使用的MousEvent.CLICK public var alarm:Signal; public function AlarmClock() { //实例化alarm alarm = new Signal(); } public function ring():void { //调用Signal类的实例的方法dispatch(),只要该方法被执行,Signal就会派发alarm事件,我们要做的就是捕获该事件,并作出相应 alarm.dispatch(); } }}
WakeUp.as
主函数类文档
package insideria.WakeUp{ import flash.display.Sprite; public class WakeUp extends Sprite { //定义一个AlarmCLock类的变量 private var alarmClock:AlarmClock; public function WakeUp() { //实例化Alarmclock alarmClock = new AlarmClock(); //使用signal的add()方法为该实例的alarm事件添加一个响应函数。类似于addEventListner()方法 alarmClock.alarm.add(onRing); //调用ring()方法执行signal的dispatch()方法,派发事件 alarmClock.ring(); } //alarm事件的响应函数 private function onRing():void { trace("Wake up!"); } }}
执行文档在输出面板就会看到:
Wake Up!
如果想在使用Signal定义事件时想要派发参数也可以
AlarmClock.as
package insideria.basicSignalArguments { import org.osflash.signals.Signal; public class AlarmClock { public var alarm:Signal; public function AlarmClock() { alarm = new Signal(String); } public function ring():void { alarm.dispatch("9 AM"); } }}
当然多类型的参数也是可以的,只要在dispatch()方法里依次输入对用类型的数值即可
alarm = new Signal(String, Number, int, uint, Boolean);alarm.dispatch("9 AM", 45.4, -10, 5, true);
WakeUp.as
package insideria.basicSignalArguments{ import flash.display.Sprite; public class WakeUp extends Sprite { private var alarmClock:AlarmClock; public function WakeUp() { alarmClock = new AlarmClock(); alarmClock.alarm.add(onRing); alarmClock.ring(); } private function onRing(time:String):void { trace("Wake up! It's already " + time); } }}
测试影片可以看到输出面板输出:
Wake Up! It's already 9 AM
还记得在as3.0 Event框架下,我们每次添加事件都要使用removeEventListner()方法来移除事件,Signal提供addOnce()方法仅添加一次事件而不需要我们再去添加额外代码去移除事件,在事件被派发一次后自动移除该事件。
alarmClock.alarm.addOnce(onRing);
当然在更多情况下我们还是想要手动控制事件的移除,你可以使用remove()方法去移除事件,或者使用removeAll()方法一次性移除所有事件。
alarmClock.alarm.remove(onRing);alarmClock.alarm.removeAll();
在as3.0 Event框架下,事件提供了currentTarget/Target用来通过事件来访问对象,Signlas框架也提供了类似的属性。
DeluxeSignal
DeluxeSignal类与GenericEvent类共同使用可以实现上述用法
AlarmClock.as
package insideria.deluxeSignal{ import org.osflash.signals.DeluxeSignal; import org.osflash.signals.events.GenericEvent; public class AlarmClock { //定义alarm事件 public var alarm:DeluxeSignal; //定义一个字符串 public var message:String; public function AlarmClock() { //实例化DeluxeSignal alarm = new DeluxeSignal(this); //为字符串赋值 message = "This is a message from our AlarmClock"; } public function ring():void { //绑定派发事件 alarm.dispatch(new GenericEvent()); } }}
WakeUp.as
package insideria.deluxeSignal { import org.osflash.signals.events.GenericEvent; import flash.display.Sprite; public class WakeUp extends Sprite { private var alarmClock:AlarmClock; public function WakeUp() { alarmClock = new AlarmClock(); alarmClock.alarm.add(onRing); alarmClock.ring(); } private function onRing(event:GenericEvent):void { trace(event.target); trace(event.signal); trace(event.target.message); } }}
测试影片,输出面板输出:
alarmClock
DeluxeSignal
This is a message from our AlarmClock
NativeSignal
最后Signals框架提供NativeSignal类用来代替Event框架事件,以MouseEvent为例
//自定义事件clickedprivate var clicked:NativeSignal;private var box:Sprite;box = new Sprite();box.graphics.beginFill(0xCCCCCC);box.graphics.drawRect(0, 0, 100, 100);box.graphics.endFill();addChild(box);//通过Event机制下的MouseEvent.CLICK,为box添加clicked事件clicked = new NativeSignal(box, MouseEvent.CLICK, MouseEvent);//添加响应函数clicked.add(onClicked); private function onClicked(event:MouseEvent):void{ trace("clicked");}
再来个例子:
package com.pleribus.as3signalsdemo { import org.osflash.signals.natives.NativeSignal; import org.osflash.signals.Signal; import flash.display.Sprite; import flash.events.MouseEvent; /** * @author Clint Hannaford */ public class Player extends Sprite { public var playerKilled:Signal; public var playerHit:Signal; public var click : NativeSignal; private var health: Number; public function Player(){ } public function init() : void { //为health变量赋值 health = 10; //实例化自定义事件playerKilled playerKilled = new Signal(); //实例化自定义事件playerHit playerHit = new Signal(); //实例化自定义事件click click = new NativeSignal(this, MouseEvent.CLICK, MouseEvent); //为此类画上图形按钮 with (this.graphics){ beginFill(0x000000); drawRect(0, 0, 50, 50); endFill(); beginFill(0xFFFFFF); drawRect(10, 10, 10, 10); drawRect(30, 10, 10, 10); drawRect(10, 30, 30, 10); } } //自定义一个公有方法hit public function hit():void{ //health变量自减 health--; //为此类的实例绑定并派发playerHit事件 playerHit.dispatch("Player Hit", health); //判断health变量值,当小于等于0时执行kill()函数 if (health <= 0){ kill(); } } //私有方法kill,执行此函数为此类的实例绑定并派发playerKilled事件 private function kill():void{ playerKilled.dispatch("Player Killed"); } } }
package com.pleribus.as3signalsdemo { import flash.events.MouseEvent; import flash.text.TextField; import flash.display.Sprite; /** * @author Clint Hannaford */ public class SignalsDemo extends Sprite { public var player:Player; public var textOutput:TextField; public function SignalsDemo() { //执行addPlayer()方法 addPlayer(); //执行addTextField()方法 addTextField(); //为自定义事件添加响应函数 player.playerHit.add(onPlayerHit); player.playerKilled.add(onPlayerKilled); player.click.add(onClickPlayer); } //实例化Player类 private function addPlayer():void{ player = new Player(); player.init(); player.x = 30; player.y = 30; player.buttonMode = true; addChild(player); } //实例化TextField private function addTextField():void{ textOutput = new TextField(); textOutput.x = 10; textOutput.y = 100; textOutput.width = 350; textOutput.height = 200; textOutput.border = true; addChild(textOutput); } //事件响应函数 private function onClickPlayer(event:MouseEvent) : void { // 每当按钮被点击时执行Play()类中定义的hit()方法 player.hit(); } private function onPlayerKilled(message:String) : void { textOutput.appendText(message+"\n"); player.playerHit.remove(onPlayerHit); player.playerKilled.remove(onPlayerKilled); player.click.remove(onClickPlayer); this.removeChild(player); } private function onPlayerHit(message:String, health:Number) : void { textOutput.appendText(message+" - health now: "+health+"\n"); } } }