URLMonitor

パッケージ	air.net
クラス	public class URLMonitor
継承	URLMonitor ServiceMonitor EventDispatcher Object

ランタイムバージョン:

AIR 1.0

URLMonitor クラスは、HTTP または HTTPS ベースのサービスが使用可能かどうかを監視します。

このクラスは、aircore.swc ファイルに含まれます。Adobe^® AIR^® のプロジェクトを作成すると、Adobe^® Flash^® Builder によって、このクラスが自動的にロードされます。この aircore.swc ファイルは Adobe^® Flex^™ SDK にも含まれています。アプリケーションをコンパイルするときに 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 ファイルを参照します。
「OK」をクリックします。
import ステートメントの import air.net.*; を ActionScript 3.0 コードに追加します。

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		acceptableStatusCodes : Array 正常な結果を表す数値ステータスコードです。	URLMonitor
		available : Boolean サービスが現在 "使用可能" と見なされているかどうかを指定します。初期値は false です。ステータスチェックでプロパティが 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 [オーバーライド] 返された HTTP ステータスコードをチェックするために、バックグラウンドで URL からコンテンツをロードしようとします。	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（OK）
202（受け付けられました）
204（コンテンツなし）
205（コンテンツのリセット）
206（部分的なコンテンツ。Range ヘッダーを伴う要求に対する応答）

メソッドの詳細

checkStatus

()

メソッド

override protected function checkStatus():void

ランタイムバージョン:

AIR 1.0

返された HTTP ステータスコードをチェックするために、バックグラウンドで URL からコンテンツをロードしようとします。

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