URLMonitor

Pakiet	air.net
Klasa	public class URLMonitor
Dziedziczenie	URLMonitor ServiceMonitor EventDispatcher Object

Wersje środowiska wykonawczego:

AIR 1.0

Klasa URLMonitor monitoruje dostępność usługi opartej na protokole HTTP lub HTTPS.

Klasa ta jest zawarta w pliku aircore.swc. Program Adobe^® Flash^™ Builder ładuje tę klasę automatycznie podczas tworzenia projektu dla środowiska Adobe^® AIR^™. Pakiet Adobe^® Flex^™ SDK również zawiera plik aircore.swc, który należy dołączyć podczas kompilowania aplikacji, jeśli używany jest program Flex SDK.

W programie Adobe^® Flash^® CS3 Professional tę klasę zawiera plik ServiceMonitorShim.swc. Aby używać klas z pakietu air.net, należy najpierw przeciągnąć składnik ServiceMonitorShim z panelu Składniki do Biblioteki, a następnie dodać poniższą instrukcję import do kodu ActionScript 3.0:

import air.net.*;

Aby korzystać z pakietu air.net w programie Adobe^® Flash^® Professional (CS4 lub nowsza wersja):

Wybierz polecenie Plik > Ustawienia publikowania.
W panelu Flash kliknij przycisk Ustawienia dla ActionScript 3.0. Wybierz opcję Ścieżka biblioteki.
Kliknij przycisk Przejdź do pliku SWC. Przejdź do pliku Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc w folderze instalacyjnym programu Adobe Flash Professional.
Kliknij przycisk OK.
Dodaj poniższą instrukcję import do kodu ActionScript 3.0: import air.net.*;

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		acceptableStatusCodes : Array Liczbowe kody stanu reprezentujące wynik pomyślny.	URLMonitor
		available : Boolean Informuje, czy usługa jest obecnie uznawana za dostępną. Wartością początkową jest false. Wartość ta zmienia się, gdy w wyniku sprawdzenia stanu właściwość zostanie ustawiona na true lub gdy właściwość zostanie jawnie zainicjowana wartością true. Zwykle ta właściwość jest ustawiana przez implementację metody checkStatus() w podklasie lub klasie typu specializer, jednak jeśli aplikacja ma z niezależnego źródła informację o dostępności usługi (np. jakieś zadanie zakończyło się właśnie powodzeniem lub niepowodzeniem), właściwość można ustawić jawnie.	ServiceMonitor
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		lastStatusUpdate : Date [tylko do odczytu] Czas ostatniej aktualizacji stanu.	ServiceMonitor
		pollInterval : Number Przedział czasowy, w milisekundach, między kolejnymi odpytaniami serwera.	ServiceMonitor
		running : Boolean [tylko do odczytu] Informuje, czy monitor został uruchomiony.	ServiceMonitor
		urlRequest : URLRequest [tylko do odczytu] Obiekt URLRequest reprezentujący żądanie sondujące.	URLMonitor

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null) Tworzy obiekt URLMonitor dla określonej usługi opartej na protokole HTTP lub HTTPS.	URLMonitor
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		makeJavascriptSubclass(constructorFunction:Object):void [statyczny] Dodaje publiczne metody ServiceMonitor do prototypu funkcji konstruktora JavaScript.	ServiceMonitor
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		start():void Uruchamia monitor usług.	ServiceMonitor
		stop():void Zatrzymuje monitorowanie usługi.	ServiceMonitor
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String [przesłanianie] Zwraca ciąg reprezentujący określony obiekt.	URLMonitor
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Metody chronione

	Metoda		Zdefiniowane przez
		checkStatus():void [przesłanianie] Próbuje w tle załadować treść spod adresu URL i sprawdza zwrócony kod stanu HTTP.	URLMonitor

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
status	Określa, że stan usługi uległ zmianie.	ServiceMonitor

Szczegół właściwości

acceptableStatusCodes

właściwość

acceptableStatusCodes:Array

Wersje środowiska wykonawczego:

AIR 1.0

Liczbowe kody stanu reprezentujące wynik pomyślny.

Implementacja
public function get acceptableStatusCodes():Array
public function set acceptableStatusCodes(value:Array):void

urlRequest

właściwość

urlRequest:URLRequest [tylko do odczytu]

Wersje środowiska wykonawczego:

AIR 1.0

Obiekt URLRequest reprezentujący żądanie sondujące.

Implementacja
public function get urlRequest():URLRequest

Konstruktor Szczegół

()

Konstruktor

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

Wersje środowiska wykonawczego:

AIR 1.0

Tworzy obiekt URLMonitor dla określonej usługi opartej na protokole HTTP lub HTTPS.

Po utworzeniu obiektu URLMonitor kod wywołujący powinien wywołać metodę start(), aby rozpocząć monitorowanie stanu usługi.

Podobnie jak w przypadku obiektu Timer, kod wywołujący powinien przechowywać odwołanie do obiektu URLMonitor. W przeciwnym razie środowisko wykonawcze mogłoby usunąć obiekt, powodując zakończenie monitorowania.

Parametr URLRequest określa żądanie sondujące w celu odpytania serwera. Zwykle będzie to żądanie "GET" lub "HEAD".

Parametry

urlRequest:URLRequest — Obiekt URLRequest reprezentujący żądanie sondujące w celu odpytania serwera.

acceptableStatusCodes:Array (default = null) — Tablica liczbowych kodów stanu reprezentujących wynik pomyślny.

Jeśli nie zostanie określona wartość właściwości acceptableStatusCodes, następujące kody stanów będą rozpoznawane jako odpowiedzi pomyślne:

200 (OK)
202 (zaakceptowano)
204 (brak treści)
205 (treść zresetowana)
206 (treść niekompletna, w odpowiedzi na żądanie z nagłówkiem Range)

Szczegół metody

checkStatus

()

metoda

override protected function checkStatus():void

Wersje środowiska wykonawczego:

AIR 1.0

Próbuje w tle wczytać zawartość pod adresem URL i sprawdza zwrócony kod stanu HTTP.

Jeśli odebrany kod stanu jest wymieniony we właściwości acceptableStatusCodes, właściwość available zostanie ustawiona na true. Jeśli odebranego kodu stanu nie ma na liście acceptableStatusCodes lub jeśli wystąpi błąd zabezpieczeń lub błąd wejścia/wyjścia, właściwość available zostanie ustawiona na false.

toString

()

metoda

override public function toString():String

Wersje środowiska wykonawczego:

AIR 1.0

Zwraca ciąg znaków reprezentujący określony obiekt.

Uwaga: Metody klasy Object są tworzone dynamicznie w prototypie klasy Object. Do ponownego zdefiniowania tej metody w podklasie Object, nie należy używać słowa kluczowego override. Na przykład zamiast nadpisania klasy podstawowej dla podklasy Object implementowana jest funkcja function toString():String.

Zwraca

String — Ciąg znaków reprezentujący obiekt.

Informacje prawne | Zasady prywatności online

URLMonitor - AS3

Klasy x

acceptableStatusCodes

urlRequest

URLMonitor

checkStatus

toString