ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
mx.rpc.soap.mxml 

WebService  - AS3 Flex
Paketmx.rpc.soap.mxml
Klassepublic dynamic class WebService
VererbungWebService Inheritance WebService Inheritance AbstractWebService Inheritance AbstractService Inheritance Proxy
Implementiert IMXMLSupport, IMXMLObject

Sprachversion: ActionScript 3.0
Produktversion: Flex 3
Laufzeitversionen: Flash Player 9, AIR 1.1

Das Tag <mx:WebService> gibt Zugriff auf die Vorgänge von SOAP-kompatiblen Webdiensten.

MXML-SyntaxexpandedMXML-Syntax ausblenden

The <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.

Beispiele anzeigen


Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedchannelSet : ChannelSet
Gibt Zugriff auf den vom Dienst verwendeten ChannelSet.
AbstractService
  concurrency : String
Wert, der angibt, wie mehrere Aufrufe desselben Dienstes verarbeitet werden sollen.
WebService
 InheritedconvertParametersHandler : Function
Optional; hauptsächlich für Frameworkentwickler bestimmt, die eine Funktion benötigen, deren Parameter bei jedem Remoteobjektaufruf aufgerufen werden.
AbstractWebService
 InheritedconvertResultHandler : 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
 Inheriteddescription : String
Die Beschreibung dieses Dienstes für den aktuell aktiven Port.
AbstractWebService
 Inheriteddestination : String
[override] Das Ziel des Dienstes.
AbstractWebService
 InheritedendpointURI : String
Die Position des WebService.
AbstractWebService
 Inheritedheaders : Array
[schreibgeschützt] Gibt das Array der SOAPHeader zurück, die für den WebService registriert wurden.
AbstractWebService
 InheritedhttpHeaders : Object
Benutzerdefinierte HTTP-Header, die an den SOAP-Endpunkte gesendet werden sollen.
AbstractWebService
 InheritedmakeObjectsBindable : Boolean
Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.
AbstractWebService
 Inheritedmanagers : Array
In der Managereigenschaft wird eine Liste der Datenmanager gespeichert, die das Verhalten dieses Dienstes modifizieren.
AbstractService
 Inheritedoperations : 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
 Inheritedport : 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
 Inheritedready : Boolean
[schreibgeschützt] Gibt an, ob der WebService für Anforderungen bereit ist.
AbstractWebService
 InheritedrequestTimeout : int
Gibt Zugriff auf die Zeitüberschreitung der Anforderung für übermittelte Meldungen.
AbstractService
 InheritedrootURL : String
Die URL, die der WebService bei der Verarbeitung relativer URLs verwenden soll.
AbstractWebService
 Inheritedservice : 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
 InheriteduseProxy : Boolean
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll.
AbstractWebService
 Inheritedwsdl : String
Die Position des WSDL-Dokuments für diesen Vorgang.
WebService
 InheritedxmlSpecialCharsFilter : Function
Benutzerdefinierte Funktion, die dazu verwendet wird, um XML-Sonderzeichen in Escape-Zeichen umzuwandeln, bevor ein einfacher Inhalt kodiert wird.
AbstractWebService
Öffentliche Methoden
 MethodeDefiniert von
  
WebService(destination:String = null)
Erstellt eine neue WebService-Komponente.
WebService
 Inherited
addHeader(header:Object):void
Fügt einen Header hinzu, der auf alle Vorgänge dieses Webdienstes angewandt wird.
AbstractWebService
 Inherited
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
 Inherited
canLoadWSDL():Boolean
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
 Inherited
clearHeaders():void
Löscht die Header, die auf alle Vorgänge angewandt wurden.
AbstractWebService
 Inherited
disconnect():void
Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder.
AbstractService
 Inherited
getHeader(qname:QName, headerName:String = null):SOAPHeader
Gibt einen Header zurück, wenn ein Ergebnis auf Grund von QName, localName und URI gefunden wurde.
AbstractWebService
  
getOperation(name:String):AbstractOperation
[override] Gibt einen Vorgang mit dem jeweiligen Namen zurück.
WebService
 Inherited
initialize():void
Aufgerufen, um den Dienst zu initialisieren.
AbstractService
  
initialized(document:Object, id:String):void
Automatisch vom MXML-Compiler aufgerufen, wenn der WebService mithilfe eines Tags eingerichtet wird.
WebService
 Inherited
loadWSDL(uri:String = null):void
Weist den WebService an, das WSDL-Dokument herunterzuladen.
WebService
 Inherited
logout():void
Meldet den Benutzer vom Ziel ab.
AbstractService
 Inherited
removeHeader(qname:QName, headerName:String = null):void
Entfernt den Header mit dem entsprechenden QName aus allen Vorgängen.
AbstractWebService
 Inherited
setCredentials(username:String, password:String, charset:String = null):void
Setzt die Benutzerdaten für den Zielpfad, auf den über den Dienst zugegriffen wird, wenn serverseitige Datendienste verwendet werden.
AbstractService
 Inherited
setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void
[override] Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf den Webdienst.
AbstractWebService
 Inherited
toString():String
Stellt eine WebService-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt.
WebService
Geschützte Methoden
 MethodeDefiniert von
 Inherited
initializeOperation(operation:Operation):void
Initialisiert einen neuen Vorgang.
WebService
Ereignisse
Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.
 Ereignis Übersicht Definiert von
 Inherited
fault
Das Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird.AbstractService
 Inherited
invoke
Das Aufrufereignis wird ausgelöst, wenn ein Dienstvorgang aufgerufen wird, es sei denn es wird ein Fehler ausgegeben, bevor der Kanal versucht, die Meldung zu schicken.AbstractService
 Inherited
load
Die LoadEvent.LOAD-Klasse wird ausgelöst, wenn das WSDL-Dokument erfolgreich geladen wurde.WebService
 Inherited
result
Das Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet wird.AbstractService
Öffentliche Konstanten
 KonstanteDefiniert von
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):void

protocol

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):void

serviceName

Eigenschaft 
serviceName:String
Veraltet: Verwenden Sie destination



Implementierung
    public function get serviceName():String
    public function set serviceName(value:String):void

showBusyCursor

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):void
Konstruktordetails

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.

Parameter
destination:String (default = null) — Das Ziel des WebService, das mit einem Zielnamen in der services-config.xml-Datei übereinstimmen sollte. Ohne entsprechende Angabe verwendet die WebService-Komponente das DefaultHTTP-Ziel.
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.

Rückgabewerte
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>



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.