(仅限 AIR)
air.net
public class URLMonitor
继承URLMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object

运行时版本: AIR 1.0

URLMonitor 类监视基于 HTTP 或 HTTPS 的服务的可用性。

若要在 JavaScript 代码中使用此类,请加载 ServiceMonitor.swf 文件,如下所示:

<script src="ServiceMonitor.swf" type="application/x-shockwave-flash">



公共属性
 属性定义方
  AIR-only acceptableStatusCodes : Array
表示成功结果的数值状态代码。
URLMonitor
 InheritedAIR-only available : Boolean
当前是否将服务视为“可用”。初始值为 false,直至状态检查将该属性设置为 true,或者该属性被显式初始化为 true。通常,此属性是由子类或专用函数中的 checkStatus() 实现设置的,但是,如果应用程序具有与服务可用性有关的独立信息(例如,请求刚刚成功或失败),则可以显式设置该属性。
ServiceMonitor
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 InheritedAIR-only lastStatusUpdate : Date
[只读 (read-only)] 上次更新状态的时间。
ServiceMonitor
 InheritedAIR-only pollInterval : Number
服务器的轮询间隔(以毫秒为单位)。
ServiceMonitor
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
 InheritedAIR-only running : Boolean
[只读 (read-only)] 是否已启动监视器。
ServiceMonitor
  AIR-only urlRequest : URLRequest
[只读 (read-only)] 表示探查请求的 URLRequest 对象。
URLMonitor
公共方法
 方法定义方
  
AIR-only URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)
为指定的基于 HTTP 或 HTTPS 的服务创建 URLMonitor 对象。
URLMonitor
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
AIR-only makeJavascriptSubclass(constructorFunction:Object):void
[静态] 将公共 ServiceMonitor 方法添加到 JavaScript 构造函数的原型中。
ServiceMonitor
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
启动服务监视器。
ServiceMonitor
 Inherited
停止监视服务。
ServiceMonitor
  
返回指定对象的字符串表示形式。
URLMonitor
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
受保护的方法
 方法定义方
  
尝试在后台从 URL 加载内容,以检查返回的 HTTP 状态代码。
URLMonitor
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
 Inherited指示服务状态已更改。ServiceMonitor
属性详细信息
AIR-only acceptableStatusCodes属性
acceptableStatusCodes:Array  [读写]

运行时版本: AIR 1.0

表示成功结果的数值状态代码。



实现
    public function get acceptableStatusCodes():Array
    public function set acceptableStatusCodes(value:Array):void
AIR-only urlRequest属性 
urlRequest:URLRequest  [只读 (read-only)]

运行时版本: AIR 1.0

表示探查请求的 URLRequest 对象。



实现
    public function get urlRequest():URLRequest
构造函数详细信息
AIR-only URLMonitor()构造函数
public function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

运行时版本: AIR 1.0

为指定的基于 HTTP 或 HTTPS 的服务创建 URLMonitor 对象。

在创建 URLMonitor 后,调用方应调用 start() 方法以开始监视服务的状态。

与 Timer 对象一样,调用方应保持对 URLMonitor 对象的引用。否则,运行时会删除该对象,从而结束监视。

URLRequest 参数指定用于轮询服务器的探查请求。通常,请求方法是 "GET""HEAD"

参数
urlRequest:URLRequest — 表示用于轮询服务器的探查请求的 URLRequest 对象。
 
acceptableStatusCodes:Array (default = null) — 一个数字状态代码数组,列出表示成功结果的代码。

如果不指定 acceptableStatusCodes 属性的值,则会将以下状态代码识别为成功响应:

  • 200(正常)
  • 202(可接受)
  • 204(无内容)
  • 205(重置内容)
  • 206(部分内容,响应带有 Range 标头的请求)
方法详细信息
AIR-only checkStatus()方法
override protected function checkStatus():void

运行时版本: AIR 1.0

尝试在后台从 URL 加载内容,以检查返回的 HTTP 状态代码。

如果接收到 acceptableStatusCodes 属性中列出的状态代码,则会将 available 属性设置为 true。如果接收到 acceptableStatusCodes 列表中以外的状态代码,或如果出现安全错误或 I/O 错误,则会将 available 属性设置为 false

AIR-only toString()方法 
override public function toString():String

运行时版本: AIR 1.0

返回指定对象的字符串表示形式。

注意:Object 类的方法是在 Object 的原型上动态创建的。要在 Object 的子类中重新定义该方法,请不要使用 override 关键字。例如,Object 的一个子类实现 function toString():String 而不使用基类覆盖。

返回
String — 对象的字符串表示形式。