Operation

Paket	mx.rpc.soap
Klasse	public class Operation
Vererbung	Operation AbstractOperation AbstractInvoker EventDispatcher Object
Unterklassen	Operation

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Vorgang, der speziell von WebServices verwendet wird. Ein Vorgang ist eine einzelne Methode in einem Dienst. Ein Vorgang kann entweder durch Aufrufen der Funktion mit demselben Namen im Dienst aufgerufen werden, oder durch den Zugriff auf den Vorgang als Eigenschaft im Dienst und durch Aufruf der send()-Methode.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		arguments : Object Die Argumente, die dem aufgerufenen Vorgang übergeben werden müssen.	AbstractOperation
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		endpointURI : String Die Position des WebService für diesen Vorgang.	Operation
		forcePartArrays : Boolean Bestimmt, ob ein einzelner oder leerer Rückgabewert eines als Array definierten Teils einer Meldung mit einem (bzw. keinem) Element zurückgegeben werden soll.	Operation
		headerFormat : String Bestimmt, wie SOAP-kodierte Header dekodiert werden.	Operation
		headers : Array [schreibgeschützt] Akzessor für ein Array von SOAPHeaders, die bei jedem Aufruf des Vorgangs gesendet werden.	Operation
		httpHeaders : Object Benutzerdefinierte HTTP-Header, die an den SOAP-Endpunkte gesendet werden sollen.	Operation
		ignoreWhitespace : Boolean Bestimmt, ob Leerräume bei der Verarbeitung der XML einer SOAP-kodierten Anforderung oder Antwort ignoriert werden.	Operation
		lastResult : Object [schreibgeschützt] Das Ergebnis des letzten Aufrufs.	AbstractInvoker
		makeObjectsBindable : Boolean [override] Wenn dieser Wert true ist, wird die Umwandlung zurückgegebener anonymer Objekte in bindbare Objekte erzwungen.	Operation
		multiplePartsFormat : String Bestimmt den Typ des Standardergebnisobjekts für Aufrufe des Webdienstes, die mehrere Teile in der ausgegebenen Meldung definieren.	Operation
		name : String Der Name des Vorgangs.	AbstractOperation
		operationManager : Function Diese Eigenschaft wird in der Regel vom Frameworkcode gesetzt, der das Verhalten eines Dienstaufrufs modifizieren will, damit der Dienst extern aufgerufen wird.	AbstractInvoker
		properties : Object Dieser Hook ist hauptsächlich für Frameworkentwickler zum Registrieren von zusätzlichen benutzerdefinierten Eigenschaften für den Vorgang gedacht.	AbstractOperation
		request : Object Die Anforderung des Vorgangs ist eine Objektstruktur oder eine XML-Struktur.	Operation
		resultElementType : Class Wie resultType; wird zum Definieren der ActionScript-Klasse verwendet, die von einem bestimmen Vorgang benutzt wird. Jedoch wird diese Eigenschaft nur auf Vorgänge angewandt, die ein mehrwertiges Ergebnis zurückgeben (z. B.	AbstractInvoker
		resultFormat : String Bestimmt, wie das Vorgangsergebnis dekodiert wird.	Operation
		resultHeaders : Array [schreibgeschützt] Die Header, die als Teil der letzten Ausführung des Vorgangs zurückgegeben wurden.	Operation
		resultType : Class Gibt einen optionalen Rückgabetyp für den Vorgang an.	AbstractInvoker
		service : AbstractService [schreibgeschützt] Bietet praktischen Zugriff auf den Dienst, in dem der Vorgang aufgerufen wird.	AbstractOperation
		xmlSpecialCharsFilter : Function Gibt eine benutzerdefinierte Funktion an, die dazu verwendet wird, um XML-Sonderzeichen in Escape-Zeichen umzuwandeln, bevor ein einfacher Inhalt kodiert wird.	Operation

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		Operation(webService:AbstractService = null, name:String = null) Erstellt einen neuen Vorgang.	Operation
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		addHeader(header:Object):void Fügt einen Header hinzu, der nur auf diesen Vorgang angewandt wird.	Operation
		addSimpleHeader(qnameLocal:String, qnameNamespace:String, headerName:String, headerValue:String):void Fügt einen Header hinzu, der nur auf diesen Vorgang angewandt wird.	Operation
		cancel(id:String = null):mx.rpc:AsyncToken [override] Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab.	Operation
		clearHeaders():void Löscht die Header für diesen einzelnen Vorgang.	Operation
		clearResult(fireBindingEvent:Boolean = true):void Setzt die Ergebniseigenschaft der aufrufenden Instanz auf null.	AbstractInvoker
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getHeader(qname:QName, headerName:String = null):SOAPHeader Gibt einen Header zurück, wenn eine Entsprechung auf Grund von QName, localName und URI gefunden wird.	Operation
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		removeHeader(qname:QName, headerName:String = null):void Entfernt den Header mit dem entsprechenden QName aus allen Vorgängen.	Operation
		send(... args):mx.rpc:AsyncToken Führt die Methode aus.	AbstractOperation
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setResult(result:Object):void Dieser Hook ist stellt die Aktualisierung der lastResult-Eigenschaft bereit.	AbstractInvoker
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
fault	Wird ausgelöst, wenn ein Vorgangsaufruf fehlschlägt.	AbstractOperation
header	Wird ausgelöst, wenn ein Vorgangsaufruf SOAP-Header in der Antwort zurückgibt.	Operation
result	Wird ausgelöst, wenn ein Vorgangsaufruf erfolgreich zurückgegeben wird.	AbstractOperation

Eigenschaftendetails

endpointURI

Eigenschaft

endpointURI:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Position des WebService für diesen Vorgang. In der Regel bestimmt WSDL die Position des Dienstes, Sie können jedoch diese Eigenschaft so einstellen, dass diese Position für einen einzelnen Vorgang überschrieben wird.

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

forcePartArrays

Eigenschaft

forcePartArrays:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, ob ein einzelner oder leerer Rückgabewert eines als Array definierten Teils einer Meldung mit einem (bzw. keinem) Element zurückgegeben werden soll. Dies gilt für document/literal „wrapped“-Webdienste, bei denen der maxOccurs-Attributwert eines Elements oder mehrerer Elemente, die einzelne Meldungsteile in der „wrapper“-Sequenz darstellen, größer als 1 sein kann. Dies ist ein Hinweis, dass der entsprechende Teil als Array behandelt werden soll, auch wenn die Antwort keinen oder einen Wert für diesen Teil enthält. Werden forcePartArrays auf true gesetzt, wird immer ein Array für auf diese Weise definierte Teile erstellt, unabhängig von der Anzahl der zurückgegebenen Werte. Wird forcePartArrays auf false belassen, werden Arrays nur bei Rückgabe von zwei oder mehr Elementen erstellt.

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

headerFormat

Eigenschaft

headerFormat:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, wie SOAP-kodierte Header dekodiert werden. Der object-Wert gibt an, dass jeder Header-XML-Knoten in ein SOAPHeader-Objekt dekodiert wird und dass die content-Eigenschaft eine Objektstruktur ist, wie im WSDL-Dokument angegeben. Der xml-Wert legt fest, dass XML als XMLNodes zu belassen ist. Der e4x-Wert legt fest, dass auf XML über ECMAScript für XML (E4X)-Ausdrücke zugegriffen werden kann.

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

headers

Eigenschaft

headers:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Akzessor für ein Array von SOAPHeaders, die bei jedem Aufruf des Vorgangs gesendet werden.

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

ignoreWhitespace

Eigenschaft

ignoreWhitespace:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, ob Leerräume bei der Verarbeitung der XML einer SOAP-kodierten Anforderung oder Antwort ignoriert werden. Der Standardwert ist true; Leerräume bleiben also nicht erhalten. Wenn in einer XML-Schematypdefinition eine whiteSpace-Einschränkung angegeben ist, die auf preserve gesetzt ist, muss ignoreWhitespace zuerst auf false gesetzt werden. Wenn hingegen eine whiteSpace-Einschränkung auf replace oder collapse eingestellt ist, dann muss diese Einstellung berücksichtigt werden, auch wenn ignoreWhitespace auf false gesetzt ist.

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

makeObjectsBindable

Eigenschaft

makeObjectsBindable:Boolean[override]

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
override public function get makeObjectsBindable():Boolean
override public function set makeObjectsBindable(value:Boolean):void

multiplePartsFormat

Eigenschaft

multiplePartsFormat:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt den Typ des Standardergebnisobjekts für Aufrufe des Webdienstes, die mehrere Teile in der ausgegebenen Meldung definieren. Der „object“-Wert gibt an, dass das lastResult-Objekt ein Objekt ist, dessen benannte Eigenschaften den einzelnen Ausgabeteilen entsprechen. Mit dem „array“-Wert wird das lastResult-Objekt zum Array, in dem die Teilwerte so angeordnet werden, wie sie im Hauptteil der SOAP-Meldung auftreten. Der Standardwert für document-literal-Vorgänge lautet „object“. Der Standardwert für rpc-Vorgänge lautet „array“. Die multiplePartsFormat-Eigenschaft ist nur anwendbar, wenn resultFormat auf „object“ gesetzt ist, anderenfalls wird sie ignoriert.

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

request

Eigenschaft

request:Object

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Anforderung des Vorgangs ist eine Objektstruktur oder eine XML-Struktur. Wenn Sie XML angeben, wird die XML unverändert übermittelt. Wenn Sie ein Objekt übergeben, wird es als SOAP-XML-Struktur kodiert.

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

resultFormat

Eigenschaft

resultFormat:String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bestimmt, wie das Vorgangsergebnis dekodiert wird. Der object-Wert gibt an, dass die XML in eine Objektstruktur dekodiert wird, wie im WSDL-Dokument angegeben. Der xml-Wert legt fest, dass XML als XMLNodes zu belassen ist. Der e4x-Wert legt fest, dass auf XML über ECMAScript für XML (E4X)-Ausdrücke zugegriffen werden kann.

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

resultHeaders

Eigenschaft

resultHeaders:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die Header, die als Teil der letzten Ausführung des Vorgangs zurückgegeben wurden. Sie entsprechen der lastResult-Eigenschaft und sind identisch mit der Sammlung, deren Header einzeln als HeaderEvents gesendet werden.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das resultForBinding -Ereignis ausgelöst.

Implementierung
public function get resultHeaders():Array

xmlSpecialCharsFilter

Eigenschaft

xmlSpecialCharsFilter:Function

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt eine benutzerdefinierte Funktion an, 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. Wird keine Funktion angegeben, dann wird die Standardeinstellung der entsprechenden IXMLEncoder-Implementierung übernommen.

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

Konstruktordetails

()

Konstruktor

public function Operation(webService:AbstractService = null, name:String = null)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Erstellt einen neuen Vorgang. Dies erfolgt in der Regel direkt durch den MXML-Compiler oder automatisch durch den WebService, wenn auf einen unbekannten Vorgang zugegriffen wurde. Es ist für Entwickler nicht ratsam, diesen Konstruktor direkt zu verwenden.

Parameter

	`webService:AbstractService` (default = `null`) — Der Webdienst, in dem der Vorgang aufgerufen wird.

	`name:String` (default = `null`) — Der Name des Vorgangs.

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 nur auf diesen Vorgang 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 — Fügt einen SOAP-Header zu diesem Vorgang hinzu.

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 nur auf diesen Vorgang angewandt wird.

Parameter

	`qnameLocal:String` — Localname des Header-QName

	`qnameNamespace:String` — Namespace des Header-QName

	`headerName:String` — Name des Headers.

	`headerValue:String` — Wert des Headers.

cancel

()

Methode

override public function cancel(id:String = null):mx.rpc:AsyncToken

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Bricht den letzten Dienstaufruf oder einen Aufruf mit der angegebenen ID ab. Auch wenn der Netzvorgang noch weiterläuft, wird kein Ergebnis oder Fehlerereignis ausgelöst.

Parameter

id:String (default = null) — Die messageID des Aufrufs, der abgebrochen werden soll. Optional. Bei Nichtverwendung wird der letzte Dienstaufruf abgebrochen.

Rückgabewerte

mx.rpc:AsyncToken — Das mit dem Aufruf verknüpfte AsyncToken, das abgebrochen wurde oder null ist, wenn kein Aufruf abgebrochen wurde.

clearHeaders

()

Methode

public function clearHeaders():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Löscht die Header für diesen einzelnen Vorgang.

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 eine Entsprechung auf Grund von QName, localName und URI gefunden wird.

Parameter

	`qname:QName` — QName des SOAPHeader.

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

Rückgabewerte

SOAPHeader — Gibt den SOAPHeader zurück.

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`) — Name eines Headers im SOAPHeader-Inhalt (optional)

Ereignisdetails

header

Ereignis

Ereignisobjekttyp: mx.rpc.events.HeaderEvent
Eigenschaft HeaderEvent.type = mx.rpc.events.HeaderEvent.HEADER

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Wird ausgelöst, wenn ein Vorgangsaufruf SOAP-Header in der Antwort zurückgibt. Für jeden SOAP-Header wird ein HeaderEvent ausgelöst.

Der HEADER-Ereignistyp.

Die Eigenschaften des Ereignisobjekts haben die folgenden Werte:

Eigenschaft	Wert
`bubbles`	false
`token`	Das Token, das den Aufruf der Methode darstellt. Wird im asynchronen Abschluss-Token-Muster verwendet.
`cancelable`	true, aber die preventDefault()-Methode hat keinen Effekt.
`currentTarget`	Das Objekt, das den Ereignis-Listener definiert, der das Ereignis übernimmt. Wenn Sie beispielsweise `myButton.addEventListener()` zur Registrierung eines Ereignis-Listeners verwenden, weist `currentTarget` den Wert „myButton“ auf.
`header`	Header, den der RPC-Aufruf in der Antwort zurückgibt.
`message`	Die mit diesem Ereignis verknüpfte Meldung.
`target`	Das Objekt, von dem das Ereignis ausgelöst wurde. Dies ist nicht immer das Objekt, das auf das Ereignis wartet. Verwenden Sie die `currentTarget`-Eigenschaft, damit immer auf das Objekt, das auf das Ereignis wartet, zugegriffen wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

Operation - AS3 Flex

Klassen x

endpointURI

forcePartArrays

headerFormat

headers

httpHeaders

ignoreWhitespace

makeObjectsBindable

multiplePartsFormat

request

resultFormat

resultHeaders

xmlSpecialCharsFilter

Operation

addHeader

addSimpleHeader

cancel

clearHeaders

getHeader

removeHeader

header