AbstractWebService

Paket	mx.rpc.soap
Klasse	public class AbstractWebService
Vererbung	AbstractWebService AbstractService Proxy
Unterklassen	WebService

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

AbstractWebService ist eine abstrakte Basisklasse für Implementierungen, die RPC-Zugriff auf SOAP-basierte Webdienste bieten. Diese Klasse lädt keine WSDL-Beschreibungen während der Laufzeit.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		channelSet : ChannelSet Gibt Zugriff auf den vom Dienst verwendeten ChannelSet.	AbstractService
		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
		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
		useProxy : Boolean Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll.	AbstractWebService
		xmlSpecialCharsFilter : Function Benutzerdefinierte Funktion, die dazu verwendet wird, um XML-Sonderzeichen in Escape-Zeichen umzuwandeln, bevor ein einfacher Inhalt kodiert wird.	AbstractWebService

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		AbstractWebService(destination:String = null, rootURL:String = null) Erstellt einen neuen WebService.	AbstractWebService
		addHeader(header:Object):void 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
		clearHeaders():void Löscht die Header, die auf alle Vorgänge angewandt wurden.	AbstractWebService
		disconnect():void Trennt die Netzverbindung des Dienstes und entfernt sämtliche anstehende Anforderungsresponder.	AbstractService
		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 Gibt einen Vorgang mit dem jeweiligen Namen zurück.	AbstractService
		initialize():void Aufgerufen, um den Dienst zu initialisieren.	AbstractService
		logout():void Meldet den Benutzer vom Ziel ab.	AbstractService
		removeHeader(qname:QName, headerName:String = null):void Entfernt den Header mit dem entsprechenden QName aus allen Vorgängen.	AbstractWebService
		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
		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

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
fault	Das Fehlerereignis wird ausgelöst, wenn ein Dienstaufruf fehlschlägt und nicht vom Vorgang selbst verarbeitet wird.	AbstractService
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
result	Das Ergebnisereignis wird ausgelöst, wenn ein Dienstaufruf erfolgreich ist und nicht vom Vorgang selbst verarbeitet wird.	AbstractService

Öffentliche Konstanten

	Konstante		Definiert von
		DEFAULT_DESTINATION_HTTP : String = "DefaultHTTP" [statisch] Das Standardziel für HTTP-Verbindungen, wenn ein Webdienst über einen Proxy aufgerufen wird.	AbstractWebService
		DEFAULT_DESTINATION_HTTPS : String = "DefaultHTTPS" [statisch] Das Standardziel für HTTPS-Verbindungen, wenn ein Webdienst über einen Proxy aufgerufen wird.	AbstractWebService

Eigenschaftendetails

convertParametersHandler

Eigenschaft

public var convertParametersHandler:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Optional; hauptsächlich für Frameworkentwickler bestimmt, die eine Funktion benötigen, deren Parameter bei jedem Remoteobjektaufruf aufgerufen werden. Die Funktion verwendet ein Parameter-Array und gibt das möglicherweise geänderte Array zurück. Die Funktion sollte wie folgt definiert werden: function myParametersFunction(parameters:Array):Array

convertResultHandler

Eigenschaft

public var convertResultHandler:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

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. Die Funktion sollte wie folgt definiert werden: function myConvertResultsFunction(result: operation:AbstractOperation): Das Ergebnis wird gleich nach der makeObjectsBindable-Konvertierung übergeben, aber bevor das Ergebnisereignis erstellt wird.

description

Eigenschaft

description:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Beschreibung dieses Dienstes für den aktuell aktiven Port.

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

destination

Eigenschaft

destination:String[override]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Ziel des Dienstes. Dieser Wert sollte mit einem Zielnamen in der services-config.xml-Datei übereinstimmen.

Implementierung
override public function get destination():String
override public function set destination(value:String):void

endpointURI

Eigenschaft

