| Paket | mx.rpc.soap.mxml |
| Klasse | public dynamic class WebService |
| Vererbung | WebService  WebService AbstractWebService AbstractService Proxy |
| Implementiert | IMXMLSupport, IMXMLObject |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
MXML-Syntax anzeigen
MXML-Syntax ausblendenThe <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.
Öffentliche Eigenschaften
| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | channelSet : ChannelSet
Gibt Zugriff auf den vom Dienst verwendeten ChannelSet. | AbstractService | |
| concurrency : String
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. | WebService | ||
| convertParametersHandler : Function
Optional; hauptsächlich für Frameworkentwickler bestimmt, die eine Funktion benötigen, deren Parameter bei jedem Remoteobjektaufruf aufgerufen werden. | AbstractWebService | |
| convertResultHandler : Function
Eine optionale Funktion, die hauptsächlich für Frameworkentwickler bestimmt ist, die einen Hook installieren möchten, um die Ergebnisse eines Vorgangs zu verarbeiten, bevor die Ergebnisprozeduren benachrichtigt werden. | AbstractWebService | |
| description : String
Die Beschreibung dieses Dienstes für den aktuell aktiven Port. | AbstractWebService | |
| destination : String [override]
Das Ziel des Dienstes. | AbstractWebService | |
| endpointURI : String
Die Position des WebService. | AbstractWebService | |
| headers : Array [schreibgeschützt]
Gibt das Array der SOAPHeader zurück, die für den WebService registriert wurden. | AbstractWebService | |
| httpHeaders : Object
Benutzerdefinierte HTTP-Header, die an den SOAP-Endpunkte gesendet werden sollen. | AbstractWebService | |
| makeObjectsBindable : Boolean
Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen. | AbstractWebService | |
| managers : Array
In der Managereigenschaft wird eine Liste der Datenmanager gespeichert, die das Verhalten dieses Dienstes modifizieren. | AbstractService | |
| operations : Object
Das Array von Vorgängen wird in der Regel nur vom MXML-Compiler gesetzt, wenn Sie einen Dienst mithilfe eines MXML-Tags erstellen. | AbstractService | |
| port : String
Legt den Port im WSDL-Dokument fest, der von diesem WebService verwendet werden soll. | AbstractWebService | |
| protocol : String Veraltet: Verwenden Sie channelSet [Nur Schreiben]
Veraltet; verwenden Sie das geeignete Ziel oder, im Falle einer URL, die DefaultHTTP oder DefaultHTTPS. | WebService | ||
| ready : Boolean [schreibgeschützt]
Gibt an, ob der WebService für Anforderungen bereit ist. | AbstractWebService | |
| requestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen. | AbstractService | |
| rootURL : String
Die URL, die der WebService bei der Verarbeitung relativer URLs verwenden soll. | AbstractWebService | |
| service : String
Legt den Dienst im WSDL-Dokument fest, der von diesem WebService verwendet werden soll. | AbstractWebService | |
| serviceName : String Veraltet: Verwenden Sie destination | WebService | ||
| showBusyCursor : Boolean
Wenn die Einstellung „true“ ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. | WebService | ||
| useProxy : Boolean
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. | AbstractWebService | |
| wsdl : String
Die Position des WSDL-Dokuments für diesen Vorgang. | WebService | |
| xmlSpecialCharsFilter : Function
Benutzerdefinierte Funktion, die dazu verwendet wird, um XML-Sonderzeichen in Escape-Zeichen umzuwandeln, bevor ein einfacher Inhalt kodiert wird. | AbstractWebService | |
Öffentliche Methoden
| Methode | Definiert von | ||
|---|---|---|---|
WebService(destination:String = null)
Erstellt eine neue WebService-Komponente. | WebService | ||
|
Fügt einen Header hinzu, der auf alle Vorgänge dieses Webdienstes angewandt wird. | AbstractWebService | |
| addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void
Fügt einen Header hinzu, der auf alle Vorgänge dieses WebService angewandt wird. | AbstractWebService | |
|
Gibt einen booleschen Wert zurück, der angibt, ob der WebService bereit ist, eine WSDL zu laden (wurde ein gültiges Ziel oder eine wsdl angegeben?). | WebService | |
|
Löscht die Header, die auf alle Vorgänge angewandt wurden. | AbstractWebService | |
|
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder. | AbstractService | |
|
Gibt einen Header zurück, wenn ein Ergebnis auf Grund von QName, localName und URI gefunden wurde. | AbstractWebService | |
[override]
Gibt einen Vorgang mit dem jeweiligen Namen zurück. | WebService | ||
|
Aufgerufen, um den Dienst zu initialisieren. | AbstractService | |
Automatisch vom MXML-Compiler aufgerufen, wenn der WebService mithilfe eines Tags eingerichtet wird. | WebService | ||
|
Weist den WebService an, das WSDL-Dokument herunterzuladen. | WebService | |
|
Meldet den Benutzer vom Ziel ab. | AbstractService | |
|
Entfernt den Header mit dem entsprechenden QName aus allen Vorgängen. | AbstractWebService | |
|
Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden. | AbstractService | |
| [override]
Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf den Webdienst. | AbstractWebService | |
|
Stellt eine WebService-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt. | WebService | |
Geschützte Methoden
Ereignisse
Öffentliche Konstanten
Eigenschaftendetails
concurrency | Eigenschaft |
concurrency:String| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen. Der Standardwert lautet „multiple“. Folgende Werte sind zulässig:
- „multiple“ - Existierende Anforderungen werden nicht gelöscht, der Entwickler ist dafür verantwortlich, dass die Kohärenz der Daten sichergestellt ist, indem er den Ereignis-Stream aufmerksam verwaltet. Dies ist die Standardeinstellung.
- „single“ - Es ist jeweils nur eine einzelne Anforderungen für die Methode zulässig; zusätzliche Anforderungen während eine Anforderung ansteht, erzeugen sofort einen Fehler auf dem Client und werden nicht an den Server übermittelt.
- „last“ - Eine Anforderung führt dazu, dass der Client ein Ergebnis oder einen Fehler für jegliche aktuelle anstehenden Anforderungen ignoriert. Nur das Ergebnis oder der Fehler der neuesten Anforderung wird auf dem Client ausgelöst. Dies kann die Ereignisverwaltung in der Clientanwendung vereinfachen, Sie sollten jedoch besonders darauf achten, dass dieser Modus nur dann verwendet wird, wenn Ergebnisse oder Fehler für Anforderungen gefahrlos ignoriert werden können.
Implementierung
public function get concurrency():String public function set concurrency(value:String):voidprotocol | Eigenschaft |
protocol:String [Nur Schreiben] Veraltet: Verwenden Sie channelSet
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Veraltet; verwenden Sie das angemessene Ziel oder, im Falle einer URL, DefaultHTTP oder DefaultHTTPS. Bei Verwendung der Standardeinstellung aktualisiert das veraltete Verhalten einfach das Ziel.
Implementierung
public function set protocol(value:String):voidserviceName | Eigenschaft |
serviceName:StringVeraltet: Verwenden Sie destination
Implementierung
public function get serviceName():String public function set serviceName(value:String):voidshowBusyCursor | Eigenschaft |
showBusyCursor:Boolean| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Wenn die Einstellung true ist, wird ein Aktivitäten-Cursor angezeigt, während ein Dienst ausgeführt wird. Der Standardwert ist false.
Implementierung
public function get showBusyCursor():Boolean public function set showBusyCursor(value:Boolean):voidKonstruktordetails
WebService | () | Konstruktor |
public function WebService(destination:String = null)| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Erstellt eine neue WebService-Komponente.
Parameterdestination:String (default = null) |
Methodendetails
getOperation | () | Methode |
override public function getOperation(name:String):AbstractOperation| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Gibt einen Vorgang mit dem jeweiligen Namen zurück. Wenn der Vorgang nicht vorher erstellt wurde, wird während dieses Aufrufs ein neuer mx.rpc.soap.mxml.Operation erstellt. Sie können in der Regel auf Vorgänge zugreifen, indem Sie sie einfach nach der Dienstvariable (mx.rpc.soap.mxml.Operation) benennen, doch wenn der Vorgangsname mit einer definierten Methode im Dienst übereinstimmt (z. B. setCredentials), können Sie diese Methode für den Zugriff auf den Vorgang verwenden.
Parameter
name:String — Name des Vorgangs.
|
AbstractOperation — Für diesen Namen ausgeführter Vorgang.
|
initialized | () | Methode |
public function initialized(document:Object, id:String):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flex 3 |
| Laufzeitversionen: | Flash Player 9, AIR 1.1 |
Automatisch vom MXML-Compiler aufgerufen, wenn der WebService mithilfe eines Tags eingerichtet wird. Wenn Sie einen WebService über ActionScript erstellen, können Sie diese Methode aufrufen, da sie zum Überprüfen von Argumenten nützlich ist.
Parameter
document:Object — das MXML-Dokument, in dem sich der WebService befindet
| |
id:String — die ID des WebService im Dokument
|
Beispiele Verwendung dieses Beispiels
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, 10:04 AM Z