Pacote | flash.net |
Classe | public final class ObjectEncoding |
Herança | ObjectEncoding Object |
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
A codificação de objetos controla como os objetos são representados em AMF (Action Message Format). O Flash Player usa o AMF para permitir a comunicação eficiente entre um aplicativo e um servidor remoto. O AMF codifica chamadas de procedimento remoto em uma representação binária compacta que pode ser transferida via HTTP/HTTPS ou por meio do protocolo RTMP/RTMPS usado pelo Flash Media Server. Valores de dados e objetos são serializados nesse formato binário, que é geralmente mais compacto do que outras representações, como o XML.
O Adobe AIR e o Flash Player 9 podem serializar em dois formatos diferentes: AMF3 e AMF0. AMF3, a serialização padrão desenvolvida para o ActionScript 3.0, fornece várias vantagens em relação à serialização AMF0, que é usada para o ActionScript 1.0 e 2.0. AMF3 envia dados via rede de forma mais eficiente que AMF0. AMF3 oferece suporte para o envio de objetos int
e uint
como inteiros e oferece suporte a tipos de dados que somente estão disponíveis no ActionScript 3.0, como ByteArray, XML e IExternalizable. Esse formato apenas está disponível no ActionScript 3.0 e com servidores que usam a codificação AMF3, como o Flex 2.
As classes ByteArray, FilreStream, NetConnection, NetStream, SharedObject, Socket e URLStream contêm uma propriedade objectEncoding
que recebe uma constante da classe ObjectEncoding. O comportamento da propriedade objectEncoding
difere dependendo do objeto; a descrição da propriedade objectEncoding
de cada classe explica o comportamento com mais detalhes.
Propriedade | Definido por | ||
---|---|---|---|
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [estático]
Permite maior controle sobre a serialização de propriedades dinâmicas de objetos dinâmicos. | ObjectEncoding |
Constante | Definido por | ||
---|---|---|---|
AMF0 : uint = 0 [estático]
Especifica se os objetos são serializados com o uso do AMF (Action Message Format) para o ActionScript 1.0 e 2.0. | ObjectEncoding | ||
AMF3 : uint = 3 [estático]
Especifica se os objetos são serializados com o uso do AMF (Action Message Format) para o ActionScript 3.0. | ObjectEncoding | ||
DEFAULT : uint = 3 [estático]
Especifica o formato padrão (último) para o tempo de execução atual (Flash Player ou AIR). | ObjectEncoding |
dynamicPropertyWriter | propriedade |
dynamicPropertyWriter:IDynamicPropertyWriter
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Permite maior controle sobre a serialização de propriedades dinâmicas de objetos dinâmicos. Quando essa propriedade é definida como null
, o valor padrão, as propriedades dinâmicas são serializadas com o uso do código nativo, que grava todas as propriedades dinâmicas, excluindo aquelas cujo valor é uma função.
Esse valor apenas é chamado para propriedades de um objeto dinâmico (objetos declarados em uma classe dinâmica) ou para objetos declarados com o uso do operador new
.
Essa propriedade pode ser usada para excluir as propriedades de objetos dinâmicos da serialização; gravar valores em propriedades de objetos dinâmicos ou criar novas propriedades para objetos dinâmicos. Para fazer isso, defina essa propriedade como um objeto que implemente a interface IDynamicPropertyWriter. Para obter mais informações, consulte a interface IDynamicPropertyWriter.
Implementação
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Elementos da API relacionados
AMF0 | Constante |
public static const AMF0:uint = 0
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se os objetos são serializados com o uso do AMF (Action Message Format) para o ActionScript 1.0 e 2.0.
AMF3 | Constante |
public static const AMF3:uint = 3
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica se os objetos são serializados com o uso do AMF (Action Message Format) para o ActionScript 3.0.
DEFAULT | Constante |
public static const DEFAULT:uint = 3
Versão da linguagem: | ActionScript 3.0 |
Versões de runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica o formato padrão (último) para o tempo de execução atual (Flash Player ou AIR). Como o controle da codificação de objetos está disponível apenas no Flash Player 9 e no Adobe AIR, o formato mais anterior usado será o Action Message Format para ActionScript 3.0.
Por exemplo, se um objeto possui a propriedade objectEncoding
definida como ObjectEncoding.DEFAULT
, a codificação usada é a AMF3. No futuro, se uma versão posterior do Flash Player ou do Adobe AIR introduzir uma nova versão AMF e você republicar o seu conteúdo, o player usará essa nova versão AMF. Essa constante somente poderá ser usada se você não estiver preocupado com a interoperabilidade com versões anteriores.
Wed Jun 13 2018, 11:10 AM Z