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 

WebService  - AS3 Flex

Paketmx.rpc.soap
Klassepublic dynamic class WebService
VererbungWebService Inheritance AbstractWebService Inheritance AbstractService Inheritance Proxy
Unterklassen WebService

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

Die WebService-Klasse gibt Zugriff auf SOAP-basierte Webdienste auf Remoteservern.



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 InheritedchannelSet : ChannelSet
Gibt Zugriff auf den vom Dienst verwendeten ChannelSet.
AbstractService
 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
 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
 InheriteduseProxy : Boolean
Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll.
AbstractWebService
  wsdl : 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, rootURL:String = null)
Erstellt einen neuen WebService.
WebService
 Inherited
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
  
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
Löscht die Header, die auf alle Vorgänge angewandt wurden.
AbstractWebService
 Inherited
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
  
[override] Gibt einen Vorgang mit dem jeweiligen Namen zurück.
WebService
 Inherited
Aufgerufen, um den Dienst zu initialisieren.
AbstractService
  
loadWSDL(uri:String = null):void
Weist den WebService an, das WSDL-Dokument herunterzuladen.
WebService
 Inherited
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
  
Stellt eine WebService-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt.
WebService
Geschützte Methoden
 MethodeDefiniert von
  
Initialisiert einen neuen Vorgang.
WebService
Ereignisse
 Ereignis Übersicht Definiert von
 InheritedDas Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird.AbstractService
 InheritedDas 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
  Die LoadEvent.LOAD-Klasse wird ausgelöst, wenn das WSDL-Dokument erfolgreich geladen wurde.WebService
 InheritedDas Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet wird.AbstractService
Öffentliche Konstanten
 KonstanteDefiniert von
  DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP"
[statisch]
WebService
  DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS"
[statisch]
WebService
Eigenschaftendetails

wsdl

Eigenschaft
wsdl:String

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

Die Position des WSDL-Dokuments für diesen Vorgang. Wenn Sie eine relative URL verwenden, stellen Sie sicher, dass die rootURL angegeben wurde bzw. dass der WebService in MXML erstellt wurde.



Implementierung
    public function get wsdl():String
    public function set wsdl(value:String):void
Konstruktordetails

WebService

()Konstruktor
public function WebService(destination:String = null, rootURL:String = null)

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

Erstellt einen neuen WebService. Bei Angabe des Ziels muss es mit der Angabe in services-config-xml übereinstimmen. Anderenfalls verwendet WebService das DefaultHTTP-Ziel. Die rootURL ist erforderlich, wenn Sie möchten, dass eine relative URL verwendet wird, um das WSDL-Dokument für diesen WebService zu finden.

Parameter
destination:String (default = null) — Das Ziel des WebService, das mit einem Zielnamen in der services-config.xml-Datei übereinstimmen sollte.
 
rootURL:String (default = null) — Die Root-URL des WebService.
Methodendetails

canLoadWSDL

()Methode
public function canLoadWSDL():Boolean

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

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?).

Rückgabewerte
Boolean — Gibt true zurück, wenn der WebService bereit ist, eine WSDL zu laden; andernfalls wird false zurückgegeben.

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

initializeOperation

()Methode 
protected function initializeOperation(operation:Operation):void

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

Initialisiert einen neuen Vorgang.

Parameter

operation:Operation — Der zu initialisierende Vorgang.

loadWSDL

()Methode 
public function loadWSDL(uri:String = null):void

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

Weist den WebService an, das WSDL-Dokument herunterzuladen. Der WebService nennt diese Methode automatisch „WebService“, wenn dies im WebService-MXML-Tag angegeben ist; er muss jedoch manuell benannt werden, wenn Sie das WebService-Objekt in ActionScript erstellen, nachdem Sie den destination- oder wsdl-Eigenschaftswert angegeben haben.

Parameter

uri:String (default = null) — Wenn das wsdl nicht vorher angegeben wurde, kann dies hier geschehen.

toString

()Methode 
public function toString():String

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

Stellt eine WebService-Instanz als String dar, der wichtige Eigenschaften, wie Ziel-ID und zugewiesene Kanäle beschreibt.

Rückgabewerte
String — Gibt eine Stringdarstellung des WebService zurück.
Ereignisdetails

load

Ereignis
Ereignisobjekttyp: mx.rpc.soap.LoadEvent
Eigenschaft LoadEvent.type = mx.rpc.soap.LoadEvent.LOAD

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

Die LoadEvent.LOAD-Klasse wird ausgelöst, wenn das WSDL-Dokument erfolgreich geladen wurde.

Die LOAD-Konstante definiert den Wert der type-Eigenschaft des Ereignisobjekts für ein load-Ereignis.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

EigenschaftWert
bubblesfalse
cancelabletrue
wsdlWSDL-Objekt.
locationURI des WSDL-Dokuments
Konstantendetails

DEFAULT_DESTINATION_HTTP

Konstante
public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"

DEFAULT_DESTINATION_HTTPS

Konstante 
public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"





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