包 | mx.messaging.events |
类 | public class ChannelFaultEvent |
继承 | ChannelFaultEvent ChannelEvent Event Object |
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
属性 | 由以下参数定义 | ||
---|---|---|---|
bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | ||
cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | ||
channel : Channel
生成此事件的 Channel。 | ChannelEvent | ||
connected : Boolean
指示是否已与生成此事件的 Channel 建立连接。 | ChannelEvent | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | ||
eventPhase : uint [只读]
事件流中的当前阶段。 | Event | ||
faultCode : String
提供对特定于目标的失败代码的访问权限。 | ChannelFaultEvent | ||
faultDetail : String
提供有关此失败的特定于目标的详细信息。 | ChannelFaultEvent | ||
faultString : String
提供对此失败特定于目标的原因的访问权限。 | ChannelFaultEvent | ||
reconnecting : Boolean
指示是否正在重新连接生成此事件的通道。 | ChannelEvent | ||
rejected : Boolean
指示是否已拒绝生成此事件的通道。 | ChannelEvent | ||
rootCause : Object
如果通道本身未引发失败,则提供对此失败根本原因的访问权限。 | ChannelFaultEvent | ||
target : Object [只读]
事件目标。 | Event | ||
type : String [只读]
事件的类型。 | Event |
方法 | 由以下参数定义 | ||
---|---|---|---|
ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)
构造具有指定的类型的此事件的一个实例。 | ChannelFaultEvent | ||
[覆盖]
克隆 ChannelFaultEvent。 | ChannelFaultEvent | ||
基于 ChannelFaultEvent,通过将 faultCode、faultString、faultDetail 和 rootCause 复制到新的 ErrorMessage 中来创建 ErrorMessage。 | ChannelFaultEvent | ||
createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent [静态]
用于创建不起泡且不可取消的新 ChannelFaultEvent 的实用程序方法。 | ChannelFaultEvent | ||
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | ||
表示对象是否已经定义了指定的属性。 | Object | ||
检查是否已对事件调用 preventDefault() 方法。 | Event | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
如果可以取消事件的默认行为,则取消该行为。 | Event | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
设置循环操作动态属性的可用性。 | Object | ||
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | ||
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
[覆盖]
返回 ChannelFaultEvent 的字符串表示形式。 | ChannelFaultEvent | ||
返回指定对象的原始值。 | Object |
faultCode | 属性 |
public var faultCode:String
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
提供对特定于目标的失败代码的访问权限。有关更具体的详细信息,请参阅 faultString
和 faultDetails
属性。
错误代码的格式由远程目标提供,但通常为:host.operation.error
或 Channel.operation.error
。例如,"Server.Connect.Failed"
和 Channel.Connect.Failed
。
无论何时 Channel 试图连接到远程目标出现问题,Channel 类及其子类(RTMPChannel、AMFChannel、HTTPChannel 等等)都会发出 Channel.Connect.Failed。通道已连接并且从其基础 NetConnection 获取 Call.Failed 代码之后,AMFChannel 就会发出 Channel.Call.Failed。仅 AMFChannel 类侦听 NetConnection.Call.Failed,后者会被转换为 Channel.Call.Failed。
相关 API 元素
faultDetail | 属性 |
public var faultDetail:String
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
提供有关此失败的特定于目标的详细信息。
错误详细信息通常是对远程目标引发的异常的堆栈跟踪。
相关 API 元素
faultString | 属性 |
public var faultString:String
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
提供对此失败特定于目标的原因的访问权限。
相关 API 元素
rootCause | 属性 |
public var rootCause:Object
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
如果通道本身未引发失败,则提供对此失败根本原因的访问权限。
ChannelFaultEvent | () | 构造函数 |
public function ChannelFaultEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, channel:Channel = null, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false)
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造具有指定的类型的此事件的一个实例。请注意:与超类 ChannelEvent
定义的属性相对应的 rejected
和 connected
参数最初并未包含在此方法签名中,但已添加到参数列表的末尾,这样即使此签名与 ChannelEvent
的构造函数不同,也能保持向后兼容性。
type:String — 事件的类型。
| |
bubbles:Boolean (default = false ) — 指示该事件是否可以在显示列表层次结构得到冒泡处理。
| |
cancelable:Boolean (default = false ) — 表示是否可以阻止与事件相关联的行为。
| |
channel:Channel (default = null ) — 生成该事件的 Channel。
| |
reconnecting:Boolean (default = false ) — 指示是否正在重新连接 Channel。
| |
code:String (default = null ) — 错误代码。
| |
level:String (default = null ) — 错误级别。
| |
description:String (default = null ) — 错误描述。
| |
rejected:Boolean (default = false ) — 指示是否已拒绝 Channel 连接,此参数禁止自动进行重新连接。
| |
connected:Boolean (default = false ) — 指示是否已与生成此事件的 Channel 建立连接。
|
clone | () | 方法 |
createErrorMessage | () | 方法 |
public function createErrorMessage():ErrorMessage
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
基于 ChannelFaultEvent,通过将 faultCode、faultString、faultDetail 和 rootCause 复制到新的 ErrorMessage 中来创建 ErrorMessage。
返回ErrorMessage — ErrorMessage。
|
createEvent | () | 方法 |
public static function createEvent(channel:Channel, reconnecting:Boolean = false, code:String = null, level:String = null, description:String = null, rejected:Boolean = false, connected:Boolean = false):ChannelFaultEvent
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
用于创建不起泡且不可取消的新 ChannelFaultEvent 的实用程序方法。
参数
channel:Channel — 生成该事件的 Channel。
| |
reconnecting:Boolean (default = false ) — 指示是否正在重新连接 Channel。
| |
code:String (default = null ) — 错误代码。
| |
level:String (default = null ) — 错误级别。
| |
description:String (default = null ) — 错误描述。
| |
rejected:Boolean (default = false ) — 指示是否已拒绝 Channel 连接,此参数禁止自动进行重新连接。
| |
connected:Boolean (default = false ) — 指示是否已与生成此事件的 Channel 建立连接。
|
ChannelFaultEvent — 新 ChannelFaultEvent。
|
toString | () | 方法 |
FAULT | 常量 |
public static const FAULT:String = "channelFault"
语言版本: | ActionScript 3.0 |
产品版本: | BlazeDS 4, Adobe Digital Enterprise Platform Data Services for Java EE 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
FAULT 事件类型;指示发生错误的 Channel。
此常量的值为 "channelFault"
。
事件对象的属性有下列值:
属性 | 值 |
---|---|
bubbles | false |
cancelable | false |
channel | 生成此事件的 Channel。 |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如,如果您使用 myButton.addEventListener() 注册某个事件侦听器,则 myButton 为 currentTarget 的值。 |
faultCode | 提供有关此失败的特定于目标的详细信息。 |
faultDetail | 提供对此失败特定于目标的原因的访问权限。 |
faultString | 如果通道本身未引发失败,则提供对此失败根本原因的访问权限。 |
reconnecting | 指示是否正在重新连接生成此事件的通道。 |
rootCause | 如果通道本身未引发失败,则提供对此失败根本原因的访问权限。 |
target | 调度该事件的 Object;它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
Tue Jun 12 2018, 11:04 AM Z