Pakiet | flash.net |
Klasa | public final class ObjectEncoding |
Dziedziczenie | ObjectEncoding Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Kodowanie obiektów decyduje o sposobie, w jaki obiekty reprezentowane są w formacie AMF (Action Message Format). Program Flash Player korzysta z formatu AMF, co umożliwia wydajną komunikację między aplikacją i serwerem zdalnym. Format AMF koduje wywołania procedur zdalnych do zwartej postaci binarnej, którą można przesłać za pomocą protokołów HTTP/HTTPS lub RTMP/RTMPS używanych przez serwer Flash Media Server. Obiekty języka oraz wartości danych są serializowane do tego binarnego formatu, który z reguły jest bardziej zwarty niż pozostałe reprezentacje, jak np. XML.
Środowisko Adobe AIR i program Flash Player 9 mogą serializować obiekty w dwóch różnych formatach: AMF3 i AMF0. Format AMF3, domyślna serializacja dla języka ActionScript 3.0, zapewnia różne dodatkowe korzyści w porównaniu z formatem AMF0, który używany jest w językach ActionScript 1.0 i 2.0. Format AMF3 pozwala na wysyłanie danych za pomocą sieci z większą wydajnością niż format AMF0. Format AMF3 obsługuje wysyłanie obiektów int
oraz uint
jako liczby całkowite i obsługuje typy danych, które dostępne są jedynie w języku ActionScript 3.0 takie, jak ByteArray, XML oraz IExternalizable. Dostępne jedynie w języku ActionScript 3.0 oraz na serwerach, które używają kodowania AMF3, np. Flex 2.
Klasy ByteArray, FileStream, NetConnection, NetStream, SharedObject, Socket i URLStream zawierają właściwość objectEncoding
, której przypisana jest stała z klasy ObjectEncoding. Zachowanie właściwości objectEncoding
różni się w zależności od obiektu; opis właściwości objectEncoding
dla każdej klasy tłumaczy jej zachowanie dokładniej.
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [statyczny]
Zapewnia lepszą kontrolę nad szeregowaniem dynamicznych właściwości obiektów dynamicznych. | ObjectEncoding |
Stała | Zdefiniowane przez | ||
---|---|---|---|
AMF0 : uint = 0 [statyczny]
Określa, że obiekty są szeregowane przy użyciu formatu AMF (Action Message Format) dla języka ActionScript 1.0 i 2.0. | ObjectEncoding | ||
AMF3 : uint = 3 [statyczny]
Określa, że obiekty są serializowane przy użyciu formatu AMF (Action Message Format) dla języka ActionScript 3.0. | ObjectEncoding | ||
DEFAULT : uint = 3 [statyczny]
Określa domyślny (najnowszy) format w bieżącym środowisku wykonawczym (programie Flash Player albo środowisku AIR). | ObjectEncoding |
dynamicPropertyWriter | właściwość |
dynamicPropertyWriter:IDynamicPropertyWriter
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zapewnia lepszą kontrolę nad szeregowaniem dynamicznych właściwości obiektów dynamicznych. Jeśli ta właściwość ma wartość null
, wartość domyślna, właściwości dynamiczne są serializowane za pomocą natywnego kodu, który zapisuje wszystkie właściwości dynamiczne poza tymi, których wartością jest funkcja.
Ta wartość wywoływana jest jedynie dla właściwości dynamicznego obiektu (obiektów zadeklarowanych w klasach dynamicznych) lub dla obiektów zadeklarowanych za pomocą operatora new
.
Tej właściwości można użyć w celu wykluczenia z serializacji właściwości obiektów dynamicznych, zapisania wartości do właściwości obiektów dynamicznych lub utworzenia nowych właściwości dla tych obiektów. Aby to uczynić, należy ustawić tę właściwość na obiekt implementujący interfejs IDynamicPropertyWriter. Aby znaleźć więcej informacji na ten temat, należy zapoznać się z interfejsem IDynamicPropertyWriter.
Implementacja
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Powiązane elementy interfejsu API
AMF0 | Stała |
public static const AMF0:uint = 0
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, że obiekty są serialozowane przy użyciu formatu AMF (Action Message Format) dla języka ActionScript 1.0 i 2.0.
AMF3 | Stała |
public static const AMF3:uint = 3
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, że obiekty są szeregowane przy użyciu formatu AMF (Action Message Format) dla języka ActionScript 3.0.
DEFAULT | Stała |
public static const DEFAULT:uint = 3
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa domyślny (najnowszy) format w bieżącym środowisku wykonawczym (programie Flash Player albo środowisku AIR). Ponieważ element sterujący obiektu kodowania jest dostępny jedynie w programie Flash Player 9 i późniejszych wersjach oraz środowisku Adobe AIR, pierwszym używanym formatem będzie Action Message Format for ActionScript 3.0.
Na przykład, jeśli właściwość objectEncoding
obiektu jest ustawiona na ObjectEncoding.DEFAULT
, stosowane będzie kodowanie AMF3. Jeśli w przyszłości w kolejnej wersji programu Flash Player lub środowisku AIR zostanie wprowadzona nowa wersja kodowania AMF i treść zostanie opublikowana ponownie, aplikacja użyje nowszej wersji kodowania AMF. Można użyć tej stałej jedynie wtedy, gdy nic nie ma znaczenia poza zdolnością do współdziałania z poprzednimi wersjami.
Tue Jun 12 2018, 12:06 PM Z