Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: AIR 30.0 или более ранней версии, Flash Player 30.0 или более ранней версии, Flash Lite 4
Flex 4.6 или более ранней версии, Flash Pro CS6 или более ранней версии
Скрыть фильтры
flash.net 

ObjectEncoding  - AS3

Пакетflash.net
Классpublic final class ObjectEncoding
НаследованиеObjectEncoding Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 9, Flash Lite 4

Класс ObjectEncoding используется для определения параметров сериализации в классах, сериализующих объекты (таких как FileStream, NetStream, NetConnection, SharedObject и ByteArray) для работы с предыдущими версиями ActionScript.

Кодировка объектов управляет представлением этих объектов в формате 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 для каждого класса даны более подробные сведения по этому вопросу.



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  dynamicPropertyWriter : IDynamicPropertyWriter
[статические] Обеспечивает более строгий контроль за сериализацией динамических свойств динамических объектов.
ObjectEncoding
Общедоступные методы
 МетодОпределено
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строковое представление заданного объекта.
Object
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 КонстантаОпределено
  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

IDynamicPropertyWriter
Сведения о константе

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. Эту константу можно применять только в том случае, если возможность взаимодействия с предыдущими версиями не является для вас актуальной.





[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.