| Package | mx.rpc.soap.mxml |
| Classe | public dynamic class WebService |
| Héritage | WebService  WebService AbstractWebService AbstractService Proxy |
| Implémente | IMXMLSupport, IMXMLObject |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Afficher la syntaxe MXML
Masquer la syntaxe MXMLThe <mx:WebService> tag accepts the following tag attributes:
<mx:WebService Properties concurrency="multiple|single|last" destination="No default." id="No default." serviceName="No default." showBusyCursor="false|true" makeObjectsBindable="false|true" useProxy="false|true" wsdl="No default." Events fault="No default." result="No default." />
An <mx:WebService> tag can have multiple <mx:operation> tags, which have the following tag attributes:
<mx:operation Properties concurrency="multiple|single|last" name=No default, required. resultFormat="object|xml|e4x" makeObjectsBindable="false|true" Events fault=No default. result=No default. />An <mx:Operation> tag contains an <mx:request> tag. To specify an XML structure in an <mx:request> tag, you must set the value of the tag's
format attribute to "xml". Otherwise, the body is converted into Objects.
Propriétés publiques
| Propriété | Défini par | ||
|---|---|---|---|
 | channelSet : ChannelSet
Fournit un accès à la classe ChannelSet utilisée par le service. | AbstractService | |
| concurrency : String
Valeur indiquant comment traiter plusieurs appels au même service. | WebService | ||
| convertParametersHandler : Function
Fonction facultative, destinée essentiellement aux développeurs de structure qui doivent installer une fonction devant être appelée avec les paramètres transmis à chaque invocation d’opération webservice. | AbstractWebService | |
| convertResultHandler : Function
Fonction facultative, destinée essentiellement aux développeurs de structure qui doivent installer un crochet pour traiter les résultats d’une opération avant de notifier les gestionnaires de résultats. | AbstractWebService | |
| description : String
Description du service du port actuellement actif. | AbstractWebService | |
| destination : String [override]
Destination du service. | AbstractWebService | |
| endpointURI : String
Emplacement de la classe WebService. | AbstractWebService | |
| headers : Array [lecture seule]
Renvoie le tableau d’en-têtes SOAPHeader enregistrés pour la classe WebService. | AbstractWebService | |
| httpHeaders : Object
En-têtes HTTP personnalisés devant être envoyés à l’extrémité SOAP. | AbstractWebService | |
| makeObjectsBindable : Boolean
Lorsque cette valeur est true, les objets anonymes renvoyés sont forcés sur des objets liables. | AbstractWebService | |
| 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 | |
| port : String
Spécifie le port dans le document WSDL que cette classe WebService doit utiliser. | AbstractWebService | |
| protocol : String Déconseillé: Veuillez utiliser channelSet [écriture seule]
Déconseillé. Utilisez à la place la destination appropriée ou, si vous utilisez une URL, utilisez DefaultHTTP ou DefaultHTTPS. | WebService | ||
| ready : Boolean [lecture seule]
Spécifie si la classe WebService est prête à effectuer des demandes. | AbstractWebService | |
| requestTimeout : int
Fournit un accès au délai d’attente de demande en secondes pour les messages envoyés. | AbstractService | |
| rootURL : String
Adresse URL que la classe WebService doit utiliser lorsqu’elle calcule des adresses URL relatives. | AbstractWebService | |
| service : String
Spécifie le service dans le document WSDL que cette classe WebService doit utiliser. | AbstractWebService | |
| serviceName : String Déconseillé: Veuillez utiliser destination | WebService | ||
| showBusyCursor : Boolean
Si true, un curseur occupé s’affiche lors de l’exécution d’un service. | WebService | ||
| useProxy : Boolean
Indique d’utiliser ou non le service proxy Flex. | AbstractWebService | |
| wsdl : String
Emplacement du document WSDL de cette classe WebService. | WebService | |
| xmlSpecialCharsFilter : Function
Fonction personnalisée à utiliser pour ignorer les caractères spéciaux XML avant de coder un contenu simple. | AbstractWebService | |
Méthodes publiques
| Méthode | Défini par | ||
|---|---|---|---|
WebService(destination:String = null)
Crée un nouveau composant WebService. | WebService | ||
|
Ajoute un en-tête qui sera appliqué à toutes les opérations de cette classe WebService. | AbstractWebService | |
| addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
Ajoute un en-tête qui sera appliqué à toutes les opérations de cette classe WebService. | AbstractWebService | |
|
Renvoie une valeur booléenne qui indique si la classe WebService est prête à charger un document WSDL (si elle est associée à une destination ou à un document WSDL valide). | WebService | |
|
Efface les en-têtes qui s’appliquaient à toutes les opérations. | AbstractWebService | |
|
Déconnecte la connexion réseau du service et supprime les répondeurs de demandes en attente. | AbstractService | |
|
Renvoie un en-tête si une correspondance est trouvée en fonction de QName, de localName et de URI. | AbstractWebService | |
[override]
Renvoie une opération du nom donné. | WebService | ||
|
Appelé pour initialiser le service. | AbstractService | |
Appelé automatiquement par le compilateur MXML lorsque la classe WebService est configurée à l’aide d’une balise. | WebService | ||
|
Indique à la classe WebService de télécharger le document WSDL. | WebService | |
|
Déconnecte l’utilisateur de la destination. | AbstractService | |
|
Supprime de toutes les opérations l’en-tête portant le nom QName donné. | AbstractWebService | |
|
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 | |
| [override]
Nom d’utilisateur et mot de passe utilisés pour authentifier un utilisateur qui accède au service Web. | AbstractWebService | |
|
Représente une instance de la classe WebService en tant que chaîne et décrit des propriétés importantes telles que l’ID de destination et la classe ChannelSet assigné. | WebService | |
Méthodes protégées
Evénements
Constantes publiques
Détails de la propriété
concurrency | propriété |
concurrency:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Valeur indiquant comment traiter plusieurs appels au même service. La valeur par défaut est multiple. Les valeurs suivantes sont autorisées :
- multiple - Les demandes existantes ne sont pas annulées et il incombe au développeur de vérifier la cohérence des données renvoyées en gérant avec soin le flux d’événements. Il s’agit de la valeur par défaut.
- single - N’effectuer qu’une demande à la fois est autorisé sur la méthode ; les demandes supplémentaires effectuées alors qu’une demande est en attente génèrent immédiatement une erreur sur le client et ne sont pas envoyées au serveur.
- last - Si une demande est effectuée, le client ignore un résultat ou une erreur pour une demande en attente actuelle. Seul le résultat ou seule l’erreur pour la demande la plus récente sera distribuée au client. Cela peut simplifier la gestion des événements dans l’application client, mais prenez soin de n’utiliser ce mode que si les résultats ou erreurs des demandes peuvent être ignorés sans risque.
Implémentation
public function get concurrency():String public function set concurrency(value:String):voidprotocol | propriété |
protocol:String [écriture seule] Déconseillé: Veuillez utiliser channelSet
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Déconseillé. Utilisez à la place la destination appropriée ou, si vous utilisez une URL, utilisezDefaultHTTP ou DefaultHTTPS. Le comportement déconseillé met simplement à jour la destination si la valeur par défaut est utilisée.
Implémentation
public function set protocol(value:String):voidserviceName | propriété |
serviceName:StringDéconseillé: Veuillez utiliser destination
Implémentation
public function get serviceName():String public function set serviceName(value:String):voidshowBusyCursor | propriété |
showBusyCursor:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Si true, un curseur occupé s’affiche lors de l’exécution d’un service. La valeur par défaut est false.
Implémentation
public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):voidDétails du constructeur
WebService | () | Constructeur |
public function WebService(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 |
Crée un nouveau composant WebService.
Paramètresdestination:String (default = null) |
Détails de la méthode
getOperation | () | méthode |
override 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, une nouvelle opération mx.rpc.soap.mxml.Operation est créée lors de 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.
|
initialized | () | méthode |
public function initialized(document:Object, id:String):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é automatiquement par le compilateur MXML lorsque la classe WebService est configurée à l’aide d’une balise. Si vous créez la classe WebService via ActionScript, vous pouvez appeler cette méthode vous-même car elle est utile pour valider des arguments.
Paramètres
document:Object — Document MXML dans lequel cette classe WebService réside.
| |
id:String — ID de cette classe WebService au sein de ce document.
|
Exemples Comment utiliser cet exemple
WebServiceExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the WebService tag. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<!-- Make sure the Flex Data Services proxy-config.xml file contains
the following definition:
<destination id="DefaultHTTP">
<properties>
<dynamic-url>http://ws.invesbot.com</dynamic-url>
</properties>
</destination>
-->
<fx:Script>
<![CDATA[
import mx.controls.Alert;
]]>
</fx:Script>
<fx:Declarations>
<mx:WebService id="WS" wsdl="http://ws.invesbot.com/stockquotes.asmx?WSDL"
useProxy="true"
fault="Alert.show(event.fault.faultString), 'Error'">
<mx:operation name="GetQuote" resultFormat="object">
<mx:request>
<symbol>{stockSymbol.text}</symbol>
</mx:request>
</mx:operation>
</mx:WebService>
</fx:Declarations>
<mx:Panel title="WebService Example" height="75%" width="75%"
paddingTop="10" paddingBottom="10" paddingLeft="10" paddingRight="10">
<mx:Label width="100%" color="blue"
text="Enter a stock symbol to obtain a quote."/>
<mx:TextInput id="stockSymbol" text="ADBE"/>
<mx:Button label="Get Quote" click="WS.GetQuote.send()"/>
<mx:Text htmlText="Company: {WS.GetQuote.lastResult.GetQuoteResult.StockQuote.Company}"/>
<mx:Text htmlText="Current price: ${WS.GetQuote.lastResult.GetQuoteResult.StockQuote.Price}"/>
</mx:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z