| 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 |
| 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éthode | Défini par | ||
|---|---|---|---|
AbstractService(destination:String = null)
Constructeur. | AbstractService | ||
Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente. | AbstractService | ||
Renvoie une opération du nom donné. | AbstractService | ||
Appelé pour initialiser le service. | AbstractService | ||
Déconnecte l’utilisateur de la destination. | AbstractService | ||
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 | ||
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énement | Synthèse | Défini par | ||
|---|---|---|---|---|
| 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 | |||
| 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 | |||
| 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 | |||
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):voiddestination | 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):voidmanagers | 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):voidoperations | 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):voidrequestTimeout | 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):voidAbstractService | () | Constructeur |
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.
|
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
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) |
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) |
fault | Evénement |
mx.rpc.events.FaultEventproprié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 |
mx.rpc.events.InvokeEventproprié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 |
mx.rpc.events.ResultEventproprié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. |
Tue Jun 12 2018, 09:30 AM Z