目录(?)[-]

  1. OpenRTMFPCumulus Primer15AMF解析之数据类型定义
    1. 数据类型
    2. undefined Type
    3. null Type
    4. false type
    5. true type
    6. integer type
    7. double type
    8. String type
    9. XMLDocument type
    10. Date type
    11. Array type
    12. Object type
    13. XML type
    14. ByteArray
    15. Usages of AMF3
      1. NetConnection and AMF 3
      2. NetConnection in ActionScript 30
      3. ByteArray IDataInput and IDataOutput
    16. Reference
 

OpenRTMFP/Cumulus Primer(15)AMF解析之数据类型定义

  • Author: 柳大·Poechant(钟超)
  • Email: zhongchao.ustc#gmail.com (#->@)
  • Blog: Blog.CSDN.net/Poechant
  • Date: April 24th, 2012

1 数据类型

各种数据类型的标示都在 AMF.h 中定义为宏

#define AMF_NUMBER              0x00    // 浮点数
#define AMF_BOOLEAN 0x01 // 布尔型
#define AMF_STRING 0x02 // 字符串
#define AMF_BEGIN_OBJECT 0x03 // 对象,开始
#define AMF_NULL 0x05 // null
#define AMF_UNDEFINED 0x06
#define AMF_REFERENCE 0x07
#define AMF_MIXED_ARRAY 0x08
#define AMF_END_OBJECT 0x09 // 对象,结束
#define AMF_BEGIN_TYPED_OBJECT 0x10
#define AMF_STRICT_ARRAY 0x0A
#define AMF_DATE 0x0B // 日期
#define AMF_LONG_STRING 0x0C // 字符串
#define AMF_UNSUPPORTED 0x0D #define AMF_AVMPLUS_OBJECT 0x11
#define AMF_END 0xFF #define AMF3_UNDEFINED 0x00
#define AMF3_NULL 0x01
#define AMF3_FALSE 0x02
#define AMF3_TRUE 0x03
#define AMF3_INTEGER 0x04
#define AMF3_NUMBER 0x05
#define AMF3_STRING 0x06
#define AMF3_DATE 0x08
#define AMF3_ARRAY 0x09
#define AMF3_OBJECT 0x0A
#define AMF3_BYTEARRAY 0x0C
#define AMF3_DICTIONARY 0x11

并定义了一个枚举类表示数据类型:

class AMF {
public:
enum Type {
Null=0,
Boolean,
Integer,
Number,
String,
Date,
Array,
Object,
ByteArray,
Dictionary,
RawObjectContent,
End
};
};

2 undefined Type

The undefined type is represented by the undefined type marker. No further information is encoded for this value.

3 null Type

The null type is represented by the null type marker. No further information is encoded for this value.

4 false type

The false type is represented by the false type marker and is used to encode a Boolean value of false. Note that in ActionScript 3.0 the concept of a primitive and Object form of Boolean does not exist. No further information is encoded for this value.

5 true type

The true type is represented by the true type marker and is used to encode a Boolean value of true. Note that in ActionScript 3.0 the concept of a primitive and Object form of Boolean does not exist. No further information is encoded for this value.

6 integer type

In AMF 3 integers are serialized using a variable length unsigned 29-bit integer. The ActionScript 3.0 integer types - a signed ‘int’ type and an unsigned ‘uint’ type - are also represented using 29-bits in AVM+. If the value of an unsigned integer (uint) is greater or equal to 229 or if the value of a signed integer (int) is greater than or equal to 228 then it will be represented by AVM+ as a double and thus serialized in using the AMF 3 double type.

7 double type

The AMF 3 double type is encoded in the same manner as the AMF 0 Number type. This type is used to encode an ActionScript Number or an ActionScript int of value greater than or equal to 228 or an ActionScript uint of value greater than or equal to 229. The encoded value is always an 8 byte IEEE-754 double precision floating point value in network byte order (sign bit in low memory).

8 String type

ActionScript String values are represented using a single string type in AMF 3 - the concept of string and long string types from AMF 0 is not used.

Strings can be sent as a reference to a previously occurring String by using an index to the implicit string reference table.

Strings are encoding using UTF-8 - however the header may either describe a string literal or a string reference.

The empty String is never sent by reference.

9 XMLDocument type

