CallResponder - Referência da API Adobe ActionScript® 3 (AS3 Flex)

Pacote	mx.rpc
Classe	public class CallResponder
Herança	CallResponder EventDispatcher Object
Implementações	IResponder

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

This component helps you manage the results for asynchronous calls made from RPC based services, typically from MXML components. While each individual service and operation dispatches result and fault events, it is common to need to use the same operation in different parts of your application. Using one event listener or lastResult value across the entire application can be awkward. Rather than creating two service components which refer to the same service, you can use a simple lightweight CallResponder to manage the event listeners and lastResult value for a specific invocation of a service.

You set the token property of this component to the AsyncToken returned by the service. You can then add event listeners on this component instead of having to add them to each AsyncToken returned. This component also maintains the lastResult property which is a copy of the value returned by the last successful result event dispatched by a token monitored by this service. Though you can bind to either the callResponder.token.result or callResponder.lastResult, the latter will be preserved while a second call to the same service is in progress while the former will be reset as soon as a new service invocation is started.

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		lastResult : * This property stores the result property of the token each time it delivers a successful result.	CallResponder
		token : mx.rpc:AsyncToken Each CallResponder dispatches result and fault events received from a single token.	CallResponder

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		fault(data:Object):void This method is called by the AsyncToken when it wants to deliver a FaultEvent to the CallResponder.	CallResponder
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		result(data:Object):void This method is called by the AsyncToken when it wants to deliver a ResultEvent to the CallResponder.	CallResponder
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Retorna a representação de string do objeto especificado.	Object
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
fault	Dispatched when an Operation call fails.	CallResponder
result	Dispatched when an Operation invocation successfully returns.	CallResponder

Detalhes da propriedade

lastResult

propriedade

lastResult:*

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

This property stores the result property of the token each time it delivers a successful result. You can bind to or access this property instead of the token.result property to keep your code from seeing that value cleared out on the second and subsequent call to a particular service method. Additionally, if a fault occurs this value will still be set to the last successful result returned by a token monitored by this CallResponder.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento propertyChange .

Implementação
public function get lastResult():*
public function set lastResult(value:any):void

token

propriedade

token:mx.rpc:AsyncToken

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

Each CallResponder dispatches result and fault events received from a single token. This property value specifies that token. You typically set this property to the AsyncToken object returned by the service.

Essa propriedade pode ser usada como a origem para o vínculo de dados. Quando essa propriedade é modificada, ela despacha o evento propertyChange .

Implementação
public function get token():mx.rpc:AsyncToken
public function set token(value:mx.rpc:AsyncToken):void

Detalhes do método

fault

()

método

public function fault(data:Object):void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

This method is called by the AsyncToken when it wants to deliver a FaultEvent to the CallResponder. You do not call this method directly.

Parâmetros

data:Object — The FaultEvent delivered by the AsyncToken

result

()

método

public function result(data:Object):void

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

This method is called by the AsyncToken when it wants to deliver a ResultEvent to the CallResponder. You do not call this method directly.

Parâmetros

data:Object — The ResultEvent delivered by the AsyncToken

Detalhe do evento

fault

Evento

Tipo do objeto de evento: mx.rpc.events.FaultEvent
propriedade FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

Dispatched when an Operation call fails.

The FAULT event type.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	true, calling preventDefault() from the associated token's responder.fault method will prevent the service or operation from dispatching this event
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`fault`	The Fault object that contains the details of what caused this event.
`message`	The Message associated with this event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`token`	The token that represents the call to the method. Used in the asynchronous completion token pattern.

result

Evento

Tipo do objeto de evento: mx.rpc.events.ResultEvent
propriedade ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

Versão da linguagem:

ActionScript 3.0

Versão de produto:

Flex 3

Versões de runtime:

Flash Player 9, AIR 1.1

Dispatched when an Operation invocation successfully returns.

The RESULT event type.

The properties of the event object have the following values:

Property	Value
`bubbles`	false
`cancelable`	true, preventDefault() from the associated token's responder.result method will prevent the service or operation from dispatching this event
`currentTarget`	The Object that defines the event listener that handles the event. For example, if you use `myButton.addEventListener()` to register an event listener, myButton is the value of the `currentTarget`.
`message`	The Message associated with this event.
`target`	The Object that dispatched the event; it is not always the Object listening for the event. Use the `currentTarget` property to always access the Object listening for the event.
`result`	Result that the RPC call returns.
`token`	The token that represents the indiviudal call to the method. Used in the asynchronous completion token pattern.

Aspectos jurídicos | Política de privacidade on-line

CallResponder - AS3 Flex

Classes x

lastResult

token

fault

result

fault

result