Paket | flash.net |
Klasse | public final class ObjectEncoding |
Vererbung | ObjectEncoding Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Mit der Objektkodierung wird die AMF-Version (Action Message Format) der Objekte gesteuert. Flash Player verwendet AMF, um eine effiziente Kommunikation zwischen einer Anwendung und einem Remote-Server zu ermöglichen. AMF kodiert Remote Procedure Calls in kompakte Binärdaten, die über HTTP/HTTPS oder das von Flash Media Server verwendete RTMP/RTMPS-Protokoll übertragen werden können. Objekte und Datenwerte werden in dieses Binärformat serialisiert, das in der Regel kompakter ist als andere Darstellungsformen wie XML.
Adobe AIR und Flash Player 9 unterstützen die Serialisierung in zwei verschiedene Formate: AMF3 und AMF0. Das für ActionScript 3.0 entwickelte Standardformat AMF3 bietet im Vergleich zu dem für ActionScript 1.0 und 2.0 verwendeten Format AMF0 mehrere Vorteile. Die Datenübertragung über das Netzwerk erfolgt mit AMF3 effizienter als mit AMF0. AMF3 unterstützt das Senden von int
- und uint
-Objekten als Ganzzahlen sowie Datentypen, die nur in ActionScript 3.0 verfügbar sind, wie z. B. ByteArray, XML und IExternalizable. Dieses Format ist nur in ActionScript 3.0 und für Server verfügbar, die die AMF3-Kodierung verwenden, wie Flex 2.
Die Klassen ByteArray, NetConnection, NetStream, SharedObject, Socket und URLStream enthalten die objectEncoding
-Eigenschaft, der mit der ObjectEncoding-Klasse eine Konstante zugewiesen wird. Das Verhalten der Eigenschaft objectEncoding
hängt davon ab, um welches Objekt es sich handelt. In den Beschreibungen zur Eigenschaft objectEncoding
der jeweiligen Klassen wird näher darauf eingegangen.
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [statisch]
Ermöglicht eine bessere Steuerung der Serialisierung der dynamischen Eigenschaften dynamischer Objekte. | ObjectEncoding |
Konstante | Definiert von | ||
---|---|---|---|
AMF0 : uint = 0 [statisch]
Gibt an, dass Objekte mit der AMF-Version für ActionScript 1.0 und 2.0 serialisiert werden. | ObjectEncoding | ||
AMF3 : uint = 3 [statisch]
Gibt an, dass Objekte mit der AMF-Version für ActionScript 3.0 serialisiert werden. | ObjectEncoding | ||
DEFAULT : uint = 3 [statisch]
Gibt das Standardformat (neuestes Format) der aktuellen Laufzeitumgebung an (entweder Flash Player oder AIR). | ObjectEncoding |
dynamicPropertyWriter | Eigenschaft |
dynamicPropertyWriter:IDynamicPropertyWriter
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ermöglicht eine bessere Steuerung der Serialisierung der dynamischen Eigenschaften dynamischer Objekte. Wenn diese Eigenschaft den Wert null
aufweist (Standardwert), werden dynamische Eigenschaften mit systemeigenem Code serialisiert, der alle dynamischen Eigenschaften schreibt, mit Ausnahme der Eigenschaften, die als Wert eine Funktion aufweisen.
Dieser Wert wird nur für Eigenschaften eines dynamischen Objekts aufgerufen (d. h. ein Objekt, das innerhalb einer dynamischen Klasse deklariert wurden) oder für Objekte die mithilfe des new
-Operators deklariert wurden.
Sie können diese Eigenschaft verwenden, um Eigenschaften dynamischer Objekte aus der Serialisierung auszuschließen, um Eigenschaften dynamischer Objekte Werte zuzuweisen und um neue Eigenschaften für dynamische Objekte zu erstellen. Stellen Sie hierzu für die Eigenschaft auf ein Objekt ein, das die Schnittstelle „IDynamicPropertyWriter“ implementiert. Weitere Informationen hierzu finden Sie im Abschnitt zur Schnittstelle „IDynamicPropertyWriter“.
Implementierung
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Verwandte API-Elemente
AMF0 | Konstante |
public static const AMF0:uint = 0
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt an, dass Objekte mit der AMF-Version für ActionScript 1.0 und 2.0 serialisiert werden.
AMF3 | Konstante |
public static const AMF3:uint = 3
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt an, dass Objekte mit der AMF-Version für ActionScript 3.0 serialisiert werden.
DEFAULT | Konstante |
public static const DEFAULT:uint = 3
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt das Standardformat (neuestes Format) der aktuellen Laufzeitumgebung an (entweder Flash Player oder AIR). Da die Steuerung der Objektkodierung nur in Flash Player 9 und neueren Versionen und in Adobe AIR verfügbar ist, können nur Formate ab der AMF-Version für ActionScript 3.0 verwendet werden.
Wenn für ein Objekt die objectEncoding
-Eigenschaft auf ObjectEncoding.DEFAULT
eingestellt ist, wird die AMF3-Kodierung verwendet. Wenn in Zukunft in einer neueren Version von Flash Player oder Adobe AIR eine neue AMF-Version eingeführt wird und Sie Ihre Inhalte neu veröffentlichen, wird die neue AMF-Version verwendet. Verwenden Sie diese Konstante nur, wenn Sie keinen Wert auf die Interoperabilität mit älteren Versionen legen.
Tue Jun 12 2018, 10:04 AM Z