用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
mx.messaging.messages 

AbstractMessage  - AS3 BlazeDS LCDS

mx.messaging.messages
public class AbstractMessage
继承AbstractMessage Inheritance Object
实现 IMessage
子类 AsyncMessage, HTTPRequestMessage, RemotingMessage

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

所有消息的抽象基类。消息包含两个可自定义的部分:标头和正文。通过 headers 属性可访问特定消息实例的专门元信息。headers 属性是以特定标头名称作为关键字的关联数组。

消息正文包含需要由远程目标传递和处理的特定实例数据。body 是作为消息有效负载的对象。



公共属性
 属性由以下参数定义
  body : Object
消息正文包含需要传递到远程目标的特定数据。
AbstractMessage
  clientId : String
ClientId 指示发送消息的 MessageAgent。
AbstractMessage
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  destination : String
消息目标。
AbstractMessage
  headers : Object
消息标头是一个关联数组,其中关键字为标头名称,而值为标头值。
AbstractMessage
  messageId : String
消息的唯一 ID。
AbstractMessage
  timestamp : Number
提供对消息时间戳的访问权限。
AbstractMessage
  timeToLive : Number
消息的生存时间值指示该消息应视为有效且可传送的时间。
AbstractMessage
公共方法
 方法由以下参数定义
  
构造一个正文和标头为空的 AbstractMessage 实例。
AbstractMessage
 Inherited
表示对象是否已经定义了指定的属性。
Object
 Inherited
表示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
  
返回消息的字符串表示形式。
AbstractMessage
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量由以下参数定义
  DESTINATION_CLIENT_ID_HEADER : String = "DSDstClientId"
[静态] 从服务器发出的消息可能按批到达,批处理过程中可能会将这些消息发送给不同的 Consumer 实例。
AbstractMessage
  ENDPOINT_HEADER : String = "DSEndpoint"
[静态] 消息将以所用发送 Channel 的端点 ID 作为标签。
AbstractMessage
  FLEX_CLIENT_ID_HEADER : String = "DSId"
[静态] 服务器指定标头后,可通过该标头在出站消息中传输全局 FlexClient Id 值。
AbstractMessage
  PRIORITY_HEADER : String = "DSPriority"
[静态] 由 MessageAgent 发送的消息可带优先级头,使用 0 到 9 数值表示(0 最低),服务器可以选择使用这种数值表示到客户端的消息的优先级。
AbstractMessage
  REMOTE_CREDENTIALS_CHARSET_HEADER : String = "DSRemoteCredentialsCharset"
[静态] 需要为目标设置远程凭据的消息还需要报告使用此标头创建凭据 String 时所用的字符集编码。
AbstractMessage
  REMOTE_CREDENTIALS_HEADER : String = "DSRemoteCredentials"
[静态] 需要为目标设置远程凭据的消息采用此标头中的 Base64 编码凭据。
AbstractMessage
  REQUEST_TIMEOUT_HEADER : String = "DSRequestTimeout"
[静态] 随定义的请求超时发送的消息将用到此标头。
AbstractMessage
  STATUS_CODE_HEADER : String = "DSStatusCode"
[静态] 一种状态代码,可以提供有关响应消息性质的上下文。
AbstractMessage
属性详细信息

body

属性
body:Object

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息正文包含需要传递到远程目标的特定数据。



实现
    public function get body():Object
    public function set body(value:Object):void

clientId

属性 
clientId:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

ClientId 指示发送消息的 MessageAgent。



实现
    public function get clientId():String
    public function set clientId(value:String):void

destination

属性 
destination:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息目标。



实现
    public function get destination():String
    public function set destination(value:String):void

headers

属性 
headers:Object

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息标头是一个关联数组,其中关键字为标头名称,而值为标头值。通过此属性可访问特定消息实例的专门元信息。核心标头名称以“DS”前缀开头。自定义标头名称应该以唯一的前缀开头,以避免名称冲突。