ActionScript 3.0 introduced a new XML type (see 3.13) however the legacy XMLDocument type is retained in the language as flash.xml.XMLDocument. Similar to AMF 0, the structure of an XMLDocument needs to be flattened into a string representation for serialization. As with other strings in AMF, the content is encoded in UTF-8.

XMLDocuments can be sent as a reference to a previously occurring XMLDocument instance by using an index to the implicit object reference table.

10 Date type

In AMF 3 an ActionScript Date is serialized simply as the number of milliseconds elapsed since the epoch of midnight, 1st Jan 1970 in the UTC time zone. Local time zone information is not sent.

Dates can be sent as a reference to a previously occurring Date instance by using an index to the implicit object reference table.

11 Array type

ActionScript Arrays are described based on the nature of their indices, i.e. their type and how they are positioned in the Array. The following table outlines the terms and their meaning:

term meaning
strict contains only ordinal (numeric) indices
dense ordinal indices start at 0 and do not contain gaps between successive indices (that is, every index is defined from 0 for the length of the array)
sparse contains at least one gap between two indices
associative contains at least one non-ordinal (string) index (sometimes referred to as an ECMA Array)

AMF considers Arrays in two parts, the dense portion and the associative portion. The binary representation of the associative portion consists of name/value pairs (potentially none) terminated by an empty string. The binary representation of the dense portion is the size of the dense portion (potentially zero) followed by an ordered list of values (potentially none). The order these are written in AMF is first the size of the dense portion, an empty string terminated list of name/value pairs, followed by size values.

Arrays can be sent as a reference to a previously occurring Array by using an index to the implicit object reference table.

12 Object type

A single AMF 3 type handles ActionScript Objects and custom user classes. The term ‘traits’ is used to describe the defining characteristics of a class. In addition to ‘anonymous’ objects and ‘typed’ objects, ActionScript 3.0 introduces two further traits to describe how objects are serialized, namely ‘dynamic’ and ‘externalizable’. The following table outlines the terms and their meanings:

term meaning
Anonymous an instance of the actual ActionScript Object type or an instance of a Class without a registered alias (that will be treated like an Object on deserialization)
Typed an instance of a Class with a registered alias
Dynamic an instance of a Class definition with the dynamic trait declared; public variable members can be added and removed from instances dynamically at runtime
Externalizable an instance of a Class that implements flash.utils.IExternalizable and completely controls the serialization of its members (no property names are included in the trait information).

In addition to these characteristics, an object’s traits information may also include a set of public variable and public read-writeable property names defined on a Class (i.e. public members that are not Functions). The order of the member names is important as the member values that follow the traits information will be in the exact same order. These members are considered sealed members as they are explicitly defined by the type.

If the type is dynamic, a further section may be included after the sealed members that lists dynamic members as name / value pairs. One continues to read in dynamic members until a name that is the empty string is encountered.

Objects can be sent as a reference to a previously occurring Object by using an index to the implicit object reference table. Further more, trait information can also be sent as a reference to a previously occurring set of traits by using an index to the implicit traits reference table.

13 XML type

ActionScript 3.0 introduces a new XML type that supports E4X syntax. For serialization purposes the XML type needs to be flattened into a string representation. As with other strings in AMF, the content is encoded using UTF-8.

XML instances can be sent as a reference to a previously occurring XML instance by using an index to the implicit object reference table.

Note that this encoding imposes some theoretical limits on the use of XML. The byte- length of each UTF-8 encoded XML instance is limited to 228 - 1 bytes (approx 256 MB).

14 ByteArray

ActionScript 3.0 introduces a new type to hold an Array of bytes, namely ByteArray. AMF 3 serializes this type using a variable length encoding 29-bit integer for the byte- length prefix followed by the raw bytes of the ByteArray.

ByteArray instances can be sent as a reference to a previously occurring ByteArray instance by using an index to the implicit object reference table.

15 Usages of AMF3

15.1 NetConnection and AMF 3

