flash.events
public class HTTPStatusEvent
继承HTTPStatusEvent Inheritance Event Inheritance Object

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

在网络请求返回 HTTP 状态代码时,应用程序将调度 HTTPStatusEvent 对象。

在错误或完成事件之前,将始终发送 HTTPStatusEvent 对象。HTTPStatusEvent 对象不一定指示错误条件;它仅反映网络堆栈提供的 HTTP 状态代码(如果有的话)。一些 Flash Player 环境可能无法检测到 HTTP 状态代码;在这些情况下,将总是报告状态代码 0。

在 Flash Player 中,只有一种类型的 HTTPStatus 事件:httpStatus在 AIR 运行时中,FileReference、URLLoader 或 URLStream 可以注册侦听 httpResponseStatus,该事件包括 responseURLresponseHeaders 属性。这些属性在 httpStatus 事件中不进行定义。

查看示例



公共属性
 属性定义方
 Inheritedbubbles : Boolean
[只读 (read-only)] 指示事件是否为冒泡事件。
Event
 Inheritedcancelable : Boolean
[只读 (read-only)] 指示是否可以阻止与事件相关联的行为。
Event
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedcurrentTarget : Object
[只读 (read-only)] 当前正在使用某个事件侦听器处理 Event 对象的对象。
Event
 InheritedeventPhase : uint
[只读 (read-only)] 事件流中的当前阶段。
Event
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  AIR-only responseHeaders : Array
响应以 URLRequestHeader 对象的数组形式返回的响应标头。
HTTPStatusEvent
  AIR-only responseURL : String
从中返回响应的 URL。
HTTPStatusEvent
  status : int
[只读 (read-only)] 由服务器返回的 HTTP 状态代码。
HTTPStatusEvent
 Inheritedtarget : Object
[只读 (read-only)] 事件目标。
Event
 Inheritedtype : String
[只读 (read-only)] 事件的类型。
Event
公共方法
 方法定义方
  
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)
创建一个 Event 对象,其中包含有关 HTTP 状态事件的特定信息。
HTTPStatusEvent
  
创建 HTTPStatusEvent 对象的副本,并设置每个属性的值以匹配原始属性值。
HTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。
Event
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
检查是否已对事件调用 preventDefault() 方法。
Event
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
如果可以取消事件的默认行为,则取消该行为。
Event
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。
Event
 Inherited
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。
Event
  
返回一个字符串,其中包含 HTTPStatusEvent 对象的所有属性。
HTTPStatusEvent
 Inherited
返回指定对象的原始值。
Object
公共常量
 常量定义方
 InheritedACTIVATE : String = "activate"
[静态] ACTIVATE 常量定义 activate 事件对象的 type 属性的值。
Event
 InheritedADDED : String = "added"
[静态] Event.ADDED 常量定义 added 事件对象的 type 属性值。
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[静态] Event.ADDED_TO_STAGE 常量定义 addedToStage 事件对象的 type 属性值。
Event
 InheritedCANCEL : String = "cancel"
[静态] Event.CANCEL 常量定义 cancel 事件对象的 type 属性的值。
Event
 InheritedCHANGE : String = "change"
[静态] Event.CHANGE 常量定义 change 事件对象的 type 属性值。
Event
 InheritedCLEAR : String = "clear"
[静态] Event.CLEAR 常量定义 clear 事件对象的 type 属性的值。
Event
 InheritedCLOSE : String = "close"
[静态] Event.CLOSE 常量定义 close 事件对象的 type 属性的值。
Event
 InheritedAIR-only CLOSING : String = "closing"
[静态] Event.CLOSING 常量定义 closing 事件对象的 type 属性值。
Event
 InheritedCOMPLETE : String = "complete"
[静态] Event.COMPLETE 常量定义 complete 事件对象的 type 属性值。
Event
 InheritedCONNECT : String = "connect"
[静态] Event.CONNECT 常量定义 connect 事件对象的 type 属性值。
Event
 InheritedCOPY : String = "copy"
[静态] 定义 copy 事件对象的 type 属性值。
Event
 InheritedCUT : String = "cut"
[静态] 定义 cut 事件对象的 type 属性值。
Event
 InheritedDEACTIVATE : String = "deactivate"
[静态] Event.DEACTIVATE 常量定义 deactivate 事件对象的 type 属性值。
Event
 InheritedDISPLAYING : String = "displaying"
[静态] Event.DISPLAYING 常量定义 displaying 事件对象的 type 属性值。
Event
 InheritedENTER_FRAME : String = "enterFrame"
