(AIR only)
window.runtime 属性window.runtime.air.net.URLMonitor
继承URLMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object

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

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

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



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

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

urlRequest属性 
urlRequest:URLRequest  [只读 (read-only)]

表示探查请求的 URLRequest 对象。

构造函数详细信息
URLMonitor()构造函数
function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

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

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

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

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

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

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

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

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

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

toString()方法 
function toString():String

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

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

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