Pacchetto | flash.net |
Classe | public final class ObjectEncoding |
Ereditarietà | ObjectEncoding Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La codifica oggetto controlla il modo in cui gli oggetti sono rappresentati nel formato AMF (Action Message Format). Flash Player utilizza il formato AMF per attivare una comunicazione efficiente tra un'applicazione e un server remoto. AMF codifica le chiamate di procedura remote in una rappresentazione binaria compatta che può essere trasferita tramite HTTP/HTTPS o con il protocollo RTMP/RTMPS utilizzato da Flash Media Server. Gli oggetti e i valori dei dati vengono serializzati in questo formato binario, che di solito risulta più compatto rispetto ad altre rappresentazioni, ad esempio il codice XML.
Adobe AIR e Flash Player 9 sono in grado di serializzare in due formati diversi: AMF3 e AMF0. AMF3, la serializzazione predefinita sviluppata per ActionScript 3.0, offre vari vantaggi rispetto ad AMF0, che viene utilizzato per ActionScript 1.0 e 2.0. AMF3 invia i dati sulla rete in modo più efficiente rispetto ad AMF0. AMF3 supporta l'invio di oggetti int
e uint
sotto forma di numeri interi e supporta i tipi di dati che sono disponibili solo in ActionScript 3.0, come ByteArray, XML e IExternalizable. È disponibile solo in ActionScript 3.0 e con i server che utilizzano la codifica AMF3, come Flex 2.
Le classi ByteArray, NetConnection, NetStream, SharedObject, Socket e URLStream contengono una proprietà objectEncoding
a cui viene assegnata una costante dalla classe ObjectEncoding. Il comportamento della proprietà objectEncoding
varia a seconda dell'oggetto; la descrizione della proprietà objectEncoding
di ogni classe ne illustra il comportamento in modo più approfondito.
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [statico]
Consente un controllo maggiore sulla serializzazione delle proprietà dinamiche degli oggetti dinamici. | ObjectEncoding |
Costante | Definito da | ||
---|---|---|---|
AMF0 : uint = 0 [statico]
Specifica che gli oggetti vengano serializzati mediante Action Message Format per ActionScript 1.0 e 2.0. | ObjectEncoding | ||
AMF3 : uint = 3 [statico]
Specifica che gli oggetti vengano serializzati mediante Action Message Format per ActionScript 3.0. | ObjectEncoding | ||
DEFAULT : uint = 3 [statico]
Specifica il formato predefinito (il più recente) per il runtime corrente (Flash Player o AIR). | ObjectEncoding |
dynamicPropertyWriter | proprietà |
dynamicPropertyWriter:IDynamicPropertyWriter
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Consente un controllo maggiore sulla serializzazione delle proprietà dinamiche degli oggetti dinamici. Quando questa proprietà è impostata sul valore predefinito null
, le proprietà dinamiche vengono serializzate mediante il codice nativo, che scrive tutte le proprietà dinamiche a esclusione di quelle che hanno una funzione come valore.
Questo valore viene chiamato solo per le proprietà di un oggetto dinamico (oggetti dichiarati all'interno di una classe dinamica) o per oggetti dichiarati mediante l'operatore new
.
È possibile utilizzare questa proprietà per escludere dalla serializzazione le proprietà degli oggetti dinamici, per scrivere i valori nelle proprietà degli oggetti dinamici o per creare delle nuove proprietà per gli oggetti dinamici. A tale scopo, impostate questa proprietà su un oggetto che implementi l'interfaccia IDynamicPropertyWriter. Per ulteriori informazioni, vedete l'interfaccia IDynamicPropertyWriter.
Implementazione
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Elementi API correlati
AMF0 | Costante |
public static const AMF0:uint = 0
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica che gli oggetti vengano serializzati mediante Action Message Format per ActionScript 1.0 e 2.0.
AMF3 | Costante |
public static const AMF3:uint = 3
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica che gli oggetti vengano serializzati mediante Action Message Format per ActionScript 3.0.
DEFAULT | Costante |
public static const DEFAULT:uint = 3
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Specifica il formato predefinito (il più recente) per il runtime corrente (Flash Player o AIR). Dal momento che il controllo della codifica degli oggetti è disponibile solo in Flash Player 9 e versioni successive e Adobe AIR, il formato meno recente utilizzato è Action Message Format per ActionScript 3.0.
Ad esempio, se la proprietà objectEncoding
di un oggetto è impostata su ObjectEncoding.DEFAULT
, viene utilizzata la codifica AMF3. Se in futuro una versione più recente di Flash Player o Adobe AIR dovesse introdurre una nuova versione di AMF e si desiderasse ripubblicare i contenuti, l'applicazione utilizzerebbe la nuova versione di AMF. È possibile utilizzare questa costante solo se non si considera importante l'interoperabilità con le versioni precedenti.
Tue Jun 12 2018, 02:44 PM Z