AbstractService

Package	mx.rpc
Classe	public dynamic class AbstractService
Héritage	AbstractService Proxy
Implémente	IEventDispatcher
Sous-classes	AbstractWebService, HTTPMultiService, ManagedRemoteService, RemoteObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

La classe AbstractService est la classe de base des classes HTTPMultiService, WebService et RemoteObject. Cette classe crée des opérations qui procèdent à l’exécution réelle des appels de procédures distantes.

Propriétés publiques

	Propriété		Défini par
		channelSet : ChannelSet Fournit un accès à la classe ChannelSet utilisée par le service.	AbstractService
		destination : String Destination du service.	AbstractService
		managers : Array La propriété managers stocke une liste de gestionnaires de données qui modifient le comportement de ce service.	AbstractService
		operations : Object En général, le tableau Operations n’est défini que par le compilateur MXML si vous créez un service à l’aide d’une balise MXML.	AbstractService
		requestTimeout : int Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés.	AbstractService

Méthodes publiques

	Méthode		Défini par
		AbstractService(destination:String = null) Constructeur.	AbstractService
		disconnect():void Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente.	AbstractService
		getOperation(name:String):AbstractOperation Renvoie une opération du nom donné.	AbstractService
		initialize():void Appelé pour initialiser le service.	AbstractService
		logout():void Déconnecte l’utilisateur de la destination.	AbstractService
		setCredentials(username:String, password:String, charset:String = null):void Définit les informations d’identification pour la destination à laquelle le service accède lors de l’utilisation des services de données côté serveur.	AbstractService
		setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void Nom d’utilisateur et mot de passe à utiliser pour authentifier un utilisateur lors de l’accès à une extrémité distante tierce telle qu’un service Web via un proxy ou un objet distant via un adaptateur personnalisé lors de l’utilisation de services de données côté serveur.	AbstractService

Evénements

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

	Synthèse	Défini par
fault	L’événement fault est distribué lorsqu’un appel de service échoue et n’est pas traité par l’opération elle-même.	AbstractService
invoke	L’événement invoke est déclenché lorsqu’une opération de service est invoquée à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message.	AbstractService
result	L’événement result est distribué lorsqu’un appel de service réussit et n’est pas traité par l’opération elle-même.	AbstractService

Détails de la propriété

channelSet

propriété

channelSet:ChannelSet

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Permet d’accéder à l’instance ChannelSet utilisée par le service. La classe ChannelSet peut être manuellement construite et assignée, ou elle sera dynamiquement créée afin d’utiliser les canaux configurés pour la destination de ce service.

Implémentation
public function get channelSet():ChannelSet
public function set channelSet(value:ChannelSet):void

destination

propriété

destination:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Destination du service. Cette valeur doit correspondre à une entrée de destination du fichier services-config.xml.

Implémentation
public function get destination():String
public function set destination(value:String):void

managers

propriété

managers:Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

La propriété managers stocke une liste de gestionnaires de données qui modifient le comportement de ce service. Vous pouvez utiliser ce crochet pour définir un ou plusieurs composants de gestionnaires associés à ce service. Lorsque cette propriété est définie, si les gestionnaires comportent une propriété nommée « service », cette propriété est définie sur la valeur de ce service. Lorsque ce service est initialisé, la méthode initialize est aussi appelée sur les composants de gestionnaires.

Implémentation
public function get managers():Array
public function set managers(value:Array):void

operations

propriété

operations:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

En général, le tableau Operations n’est défini que par le compilateur MXML si vous créez un service à l’aide d’une balise MXML.

Implémentation
public function get operations():Object
public function set operations(value:Object):void

requestTimeout

propriété

requestTimeout:int

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés. Une valeur égale ou inférieure à zéro empêche les délais d’attente de demande.

Implémentation
public function get requestTimeout():int
public function set requestTimeout(value:int):void

Détails du constructeur

()

Constructeur

public function AbstractService(destination:String = null)

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constructeur.

Paramètres