[静态] Event.ENTER_FRAME 常量定义 enterFrame 事件对象的 type 属性值。
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[静态] Event.EXIT_FRAME 常量定义 exitFrame 事件对象的 type 属性的值。
Event
 InheritedAIR-only EXITING : String = "exiting"
[静态] Event.EXITING 常量定义 exiting 事件对象的 type 属性值。
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[静态] Event.FRAME_CONSTRUCTED 常量定义 frameConstructed 事件对象的 type 属性的值。
Event
 InheritedFULLSCREEN : String = "fullScreen"
[静态] Event.FULL_SCREEN 常量定义 fullScreen 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[静态] Event.HTML_BOUNDS_CHANGE 常量定义 htmlBoundsChange 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[静态] Event.HTML_DOM_INITIALIZE 常量定义 htmlDOMInitialize 事件对象的 type 属性值。
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[静态] Event.HTML_RENDER 常量定义 htmlRender 事件对象的 type 属性值。
Event
  AIR-only HTTP_RESPONSE_STATUS : String = "httpResponseStatus"
[静态] 与 httpStatus 事件不同,httpResponseStatus 事件在所有响应数据之前传送。
HTTPStatusEvent
  HTTP_STATUS : String = "httpStatus"
[静态] HTTPStatusEvent.HTTP_STATUS 常量定义 httpStatus 事件对象的 type 属性值。
HTTPStatusEvent
 InheritedID3 : String = "id3"
[静态] Event.ID3 常量定义 id3 事件对象的 type 属性值。
Event
 InheritedINIT : String = "init"
[静态] Event.INIT 常量定义 init 事件对象的 type 属性值。
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[静态] Event.LOCATION_CHANGE 常量定义 locationChange 事件对象的 type 属性值。
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[静态] Event.MOUSE_LEAVE 常量定义 mouseLeave 事件对象的 type 属性值。
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[静态] Event.NETWORK_CHANGE 常量定义 networkChange 事件对象的 type 属性值。
Event
 InheritedOPEN : String = "open"
[静态] Event.OPEN 常量用于定义 open 事件对象的 type 属性值。
Event
 InheritedPASTE : String = "paste"
[静态] Event.PASTE 常量定义 paste 事件对象的 type 属性的值。
Event
 InheritedREMOVED : String = "removed"
[静态] Event.REMOVED 常量定义 removed 事件对象的 type 属性值。
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[静态] Event.REMOVED_FROM_STAGE 常量定义 removedFromStage 事件对象的 type 属性值。
Event
 InheritedRENDER : String = "render"
[静态] Event.RENDER 常量定义 render 事件对象的 type 属性的值。
Event
 InheritedRESIZE : String = "resize"
[静态] Event.RESIZE 常量定义 resize 事件对象的 type 属性的值。
Event
 InheritedSCROLL : String = "scroll"
[静态] Event.SCROLL 常量定义 scroll 事件对象的 type 属性值。
Event
 InheritedSELECT : String = "select"
[静态] Event.SELECT 常量定义 select 事件对象的 type 属性的值。
Event
 InheritedSELECT_ALL : String = "selectAll"
[静态] Event.SELECT_ALL 常量定义 selectAll 事件对象的 type 属性的值。
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[静态] Event.SOUND_COMPLETE 常量定义 soundComplete 事件对象的 type 属性值。
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[静态] Event.TAB_CHILDREN_CHANGE 常量定义 tabChildrenChange 事件对象的 type 属性值。
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[静态] Event.TAB_ENABLED_CHANGE 常量定义 tabEnabledChange 事件对象的 type 属性值。
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[静态] Event.TAB_INDEX_CHANGE 常量定义 tabIndexChange 事件对象的 type 属性值。
Event
 InheritedUNLOAD : String = "unload"
[静态] Event.UNLOAD 常量定义 unload 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[静态] Event.USER_IDLE 常量定义 userIdle 事件对象的 type 属性值。
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[静态] Event.USER_PRESENT 常量定义 userPresent 事件对象的 type 属性值。
Event
属性详细信息
AIR-only responseHeaders属性
responseHeaders:Array  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

响应以 URLRequestHeader 对象的数组形式返回的响应标头。



实现
    public function get responseHeaders():Array
    public function set responseHeaders(value:Array):void

另请参见

AIR-only responseURL属性 
responseURL:String  [读写]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

从中返回响应的 URL。对于重定向,这将与请求 URL 不同。



实现
    public function get responseURL():String
    public function set responseURL(value:String):void
status属性 
status:int  [只读 (read-only)]

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

