air.net.URLMonitor

属性

	属性		定义方
		acceptableStatusCodes : Array 表示成功结果的数值状态代码。	URLMonitor
		available : Boolean 当前是否将服务视为“可用”。初始值为 false，直至状态检查将该属性设置为 true，或者该属性被显式初始化为 true。通常，此属性是由子类或专用函数中的 checkStatus() 实现设置的，但是，如果应用程序具有与服务可用性有关的独立信息（例如，请求刚刚成功或失败），则可以显式设置该属性。	ServiceMonitor
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		lastStatusUpdate : Date [只读 (read-only)] 上次更新状态的时间。	ServiceMonitor
		pollInterval : Number 服务器的轮询间隔（以毫秒为单位）。	ServiceMonitor
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object
		running : Boolean [只读 (read-only)] 是否已启动监视器。	ServiceMonitor
		urlRequest : URLRequest [只读 (read-only)] 表示探查请求的 URLRequest 对象。	URLMonitor

公共方法

隐藏继承的公共方法

显示继承的方法

	方法		定义方
		URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null) 为指定的基于 HTTP 或 HTTPS 的服务创建 URLMonitor 对象。	URLMonitor
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		makeJavascriptSubclass(constructorFunction:Object):void [静态] 将公共 ServiceMonitor 方法添加到 JavaScript 构造函数的原型中。	ServiceMonitor
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		start():void 启动服务监视器。	ServiceMonitor
		stop():void 停止监视服务。	ServiceMonitor
		toString():String [override] 返回指定对象的字符串表示形式。	URLMonitor
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

	方法	定义方
		checkStatus():void [override] 尝试在后台从 URL 加载内容，以检查返回的 HTTP 状态代码。	URLMonitor

摘要	定义方
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
status	指示服务状态已更改。	ServiceMonitor

属性详细信息

acceptableStatusCodes

属性

acceptableStatusCodes:Array

运行时版本:

1.0

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

urlRequest

属性

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

运行时版本:

1.0

表示探查请求的 URLRequest 对象。

构造函数详细信息

URLMonitor

()

构造函数

function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

运行时版本:

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 标头的请求）

方法详细信息

checkStatus

()

方法

protected function checkStatus():void

运行时版本:

1.0

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

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

toString

()

方法

function toString():String

运行时版本:

1.0

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

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

window.runtime 属性	window.runtime.air.net.URLMonitor

继承	URLMonitor ServiceMonitor EventDispatcher Object

面向 HTML 开发人员的 AIR 语言参考
URLMonitor