ActionScript® 3.0 — dokumentacja dla platformy Adobe® Flash®
Strona główna  |  Ukryj listę pakietów i klas |  Pakiety  |  Klasy  |  Nowości  |  Indeks  |  Dodatki  |  Dlaczego język angielski?
Filtry: Pobieranie danych z serwera...
Pobieranie danych z serwera...
flash.net 

ObjectEncoding  - AS3

Pakietflash.net
Klasapublic final class ObjectEncoding
DziedziczenieObjectEncoding Inheritance Object

Wersja języka: ActionScript 3.0
Wersje środowiska wykonawczego: AIR 1.0, Flash Player 9, Flash Lite 4

Klasa ObjectEncoding jest używana przy definiowaniu ustawień serializacji w klasach serializujących obiekty (takich jak FileStream, NetStream, NetConnection, SharedObject i ByteArray), umożliwiając współpracę z kodem pochodzącym z wcześniejszych wersji języka ActionScript.

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ści publiczne
 WłaściwośćZdefiniowane przez
 Inheritedconstructor : 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
Metody publiczne
 MetodaZdefiniowane przez
 Inherited
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.
Object
 Inherited
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.
Object
 Inherited
Wskazuje, czy określona właściwość istnieje i jest przeliczalna.
Object
 Inherited
Ustawia dostępność właściwości dynamicznej używanej w pętlach.
Object
 Inherited
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.
Object
 Inherited
Zwraca ciąg reprezentujący określony obiekt.
Object
 Inherited
Zwraca pierwotną wartość dla określonego obiektu.
Object
Stałe publiczne
 StałaZdefiniowane 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
Szczegół właściwości

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

IDynamicPropertyWriter
Szczegół stałej

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.





[ X ]Dlaczego język angielski?
Treść dokumentacji języka ActionScript 3.0 wyświetlana w języku angielskim

Niektóre części dokumentacji języka ActionScript 3.0 nie są przetłumaczone na poszczególne języki. Gdy element nie jest przetłumaczony na dany język, jest wyświetlany tekst angielski. Na przykład opis klasy ga.controls.HelpBox nie jest przetłumaczony na żaden dodatkowy język. Z tego powodu polska wersja dokumentacji zawiera opis klasy ga.controls.HelpBox w języku angielskim.