Package | flash.net |
Classe | public final class ObjectEncoding |
Héritage | ObjectEncoding Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L’encodage d’objet détermine la manière dont les objets sont représentés au format AMF (Action Message Format). Flash Player utilise AMF pour améliorer l’efficacité des communications entre une application et un serveur distant. Le format AMF code les appels de procédure à distance dans un format binaire compact, qui peut être transféré via HTTP/HTTPS ou le protocole RTMP/RTMPS utilisé par Flash Media Server. Les objets et les valeurs de données sont sérialisés dans ce format binaire, qui est généralement plus compact que d’autres représentations, telles que XML.
Adobe AIR et Flash Player 9 peuvent sérialiser dans deux formats différents : AMF3 et AMF0. AMF3, la sérialisation développée par défaut pour ActionScript 3.0, offre plusieurs avantages par rapport à AMF0, réservée à ActionScript 1.0 et 2.0. AMF3 envoie des données sur le réseau de manière plus efficace que AMF0. AMF3 autorise l’envoi d’objets int
et uint
en tant qu’entiers et prend en charge des types de données, tels que ByteArray, XML, et IExternalizable, qui sont uniquement disponibles dans ActionScript 3.0. Ce format est uniquement disponible dans ActionScript 3.0 et avec les serveurs utilisant le codage AMF3, tels que Flex 2.
Les classes ByteArray, FileStream, NetConnection, NetStream, SharedObject, Socket et URLStream contiennent la propriété objectEncoding
, à laquelle une constante de la classe ObjectEncoding est affectée. Le comportement de la propriété objectEncoding
varie en fonction de l’objet. La description de la propriété objectEncoding
de chaque classe explique ce comportement en détail.
Propriété | Défini par | ||
---|---|---|---|
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
dynamicPropertyWriter : IDynamicPropertyWriter [statique]
Assure une meilleure maîtrise de la sérialisation des propriétés dynamiques des objets dynamiques. | ObjectEncoding |
Constante | Défini par | ||
---|---|---|---|
AMF0 : uint = 0 [statique]
Spécifie que les objets sont sérialisés à l’aide du format AMF (Action Message Format) utilisé par ActionScript 1.0 et 2.0. | ObjectEncoding | ||
AMF3 : uint = 3 [statique]
Spécifie que les objets sont sérialisés à l’aide du format AMF (Action Message Format) utilisé par ActionScript 3.0. | ObjectEncoding | ||
DEFAULT : uint = 3 [statique]
Spécifie le format par défaut (le plus récent) du moteur d’exécution actuel (Flash Player ou AIR). | ObjectEncoding |
dynamicPropertyWriter | propriété |
dynamicPropertyWriter:IDynamicPropertyWriter
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Assure une meilleure maîtrise de la sérialisation des propriétés dynamiques des objets dynamiques. Lorsque cette propriété est réglée sur null
, sa valeur par défaut, les propriétés dynamiques sont sérialisées à l’aide de code natif, qui les écrit toutes, à l’exception de celles dont la valeur est une fonction.
Cette valeur n’est appelée que pour les propriétés d’un objet dynamique (objets déclarés au sein d’une classe dynamique) ou pour des objets déclarés à l’aide de l’opérateur new
.
Cette propriété vous permet d’exclure des propriétés d’objets dynamiques de la sérialisation, d’écrire des valeurs dans les propriétés dynamiques des objets dynamiques ou de créer des propriétés dynamiques pour des objets dynamiques. Pour ce faire, réglez-la sur un objet qui implémente l’interface IDynamicPropertyWriter. Pour plus d’informations, voir l’interface IDynamicPropertyWriter.
Implémentation
public static function get dynamicPropertyWriter():IDynamicPropertyWriter
public static function set dynamicPropertyWriter(value:IDynamicPropertyWriter):void
Eléments de l’API associés
AMF0 | Constante |
public static const AMF0:uint = 0
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie que les objets sont sérialisés à l’aide du format AMF (Action Message Format) utilisé par ActionScript 1.0 et 2.0.
AMF3 | Constante |
public static const AMF3:uint = 3
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie que les objets sont sérialisés à l’aide du format AMF (Action Message Format) utilisé par ActionScript 3.0.
DEFAULT | Constante |
public static const DEFAULT:uint = 3
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Spécifie le format par défaut (le plus récent) du moteur d’exécution actuel (Flash Player ou AIR). Le contrôle de l’encodage d’objet étant uniquement disponible dans Flash Player 9 et les versions ultérieures, ainsi que dans Adobe AIR, le format AMF (Action Message Format) le plus récent utilisé est celui d’ActionScript 3.0.
Par exemple, si la propriété objectEncoding
d’un objet est définie sur ObjectEncoding.DEFAULT
, l’encodage AMF3 est utilisé. Si, à l’avenir, une version ultérieure de Flash Player ou d’Adobe AIR propose une nouvelle version d’AMF et que vous republiez votre contenu, l’application utilisera cette nouvelle version. Faites appel à cette constante uniquement si l’interopérabilité avec les versions antérieures n’a aucune importance.
Tue Jun 12 2018, 09:30 AM Z