endpointURI:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Position des WebService. In der Regel gibt das WSDL-Dokument die Position des Dienstes an; Sie können jedoch diese Eigenschaft so einstellen, dass diese Position überschrieben wird.

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

headers

Eigenschaft

headers:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt das Array der SOAPHeader zurück, die für den WebService registriert wurden.

Implementierung
public function get headers():Array

httpHeaders

Eigenschaft

httpHeaders:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Benutzerdefinierte HTTP-Header, die an den SOAP-Endpunkte gesendet werden sollen. Wenn mehrere Header mit demselben Namen übermittelt werden sollen, muss der Wert als Array definiert werden.

Implementierung
public function get httpHeaders():Object
public function set httpHeaders(value:Object):void

makeObjectsBindable

Eigenschaft

makeObjectsBindable:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.

Implementierung
public function get makeObjectsBindable():Boolean
public function set makeObjectsBindable(value:Boolean):void

port

Eigenschaft

port:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt den Port im WSDL-Dokument fest, der von diesem WebService verwendet werden soll.

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

ready

Eigenschaft

ready:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob der WebService für Anforderungen bereit ist.

Implementierung
public function get ready():Boolean

rootURL

Eigenschaft

rootURL:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die URL, die der WebService bei der Verarbeitung relativer URLs verwenden soll. Diese Eigenschaft wird nur bei Verwendung eines Proxys verwendet. Wenn die useProxy-Eigenschaft auf false eingestellt ist, wird die relative URL automatisch aufgrund der Position der SWF-Datei berechnet, die diese Anwendung ausführt. Wenn nicht ausdrücklich ausgewählt, wird rootURL automatisch auf die URL der mx.messaging.config.LoaderConfig.url eingestellt.

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

service

Eigenschaft

service:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt den Dienst im WSDL-Dokument fest, der von diesem WebService verwendet werden soll.

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

useProxy

Eigenschaft

useProxy:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt an, ob der Flex-Proxy-Dienst verwendet werden soll. Der Standardwert ist false. Wenn Sie nicht true für Proxy-Anforderungen über den Flex-Server angeben, müssen Sie sicherstellen, dass Flash Player die Ziel-URL erreichen kann. Sie können auch keine in der services-config.xml-Datei definierten Ziele verwenden, wenn die useProxy-Eigenschaft auf false eingestellt ist.

Der Standardwert ist false.

Implementierung
public function get useProxy():Boolean
public function set useProxy(value:Boolean):void

xmlSpecialCharsFilter

Eigenschaft

xmlSpecialCharsFilter:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Benutzerdefinierte Funktion, die dazu verwendet wird, um XML-Sonderzeichen in Escape-Zeichen umzuwandeln, bevor ein einfacher Inhalt kodiert wird. Gültig für alle Vorgänge auf dem Webdienst, es sei denn sie wird für einen bestimmten Vorgang überschrieben. In Ermangelung einer Angabe entspricht die Standardfunktion der Einstellung der entsprechenden IXMLEncoder-Implementierung.

Implementierung
public function get xmlSpecialCharsFilter():Function
public function set xmlSpecialCharsFilter(value:Function):void

Konstruktordetails

()

Konstruktor