实现
    public function get headers():Object
    public function set headers(value:Object):void

messageId

属性 
messageId:String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息的唯一 ID。



实现
    public function get messageId():String
    public function set messageId(value:String):void

timestamp

属性 
timestamp:Number

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

提供对消息时间戳的访问权限。时间戳是发送消息的日期和时间。时间戳用于通过系统跟踪消息,以确保服务质量级别并提供消息期限机制。



实现
    public function get timestamp():Number
    public function set timestamp(value:Number):void

相关 API 元素

timeToLive

属性 
timeToLive:Number

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息的生存时间值指示该消息应视为有效且可传送的时间。此值可与 timestamp 值配合使用。生存时间指消息从指定的 timestamp 值起保持有效的时间(以毫秒为单位)。例如,如果 timestamp 值为 04/05/05 1:30:45 PST,而 timeToLive 值为 5000,则此消息将于 04/05/05 1:30:50 PST 到期。一旦消息到期,便不会传递到其它任何客户端。



实现
    public function get timeToLive():Number
    public function set timeToLive(value:Number):void
构造函数详细信息

AbstractMessage

()构造函数
public function AbstractMessage()

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

构造一个正文和标头为空的 AbstractMessage 实例。不应直接实例化或使用此消息类型。

方法详细信息

toString

()方法
public function toString():String

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

返回消息的字符串表示形式。

返回
String — 消息的字符串表示形式。
常量详细信息

DESTINATION_CLIENT_ID_HEADER

常量
public static const DESTINATION_CLIENT_ID_HEADER:String = "DSDstClientId"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

从服务器发出的消息可能按批到达,批处理过程中可能会将这些消息发送给不同的 Consumer 实例。每条消息都包含此标头,用以识别接收该消息的 Consumer 实例。

ENDPOINT_HEADER

常量 
public static const ENDPOINT_HEADER:String = "DSEndpoint"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

消息将以所用发送 Channel 的端点 ID 作为标签。通道会在发送消息时自动设置此值。

FLEX_CLIENT_ID_HEADER

常量 
public static const FLEX_CLIENT_ID_HEADER:String = "DSId"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

服务器指定标头后,可通过该标头在出站消息中传输全局 FlexClient Id 值。

PRIORITY_HEADER

常量 
public static const PRIORITY_HEADER:String = "DSPriority"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

由 MessageAgent 发送的消息可带优先级头,使用 0 到 9 数值表示(0 最低),服务器可以选择使用这种数值表示到客户端的消息的优先级。

REMOTE_CREDENTIALS_CHARSET_HEADER

常量 
public static const REMOTE_CREDENTIALS_CHARSET_HEADER:String = "DSRemoteCredentialsCharset"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

需要为目标设置远程凭据的消息还需要报告使用此标头创建凭据 String 时所用的字符集编码。

REMOTE_CREDENTIALS_HEADER

常量 
public static const REMOTE_CREDENTIALS_HEADER:String = "DSRemoteCredentials"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

需要为目标设置远程凭据的消息采用此标头中的 Base64 编码凭据。

REQUEST_TIMEOUT_HEADER

常量 
public static const REQUEST_TIMEOUT_HEADER:String = "DSRequestTimeout"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

随定义的请求超时发送的消息将用到此标头。请求超时值在出站消息上通过服务或通道设置,此值可控制在请求超时前相应的 MessageResponder 等待消息确认、结果或错误响应所需的时间。

STATUS_CODE_HEADER

常量 
public static const STATUS_CODE_HEADER:String = "DSStatusCode"

语言版本: ActionScript 3.0
产品版本: BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3
运行时版本: Flash Player 9, AIR 1.1

一种状态代码,可以提供有关响应消息性质的上下文。例如,从基于 HTTP 的通道接收的消息可能需要报告 HTTP 响应状态代码(如果可用)。





[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。