Packagelaya.utils
Classpublic class Handler
InheritanceHandler Inheritance Object

Handler 是事件处理器类。

推荐使用 Handler.create() 方法从对象池创建,减少对象创建消耗。创建的 Handler 对象不再使用后,可以使用 Handler.recover() 将其回收到对象池,回收后不要再使用此对象,否则会导致不可预料的错误。

注意:由于鼠标事件也用本对象池,不正确的回收及调用,可能会影响鼠标事件的执行。



Public Properties
 PropertyDefined By
  args : Array
参数。
Handler
  caller : *
执行域(this)。
Handler
  method : Function
处理方法。
Handler
  once : Boolean = false
表示是否只执行一次。如果为true,回调后执行recover()进行回收,回收后会被再利用,默认为false 。
Handler
Public Methods
 MethodDefined By
  
Handler(caller:* = null, method:Function = null, args:Array = null, once:Boolean = false)
根据指定的属性值,创建一个 Handler 类的实例。
Handler
  
清理对象引用。
Handler
  
create(caller:*, method:Function, args:Array = null, once:Boolean = true):Handler
[static] 从对象池内创建一个Handler,默认会执行一次并立即回收,如果不需要自动回收,设置once参数为false。
Handler
  
recover():void
清理并回收到 Handler 对象池内。
Handler
  
run():*
执行处理器。
Handler
  
runWith(data:*):*
执行处理器,携带额外数据。
Handler
  
setTo(caller:*, method:Function, args:Array, once:Boolean):Handler
设置此对象的指定属性值。
Handler
Property Detail
argsproperty
public var args:Array

参数。

callerproperty 
public var caller:*

执行域(this)。

methodproperty 
public var method:Function

处理方法。

onceproperty 
public var once:Boolean = false

表示是否只执行一次。如果为true,回调后执行recover()进行回收,回收后会被再利用,默认为false 。

Constructor Detail
Handler()Constructor
public function Handler(caller:* = null, method:Function = null, args:Array = null, once:Boolean = false)

根据指定的属性值,创建一个 Handler 类的实例。

Parameters
caller:* (default = null) — 执行域。
 
method:Function (default = null) — 处理函数。
 
args:Array (default = null) — 函数参数。
 
once:Boolean (default = false) — 是否只执行一次。
Method Detail
clear()method
public function clear():Handler

清理对象引用。

Returns
Handler
create()method 
public static function create(caller:*, method:Function, args:Array = null, once:Boolean = true):Handler

从对象池内创建一个Handler,默认会执行一次并立即回收,如果不需要自动回收,设置once参数为false。

Parameters

caller:* — 执行域(this)。
 
method:Function — 回调方法。
 
args:Array (default = null) — 携带的参数。
 
once:Boolean (default = true) — 是否只执行一次,如果为true,回调后执行recover()进行回收,默认为true。

Returns
Handler — 返回创建的handler实例。
recover()method 
public function recover():void

清理并回收到 Handler 对象池内。

run()method 
public function run():*

执行处理器。

Returns
*
runWith()method 
public function runWith(data:*):*

执行处理器,携带额外数据。

Parameters

data:* — 附加的回调数据,可以是单数据或者Array(作为多参)。

Returns
*
setTo()method 
public function setTo(caller:*, method:Function, args:Array, once:Boolean):Handler

设置此对象的指定属性值。

Parameters

caller:* — 执行域(this)。
 
method:Function — 回调方法。
 
args:Array — 携带的参数。
 
once:Boolean — 是否只执行一次,如果为true,执行后执行recover()进行回收。

Returns
Handler — 返回 handler 本身。