由服务器返回的 HTTP 状态代码。例如,值为 404 表示服务器尚未找到所请求 URI 的匹配项。在 HTTP 规范(地址:ftp://ftp.isi.edu/in-notes/rfc2616.txt)的 10.4 和 10.5 节中,可以找到 HTTP 状态代码。

如果 Flash Player 或 AIR 无法从服务器获取状态代码或无法与服务器进行通信,则会将默认值 0 传递到您的代码。在任何播放器中都可生成值 0(例如,如果请求的 URL 格式不正确),并且当 Flash Player 插件在以下不将 HTTP 状态代码传递到播放器的浏览器中运行时,值 0 始终由 Flash Player 插件生成:Netscape、Mozilla、Safari、Opera 和用于 Macintosh 的 Internet Explorer。



实现
    public function get status():int
构造函数详细信息
HTTPStatusEvent()构造函数
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

创建一个 Event 对象,其中包含有关 HTTP 状态事件的特定信息。将 Event 对象作为参数传递给事件侦听器。

参数
type:String — 事件的类型。事件侦听器可以通过继承的 type 属性访问此信息。只有一种类型的 HTTPStatus 事件:HTTPStatusEvent.HTTP_STATUS
 
bubbles:Boolean (default = false) — 确定 Event 对象是否参与事件流的冒泡阶段。事件侦听器可以通过继承的 bubbles 属性访问此信息。
 
cancelable:Boolean (default = false) — 确定是否可以取消 Event 对象。事件侦听器可以通过继承的 cancelable 属性访问此信息。
 
status:int (default = 0) — 数字状态。事件侦听器可以通过 status 属性访问此信息。

另请参见

方法详细信息
clone()方法
override public function clone():Event

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

创建 HTTPStatusEvent 对象的副本,并设置每个属性的值以匹配原始属性值。

返回
Event — 其属性值与原始属性值匹配的新 HTTPStatusEvent 对象。
toString()方法 
override public function toString():String

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

返回一个字符串,其中包含 HTTPStatusEvent 对象的所有属性。字符串的格式如下:

[HTTPStatusEvent type=value bubbles=value cancelable=value status=value ]

返回
String — 一个字符串,其中包含 HTTPStatusEvent 对象的所有属性。
常量详细信息
AIR-only HTTP_RESPONSE_STATUS常量
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0

httpStatus 事件不同,httpResponseStatus 事件在传送任何响应数据之前传送。此外,httpResponseStatus 事件还包括 responseHeadersresponseURL 属性的值(对于 httpStatus,这些属性未定义)。请注意,在发送任何 completeerror 事件之前还将发送 httpResponseStatus(如果有)。

HTTPStatusEvent.HTTP_RESPONSE_STATUS 常量定义 httpResponseStatus 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubbles false
cancelable false;没有要取消的默认行为。
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
responseURL 从中返回响应的 URL。
responseHeaders 响应以 URLRequestHeader 对象的数组形式返回的响应标头。
status 由服务器返回的 HTTP 状态代码。
target 接收 HTTP 状态代码的网络对象。

另请参见

HTTP_STATUS常量 
public static const HTTP_STATUS:String = "httpStatus"

语言版本: ActionScript 3.0
运行时版本: AIR 1.0 Flash Player 9

HTTPStatusEvent.HTTP_STATUS 常量定义 httpStatus 事件对象的 type 属性值。

此事件具有以下属性:

属性
bubbles false
cancelable false;没有要取消的默认行为。
currentTarget 当前正在使用某个事件侦听器处理 Event 对象的对象。
status 由服务器返回的 HTTP 状态代码。
target 接收 HTTP 状态代码的网络对象。

另请参见

示例 如何使用示例
HTTPStatusEventExample.as

以下示例尝试从根 Web 目录 http://www.[yourDomain].com 加载一个不存在的文件,这会调度状态为 404 的 httpStatusHandler 事件,表示找不到文件。httpStatusHandler 事件由 httpStatusHandler() 进行处理,并仅输出两行事件信息。

注意:

  1. 您需要通过将“本地回放安全性”设置为“只访问网络”来编译 SWF 文件,以在此例中生成 securityError 事件。
  2. 您需要一台在 http://www.[yourDomain].com 上运行并侦听端口 80 的服务器,否则您将收到状态代码为 0 的 httpStatusHandler 事件,而不是状态代码为 404 的事件。
  3. 在 http://www.[yourDomain].com 的根 Web 目录下不能有名为 MissingFile.html 的文件,否则您将收不到正确的 httpStatusHandler 事件。

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.HTTPStatusEvent;

    public class HTTPStatusEventExample extends Sprite {

        public function HTTPStatusEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html");
            loader.load(request);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
            trace("status: " + event.status);
        }
    }
}