CallResponder - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.rpc
类	public class CallResponder
继承	CallResponder EventDispatcher Object
实现	IResponder

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此组件帮助您管理从基于 RPC 的服务（通常从 MXML 组件）进行的异步调用的结果。尽管每个服务和操作都会调度结果和错误事件，但是通常需要在应用程序的不同部分使用相同的操作。在整个应用程序中使用一个事件侦听器或 lastResult 值可能非常不方便。您可以使用简单轻型的 CallResponder 为服务的特定调用管理事件侦听器和 lastResult 值，而不是创建引用同一服务的两个服务组件。

可以将此组件的 token 属性设置为服务返回的 AsyncToken。然后，可以在此组件上添加事件侦听器，而无需将其添加到返回的每个 AsyncToken。此组件还保留了 lastResult 属性，该属性是此服务监视的标记所调度的上一个成功结果事件返回的值的副本。尽管您可以绑定到 callResponder.token.result 或 callResponder.lastResult，但是，当第二次调用同一个服务时，将保留 callResponder.lastResult；当启动新的服务调用时，将重置 callResponder.token.result。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		lastResult : * 此属性每当标记传送成功结果时存储标记的 result 属性。	CallResponder
		token : mx.rpc:AsyncToken 每个 CallResponder 都调度从单一标记处收到的结果和错误事件。	CallResponder

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		fault(data:Object):void 当 AsyncToken 希望将 FaultEvent 传送到 CallResponder 时，AsyncToken 会调用此方法。	CallResponder
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		result(data:Object):void 在 AsyncToken 希望将 ResultEvent 传送到 CallResponder 时，会调用此方法。	CallResponder
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
fault	当操作调用失败时调度。	CallResponder
result	当操作调用成功返回时调度。	CallResponder

属性详细信息

lastResult

属性

lastResult:*

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此属性每当标记传送成功结果时存储标记的 result 属性。您可以绑定到或访问此属性（而不是 token.result 属性），以防止在第二次或接下来调用特定服务方法时，代码发现值已被清除。另外，如果发生错误，此值仍会设置为由此 CallResponder 监视的标记返回的上一个成功结果。

此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。

实现
public function get lastResult():*
public function set lastResult(value:any):void

token

属性

token:mx.rpc:AsyncToken

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

每个 CallResponder 都调度从单一标记处收到的结果和错误事件。此属性值指定该标记。通常会将此属性设置为由服务返回的 AsyncToken 对象。

此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。

实现
public function get token():mx.rpc:AsyncToken
public function set token(value:mx.rpc:AsyncToken):void

方法详细信息

fault

()

方法

public function fault(data:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 AsyncToken 希望将 FaultEvent 传送到 CallResponder 时，会调用此方法。您无需直接调用此方法。

参数

data:Object — 通过 AsyncToken 传送的 FaultEvent

result

()

方法

public function result(data:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

在 AsyncToken 希望将 ResultEvent 传送到 CallResponder 时，会调用此方法。您无需直接调用此方法。

参数

data:Object — 通过 AsyncToken 传送的 ResultEvent

事件详细信息

fault

事件

事件对象类型: mx.rpc.events.FaultEvent
属性 FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当操作调用失败时调度。

FAULT 事件类型。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true，通过关联标记的 responder.fault 方法调用 preventDefault() 将防止服务或操作调度此事件。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`fault`	包含导致此事件原因的详细信息的 Fault 对象。
`message`	与此事件相关联的 Message。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`token`	表示方法调用的标记。用于异步完成标记模式。

result

事件

事件对象类型: mx.rpc.events.ResultEvent
属性 ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

当操作调用成功返回时调度。

RESULT 事件类型。

事件对象的属性有下列值：

属性	值
`bubbles`	false
`cancelable`	true，通过关联标记的 responder.result 方法调用 preventDefault() 将防止服务或操作调度此事件。
`currentTarget`	用于定义处理该事件的事件侦听器的对象。例如，如果您使用 `myButton.addEventListener()` 注册某个事件侦听器，则 myButton 为 `currentTarget` 的值。
`message`	与此事件相关联的 Message。
`target`	调度该事件的 Object；它不一定是侦听该事件的 Object。使用 `currentTarget` 属性始终可以访问侦听事件的 Object。
`result`	RPC 调用返回的结果。
`token`	表示对方法单独调用的标记。用于异步完成标记模式。

法律声明 | 在线隐私策略

CallResponder - AS3 Flex

包x

语言元素

附录

包 mx.rpc

lastResult

token

fault

result

fault

result