destination:String (default = null) — Destination du service.

Détails de la méthode

disconnect

()

méthode

public function disconnect():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente. Cette méthode n’attend pas que les opérations de réseau en attente se terminent.

getOperation

()

méthode

public function getOperation(name:String):AbstractOperation

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie une opération du nom donné. Si l’opération n’a pas été créée auparavant, les sous-classes sont chargées de la créer pendant cet appel. Pour accéder aux opérations, il suffit en général simplement de les nommer après la variable de service (myService.someOperation), mais si le nom de votre opération correspond à une méthode définie sur le service (par exemple, setCredentials), vous pouvez utiliser cette méthode pour obtenir l’opération à la place.

Paramètres

name:String — Nom affichable de l’opération.

Valeur renvoyée

AbstractOperation — Opération qui s’exécute pour ce nom.

initialize

()

méthode

public function initialize():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Appelé pour initialiser le service.

logout

()

méthode

public function logout():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Déconnecte l’utilisateur de la destination. La déconnexion d’une destination s’applique à tous les éléments connectés à l’aide de la même classe ChannelSet tel que spécifié dans la configuration de serveur. Par exemple, si vous êtes connecté via le canal my-rtmp et que vous vous déconnectez à l’aide de l’un de vos composants RPC, tous les éléments qui étaient connectés via la même classe ChannelSet sont déconnectés.

Remarque : Adobe vous recommande d’utiliser la méthode mx.messaging.ChannelSet.logout() au lieu de cette méthode.

Eléments de l’API associés

mx.messaging.ChannelSet.logout()

setCredentials

()

méthode

public function setCredentials(username:String, password:String, charset:String = null):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Définit les informations d’identification pour la destination à laquelle le service accède lors de l’utilisation des services de données côté serveur. Les informations d’identification sont appliquées à tous les services connectés via la même classe ChannelSet. Les services utilisant un proxy ou un adaptateur tiers sur une extrémité distante devront appeler la méthode setRemoteCredentials à la place.

Paramètres

	`username:String` — Nom d’utilisateur pour la destination.

	`password:String` — Mot de passe pour la destination.

	`charset:String` (default = `null`) — Codage de jeu de caractères à utiliser lors du codage des informations d’identification. La valeur par défaut est null, ce qui implique le jeu de caractères existant, ISO-Latin-1. Le seul autre jeu de caractères pris en charge est « UTF-8 ».

setRemoteCredentials

()

méthode

public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Nom d’utilisateur et mot de passe à utiliser pour authentifier un utilisateur lors de l’accès à une extrémité distante tierce telle qu’un service Web via un proxy ou un objet distant via un adaptateur personnalisé lors de l’utilisation de services de données côté serveur.

Paramètres

	`remoteUsername:String` — Nom d’utilisateur à transmettre à l’extrémité distante

	`remotePassword:String` — Mot de passe à transmettre à l’extrémité distante

	`charset:String` (default = `null`) — Codage de jeu de caractères à utiliser lors du codage des informations d’identification distantes. La valeur par défaut est null, ce qui implique le jeu de caractères existant, ISO-Latin-1. Le seul autre jeu de caractères pris en charge est « UTF-8 ».

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

L’événement fault est distribué lorsqu’un appel de service échoue et n’est pas traité par l’opération elle-même.

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.

invoke

Evénement

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

L’événement invoke est déclenché lorsqu’une opération de service est invoquée à condition qu’une erreur ne soit pas générée avant que le canal ne tente d’envoyer le message.

Type d’événement INVOKE.

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

Propriété	Valeur
`bubbles`	false
`token`	Jeton représentant l’appel individuel à la méthode. Utilisé dans le modèle de jeton d’achèvement asynchrone.
`cancelable`	true
`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 de demande 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

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

L’événement result est distribué lorsqu’un appel de service réussit et n’est pas traité par l’opération elle-même.

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

AbstractService - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.rpc

channelSet

destination

managers

operations

requestTimeout