CallResponder - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.rpc
Classe	public class CallResponder
Héritage	CallResponder EventDispatcher Object
Implémente	IResponder

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Ce composant vous aide à gérer les résultats des appels asynchrones effectués depuis les services RPC, généralement depuis des composants MXML. Bien que chaque opération et service individuel distribue des événements result et fault, il est courant de devoir utiliser la même opération dans différentes parties de votre application. Utiliser un écouteur d’événement ou une valeur lastResult à travers l’application entière peut être difficile. Au lieu de créer deux composants de services se référant au même service, vous pouvez utiliser une classe CallResponder légère simple afin de gérer les écouteurs d’événements et la valeur lastResult pour une invocation spécifique d’un service.

Définissez la propriété token de ce composant sur la classe AsyncToken renvoyée par le service. Vous pouvez ensuite ajouter des écouteurs d’événements sur ce composant au lieu d’avoir à les ajouter à chaque classe AsyncToken renvoyée. Ce composant conserve aussi la propriété lastResult, qui est une copie de la valeur renvoyée par le dernier événement event réussi distribué par un jeton que ce service surveille. Bien que vous puissiez effectuer une liaison à la méthode callResponder.token.result ou callResponder.lastResult, la seconde est préservée pendant qu’un second appel au même service est en cours, alors que la première est réinitialisée dès que démarre une nouvelle invocation de service.

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		lastResult : * Cette propriété stocke la propriété result du jeton chaque fois qu’elle livre un résultat réussi.	CallResponder
		token : mx.rpc:AsyncToken Chaque classe CallResponder distribue le résultat et les événements fault reçus d’un jeton unique.	CallResponder

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		fault(data:Object):void Cette méthode est appelée par la classe AsyncToken lorsqu’elle désire livrer un événement FaultEvent à la classe CallResponder.	CallResponder
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		result(data:Object):void Cette méthode est appelée par la classe AsyncToken lorsqu’elle désire livrer un événement ResultEvent à la classe CallResponder.	CallResponder
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
fault	Distribué lorsqu’une opération échoue.	CallResponder
result	Distribué lorsqu’une invocation d’opération réussit.	CallResponder

Détails de la propriété

lastResult

propriété

lastResult:*

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Cette propriété stocke la propriété result du jeton chaque fois qu’elle livre un résultat réussi. Vous pouvez établir une liaison ou accéder à cette propriété à la place de la propriété token.result pour que votre code ne voie pas que cette valeur a été effacée lors du second appel et de l’appel suivant à une méthode de service spécifique. De plus, en cas d’erreur, cette valeur reste définie sur le dernier résultat réussi renvoyé par un jeton que cette classe CallResponder surveille.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Implémentation
public function get lastResult():*
public function set lastResult(value:any):void

token

propriété

token:mx.rpc:AsyncToken

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Chaque classe CallResponder distribue le résultat et les événements fault reçus d’un jeton unique. Cette valeur de propriété spécifie ce jeton. En règle générale, vous définissez cette propriété sur l’objet AsyncToken renvoyé par le service.

Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement propertyChange .

Implémentation
public function get token():mx.rpc:AsyncToken
public function set token(value:mx.rpc:AsyncToken):void

Détails de la méthode

fault

()

méthode

public function fault(data:Object):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Cette méthode est appelée par la classe AsyncToken lorsqu’elle désire livrer un événement FaultEvent à la classe CallResponder. Vous n’appelez pas cette méthode directement.

Paramètres

data:Object — Evénement FaultEvent délivré par la classe AsyncToken.

result

()

méthode

public function result(data:Object):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Cette méthode est appelée par la classe AsyncToken lorsqu’elle désire livrer un événement ResultEvent à la classe CallResponder. Vous n’appelez pas cette méthode directement.

Paramètres

data:Object — Evénement ResultEvent délivré par la classe AsyncToken.

Détails de l’événement

fault

Evénement

Type d’objet d’événement: mx.rpc.events.FaultEvent
propriété FaultEvent.type = mx.rpc.events.FaultEvent.FAULT

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsqu’une opération échoue.

Type d’événement FAULT.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	true, appeler preventDefault() à partir de la méthode responder.fault du jeton associé empêchera le service ou l’opération de distribuer cet événement.
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`fault`	Objet d’erreur contenant les détails relatifs à l’élément ayant provoqué l’événement.
`message`	Message associé à cet événement.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.
`token`	Jeton représentant l’appel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.

result

Evénement

Type d’objet d’événement: mx.rpc.events.ResultEvent
propriété ResultEvent.type = mx.rpc.events.ResultEvent.RESULT

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Distribué lorsqu’une invocation d’opération réussit.

Type d’événement RESULT.

Les valeurs des propriétés de l’objet d’événement sont les suivantes :

Propriété	Valeur
`bubbles`	false
`cancelable`	true, preventDefault() de la méthode responder.fault du jeton associé empêchera le service ou l’opération de distribuer cet événement.
`currentTarget`	Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez `myButton.addEventListener()` pour enregistrer un écouteur d’événement, myButton est la valeur de `currentTarget`.
`message`	Message associé à cet événement.
`target`	Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.
`result`	Résultat que l’appel RPC renvoie.
`token`	Jeton représentant l’appel individuel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.

Informations juridiques | Politique de confidentialité en ligne

CallResponder - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.rpc

lastResult

token

fault

result

fault

result