flash.net.ObjectEncoding (ActionScript 3.0)

Pacchetto	flash.net
Classe	public final class ObjectEncoding
Ereditarietà	ObjectEncoding Object

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

La classe ObjectEncoding consente alle classi di serializzare gli oggetti (ad esempio NetStream, NetConnection, SharedObject e ByteArray) in modo che funzionino con le versioni precedenti di ActionScript.

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 Flash 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 ActionScript e i valori dei dati vengono serializzati in questo formato binario, che di solito risulta più compatto rispetto ad altre rappresentazioni quale l'XML.

Flash Player 9 è in grado di serializzare in due formati diversi: AMF3 e AMF0. AMF3, la serializzazione predefinita utilizzata 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
		prototype: Object [statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.	Object

	Metodo	Definito da
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

	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 (più recente) per il lettore corrente.	ObjectEncoding

Descrizione delle proprietà

dynamicPropertyWriter

proprietà

dynamicPropertyWriter:IDynamicPropertyWriter [lettura-scrittura]

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

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, impostare questa proprietà su un oggetto che implementi l'interfaccia IDynamicPropertyWriter. Per ulteriori informazioni, vedere l'interfaccia IDynamicPropertyWriter.

Implementazione
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void

Vedere anche

IDynamicPropertyWriter

Descrizione delle costanti

AMF0

Costante

public static const AMF0:uint = 0

Versione linguaggio:

ActionScript 3.0

Versione lettore:

Flash Player 9

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

Versione lettore:

Flash Player 9

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

Versione lettore:

Flash Player 9

Specifica il formato predefinito (più recente) per il lettore corrente. Dal momento che il controllo della codifica degli oggetti è disponibile solo in Flash^® Player 9 e versioni successive, il formato meno recente utilizzato è Action Message Format per ActionScript 3.0.

Ad esempio, se un oggetto ha la proprietà objectEncoding impostata su flash.net.ObjectEncoding.DEFAULT, Flash Player utilizza la codifica AMF3. Se in futuro una versione più recente di Flash Player dovesse introdurre una nuova versione di AMF e si desiderasse ripubblicare i contenuti, il lettore utilizzerebbe la nuova versione di AMF. È possibile utilizzare questa costante solo se non si considera importante l'interoperabilità con le versioni precedenti di Flash Player.

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/net/ObjectEncoding.html

Guida di riferimento del linguaggio e dei componenti ActionScript 3.0		Tutti i pacchetti \| Tutte le classi \| Elementi del linguaggio \| Indice \| Appendici \| Convenzioni \| Con frame Senza frame
ObjectEncoding	Proprietà \| Metodi \| Costanti