In addition to serializing ActionScript types, AMF can be used in the asynchronous invocations of remote services. A simple messaging structure is used to send a batch of requests to a remote endpoint. The format of this messaging structure is AMF 0 (See [AMF0]. A context header value or message body can switch to AMF 3 encoding using the special avmplus-object-marker type.

15.2 NetConnection in ActionScript 3.0

The qualified class name for NetConnection in ActionScript 3.0 is flash.net.NetConnection. This class continues to usea responder to handle result and status responses from a remote endpoint, however, a strongly typed Responder class is now required. The fully qualified class name is flash.net.Responder. For events other than normal result and status responses NetConnection dispatches events for which the developer can add listeners. These events are outlined below:

event operation
asyncError Dispatched when an exception is thrown asynchronously - i.e. from native asynchronous code.
ioError Dispatched when an input or output error occurs that causes a network operation to fail.
netStatus Dispatched when a NetConnection object is reporting its status or error condition.
securityError Dispatched if a call to NetConnection.call() attempts to connect to a server outside the caller’s security sandbox.

To handle an AMF context header a suitable method needs to be available, matching the header name. NetConnection is now a sealed type so either it must be subclassed or an object with a suitable implementation needs to be set for the NetConnection client property.

15.3 ByteArray, IDataInput and IDataOutput

ActionScript 3.0 introduced a new type to support the manipulation of raw data in the form of an Array of bytes, namely flash.utils.ByteArray. To assist with ActionScript Object serialization and copying, ByteArray implements flash.utils.IDataInput and flash.utils.IDataOutput. These interfaces specify utility methods that help write common types to byte streams. Two methods of interest are IDataOutput.writeObject and IDataInput.readObject. These methods encode objects using AMF. The version of AMF used to encode object data is controlled by the ByteArray.objectEncoding method, which can be set to either AMF 3 or AMF 0. An enumeration type, flash.net.ObjectEncoding, holds the constants for the versions of AMF - ObjectEncoding.AMF0 and ObjectEncoding.AMF3 respectively.

Note that ByteArray.writeObject uses one version of AMF to encode the entire object. Unlike NetConnection, ByteArray does not start out in AMF 0 and switch to AMF 3 (with the objectEncoding property set to AMF 3). Also note that ByteArray uses a new set of implicit reference tables for objects, object traits and strings for each readObject and writeObject call.

Reference

  1. [AMF3] Adobe Systems Inc. “Action Message Format - AMF 3”
  2. [AMF0] Adobe Systems Inc. “Action Message Format - AMF 0”

-

转载:Blog.CSDN.net/Poechant

最新文章

  1. mvcAPI (入门 2)
  2. QString->string->wstring->LPCWSTR
  3. Android BLE开发之Android手机搜索iBeacon基站
  4. 2015北京网络赛 G题 Boxes bfs
  5. 本地nginx多域名映射
  6. 全面理解Java内存模型
  7. Docker中完成Jenkins的安装
  8. ArcGIS紧凑型缓存存储格式分析
  9. AlphaGo的前世今生(三)AlphaGo Zero: AI Revolution and Beyond
  10. Windows 之 IP地址
  11. redhat5 设置静态ip
  12. Serializers序列化组件
  13. 如何将adoquery中的数据复制到 Ttable 中
  14. Android学习笔记二:activity的理解
  15. node调试的两种方法
  16. Centos7.5搭建Hadoop2.8.5完全分布式集群部署
  17. C#的哈希表Hashtable同步方法
  18. Linux之IO Redirection
  19. javaEE面试重点
  20. Juint 单元测试(2)

热门文章

  1. System.Collections.Generic的各容器类的用法
  2. 四元数(Quaternions)简介
  3. android系统启动
  4. 七牛:关于图片 EXIF 信息中旋转参数 Orientation 的理解
  5. maven+swagger
  6. Windows注册表(持续更新)
  7. struts2 ,web.xml中配置为/*.action,运行报错Invalid <url-pattern> /*.action in filter mapp
  8. ti processor sdk linux am335x evm /bin/setup-targetfs-nfs.sh hacking
  9. Java异步调用Future对象
  10. 用gdb调试python多线程代码-记一次死锁的发现
  11. SpiderMonkey js引擎的静态编译与使用
  12. Spring 依赖注入的理解
  13. CF AIM Tech Round 3 (Div. 2) D - Recover the String
  14. C语言可变参数va_list
  15. python使用协程并发
  16. 20165223 2017-2018-2《Java程序设计》课程总结
  17. 使用CefSharp在.Net程序中嵌入Chrome浏览器(三)——基本操作
  18. jquery实现上传文件大小类型的验证
  19. oracle12c之 控制pdb中sga 与 pga 内存使用
  20. Discoverer Table