URLMonitor

包	air.net
类	public class URLMonitor
继承	URLMonitor ServiceMonitor EventDispatcher Object

运行时版本:

AIR 1.0

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

此类包含在 aircore.swc 文件中。创建 Adobe^® AIR^™ 项目时，Adobe^® Flash^™ Builder 将自动加载此类。Adobe^® Flex^™ SDK 也包含此 aircore.swc 文件，当您使用 Flex SDK 编译应用程序时应包含此文件。

在 Adobe ^® Flash ^® CS3 Professional 中，此类包含在 ServiceMonitorShim.swc 文件中。要使用 air.net 包中的类，必须先将 ServiceMonitorShim 组件从“组件”面板拖到“库”中，然后将以下 import 语句添加到 ActionScript 3.0 代码中：

import air.net.*;

要在 Adobe ^® Flash ^® Professional（CS4 或更高版本）中使用 air.net 包：

选择“文件”>“发布设置”命令。
在 Flash 面板中，单击 ActionScript 3.0 对应的“设置”按钮。选择“库路径”。
单击“浏览到 SWC 文件”按钮。浏览到 Adobe Flash Professional 安装文件夹中的 Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc 文件。
单击“确定”按钮。
将下面的 import 语句添加到 ActionScript 3.0 代码中：import air.net.*;

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		acceptableStatusCodes : Array 表示成功结果的数值状态代码。	URLMonitor
		available : Boolean 当前是否将服务视为“可用”。初始值为 false，直至状态检查将该属性设置为 true，或者该属性被明确初始化为 true。通常，此属性是由子类或专用函数中的 checkStatus() 实现设置的，但是，如果应用程序具有与服务可用性有关的独立信息（例如，请求刚刚成功或失败），则可以明确设置该属性。	ServiceMonitor
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		lastStatusUpdate : Date [只读] 上次更新状态的时间。	ServiceMonitor
		pollInterval : Number 服务器的轮询间隔（以毫秒为单位）。	ServiceMonitor
		running : Boolean [只读] 是否已启动监视器。	ServiceMonitor
		urlRequest : URLRequest [只读] 表示探查请求的 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
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String [覆盖] 返回指定对象的字符串表示形式。	URLMonitor
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

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

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

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

属性详细信息

acceptableStatusCodes

属性

acceptableStatusCodes:Array

运行时版本:

AIR 1.0

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

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

urlRequest

属性

urlRequest:URLRequest [只读]

运行时版本:

AIR 1.0

表示探查请求的 URLRequest 对象。

实现
public function get urlRequest():URLRequest

构造函数详细信息

()

构造函数

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

方法详细信息

checkStatus

()

方法

override protected function checkStatus():void

运行时版本:

AIR 1.0

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

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

toString

()

方法

override public function toString():String

运行时版本:

AIR 1.0

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

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

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

法律声明 | 在线隐私策略

URLMonitor - AS3

类 x

acceptableStatusCodes

urlRequest

URLMonitor

checkStatus

toString