public function AbstractWebService(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. Dies sollte mit einem Zielnamen in der services-config.xml-Datei übereinstimmen.

	`rootURL:String` (default = `null`) — Die URL, die der WebService bei der Verarbeitung relativer URLs verwenden soll.

Methodendetails

addHeader

()

Methode

public function addHeader(header:Object):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Header hinzu, der auf alle Vorgänge dieses Webdienstes angewandt wird. Der Header kann in vorkodierter Form als XML-Instanz bereitgestellt werden oder als SOAPHeader-Instanz, bei der die Kodierung dem SOAP-Encoder überlassen wird.

Parameter

header:Object — Der SOAP-Header, der allen Vorgängen hinzugefügt werden soll.

addSimpleHeader

()

Methode

public function addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Fügt einen Header hinzu, der auf alle Vorgänge dieses WebService angewandt wird.

Parameter

	`qnameLocal:String` — Localname des Header-QName.

	`qnameNamespace:String` — Namespace des Header-QName.

	`headerName:String` — Der Name des Headers.

	`headerValue:String` — Der Wert des Headers.

clearHeaders

()

Methode

public function clearHeaders():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löscht die Header, die auf alle Vorgänge angewandt wurden.

getHeader

()

Methode

public function getHeader(qname:QName, headerName:String = null):SOAPHeader

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt einen Header zurück, wenn ein Ergebnis auf Grund von QName, localName und URI gefunden wurde.

Parameter

	`qname:QName` — QName des SOAPHeader.

	`headerName:String` (default = `null`) — (Optionaler) Name eines Headers im SOAPHeader-Inhalt.

Rückgabewerte

SOAPHeader — Gibt einen Header zurück, wenn ein Ergebnis auf Grund von QName, localName und URI gefunden wurde.

removeHeader

()

Methode

public function removeHeader(qname:QName, headerName:String = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Entfernt den Header mit dem entsprechenden QName aus allen Vorgängen.

Parameter

	`qname:QName` — QName des SOAPHeader.

	`headerName:String` (default = `null`) — (Optionaler) Name eines Headers im SOAPHeader-Inhalt.

setRemoteCredentials

()

Methode

override public function setRemoteCredentials(remoteUsername:String, remotePassword:String, charset:String = null):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der Benutzername und das Kennwort für die Authentifizierung eines Benutzers beim Zugriff auf den Webdienst. Diese werden vom Proxy als Bestandteil des HTTP-Berechtigungs-Headers dem Endpunkt übergeben. Wenn die useProxy-Eigenschaft auf false eingestellt ist, wird diese Eigenschaft ignoriert.

Parameter

	`remoteUsername:String` — Der dem Remoteendpunkt zu übergebende Benutzername.

	`remotePassword:String` — Das dem Remoteendpunkt zu übergebende Kennwort.

	`charset:String` (default = `null`) — Die für die Kodierung der Remotedaten zu verwendende Zeichensatzkodierung. Der Standardwert ist null, d. h. dass der ältere Zeichensatz ISO Lateinisch-1 unterstützt wird. Der einzige unterstützte Zeichensatz ist „UTF-8“.

Konstantendetails

DEFAULT_DESTINATION_HTTP

Konstante

public static const DEFAULT_DESTINATION_HTTP:String = "DefaultHTTP"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Standardziel für HTTP-Verbindungen, wenn ein Webdienst über einen Proxy aufgerufen wird. Wenn Sie kein Ziel angeben und die useProxy-Eigenschaft auf true setzen, werden die Standardziele verwendet, um die Anforderungen an den Webdienst-Endpunkt weiterzuleiten.

Beachten Sie, dass bei Verwendung der Standardziele WSDL- und endpointURI des Clients angegeben werden müssen. Wenn Sie ein nicht standardmäßiges Proxyziel verwenden, können WSDL- und endpointURI in der Zielkonfiguration angegeben werden.

DEFAULT_DESTINATION_HTTPS

Konstante

public static const DEFAULT_DESTINATION_HTTPS:String = "DefaultHTTPS"

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Das Standardziel für HTTPS-Verbindungen, wenn ein Webdienst über einen Proxy aufgerufen wird. Wenn Sie kein Ziel angeben und die useProxy-Eigenschaft auf true setzen, werden die Standardziele verwendet, um die Anforderungen an den Webdienst-Endpunkt weiterzuleiten.

Rechtliche Hinweise | Onlinedatenschutzerklärung

AbstractWebService - AS3 Flex

Klassen x

convertParametersHandler

convertResultHandler

description

destination

endpointURI

headers

httpHeaders

makeObjectsBindable

port

ready

rootURL

service

useProxy

xmlSpecialCharsFilter