URLMonitor

套件	air.net
類別	public class URLMonitor
繼承	URLMonitor ServiceMonitor EventDispatcher Object

執行階段版本:

AIR 1.0

URLMonitor 類別會監視 HTTP 或 HTTPS 服務的可用性。

此類別已包含在 aircore.swc 檔案中。Adobe^® Flash^™ Builder 會在您建立 Adobe^® AIR^™ 的專案時，自動載入這個類別。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 無論服務目前是否視為「可用」。除非狀態檢查將該屬性設定為 true 或該屬性已明確初始化為 true，否則初始值都是 false。一般來說，這個屬性是由子類別中的 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