Пакет | flash.net |
Класс | public final class ObjectEncoding |
Наследование | ObjectEncoding Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Кодировка объектов управляет представлением этих объектов в формате Action Message Format (AMF). С помощью AMF проигрыватель Flash Player обеспечивает эффективное взаимодействие между приложением и удаленным сервером. AMF кодирует удаленные вызовы процедуры в компактное двоичное представление, которое может быть передано по протоколу HTTP/HTTPS или RTMP/RTMPS, используемому сервером Flash Media Server. Объекты и значения данных сериализуются в этот двоичный формат, который в большинстве случаев обеспечивает более компактное представление данных, чем например язык XML.
Adobe AIR и проигрыватель Flash Player 9 осуществляют сериализацию в двух различных форматах: AMF3 и AMF0. AMF3, используемая по умолчанию сериализация для ActionScript 3.0, обладает целым рядом преимуществ по сравнению с AMF0, которая используется для ActionScript 1.0 и 2.0. AMF3 отправляет данные по сети намного эффективнее, чем AMF0. Формат AMF3 поддерживает отправку объектов int
и uint
в виде целых чисел, а также поддерживает типы данных, доступные только в ActionScript 3.0 (такие как ByteArray, XML и IExternalizable). Это доступно только в ActionScript 3.0 и на серверах, использующих кодировку AMF3, таких как Flex 2.
Классы ByteArray, FileStream, NetConnection, NetStream, SharedObject, Socket и URLStream содержат свойство objectEncoding
, которому присваивается константа из класса ObjectEncoding. Характеристики свойства objectEncoding
зависят от самого объекта. В описании свойства objectEncoding
для каждого класса даны более подробные сведения по этому вопросу.
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [статические]
Обеспечивает более строгий контроль за сериализацией динамических свойств динамических объектов. | ObjectEncoding |
Константа | Определено | ||
---|---|---|---|
AMF0 : uint = 0 [статические]
Указывает, что объекты сериализуются с помощью формата AMF для ActionScript 1.0 и 2.0. | ObjectEncoding | ||
AMF3 : uint = 3 [статические]
Указывает, что объекты сериализуются с помощью формата AMF для ActionScript 3.0. | ObjectEncoding | ||
DEFAULT : uint = 3 [статические]
Указывает формат по умолчанию (последний) для текущей среды выполнения (Flash Player или AIR). | ObjectEncoding |
dynamicPropertyWriter | свойство |
dynamicPropertyWriter:IDynamicPropertyWriter
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Обеспечивает более строгий контроль за сериализацией динамических свойств динамических объектов. Если данное свойство имеет значение null
(значение по умолчанию), динамические свойства сериализуются с помощью собственного кода, который записывает все динамические свойства, за исключением тех, чьим значением является функция.
Данное значение вызывается только для свойств динамического объекта (объект, объявленный в рамках динамического класса) или для объектов, объявленных с помощью оператора new
.
Данное свойство можно использовать для исключения сериализации свойств динамических объектов, а также для записи значений в свойства динамических объектов или создания для этих объектов новых свойств. Для этого установите данное свойство тому объекту, который реализует интерфейс IDynamicPropertyWriter. Дополнительные сведения см. в интерфейсе IDynamicPropertyWriter.
Реализация
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Связанные элементы API
AMF0 | Константа |
public static const AMF0:uint = 0
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает, что объекты сериализуются с помощью формата AMF для ActionScript 1.0 и 2.0.
AMF3 | Константа |
public static const AMF3:uint = 3
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает, что объекты сериализуются с помощью формата AMF для ActionScript 3.0.
DEFAULT | Константа |
public static const DEFAULT:uint = 3
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Указывает формат по умолчанию (последний) для текущей среды выполнения (Flash Player или AIR). Поскольку управление кодировкой объекта доступно только в проигрывателе Flash Player 9, его более поздних версиях, а также в Adobe AIR, самым ранним применяемым форматом будет считаться Action Message Format for ActionScript 3.0.
Например, если свойство objectEncoding
объекта установлено на значение ObjectEncoding.DEFAULT
, используется кодировка AMF3. Если в будущем, в более поздней версии Flash Player или Adobe AIR будет представлена новая версия AMF и вы заново опубликуете содержимое, приложение будет использовать именно эту новую версию AMF. Эту константу можно применять только в том случае, если возможность взаимодействия с предыдущими версиями не является для вас актуальной.
Tue Jun 12 2018, 11:34 AM Z