ServiceMonitor  - AS3

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.

Czas ostatniej aktualizacji stanu.

Przedział czasowy, w milisekundach, między kolejnymi operacjami pobierania danych z serwera.

Wartość zero powoduje, że serwer nie jest odpytywany okresowo, lecz tylko raz, niezwłocznie po wywołaniu funkcji start() oraz po zmianie stanu sieci.

Obiekt ServiceMonitor wywołuje zdarzenie status tylko po zmianie stanu usługi (a nie po upływie każdego przedziału czasowego odpytywania). Obiekt wywołuje również zdarzenie status w wyniku zmian stanu komunikacji sieciowej (niezależnie od przedziału czasu odpytywania).

Wartością domyślną jest 0.

Informuje, czy monitor został uruchomiony.

Tworzy obiekt ServiceMonitor.

Ta klasa zawiera zwykle podklasy, dzięki czemu może monitorować usługi określonych typów.

Po utworzeniu obiektu ServiceMonitor (lub instancji podklasy) należy 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 ServiceMonitor. W przeciwnym razie środowisko wykonawcze usunie obiekt i monitorowanie zostanie zakończone.

Sprawdza stan usługi.

Metoda przesłaniania podklasy służąca do sprawdzania stanu usługi.

Zwykle ta metoda inicjuje operację sieciową, której ukończenie lub niepowodzenie będzie podstawą do odpowiedniego ustawienia właściwości available.

Kod JavaScript może wyspecjalizować tę metodę, definiując metodę checkStatus() w obiekcie „specializer”.

Dodaje publiczne metody ServiceMonitor do prototypu funkcji konstruktora JavaScript.

Dodaje do prototypu funkcji konstruktora JavaScript funkcje przekazujące publiczne funkcje klasy ServiceMonitor obiektu ServiceMonitor. Takie rozwiązanie jest w przybliżeniu odpowiednikiem tworzenia normalnej podklasy języka JavaScript na podstawie klasy bazowej języka ActionScript.

Klasa JavaScript specjalizująca klasę ServiceMonitor miałaby następującą postać:

     // JavaScript Constructor function
     function MyHTTPMonitor(url, method)
     {
         // "that" variable makes "this" available in closures below
         var that = this;
         // Required initialization of the service monitor, returns the actual ServiceMonitor object.
         this.monitor = this.initServiceMonitor();
         // Initializes URLStream and event handlers.
         this._urlStream = new air.URLStream();
         this._urlRequest = new air.URLRequest(url);
         if (method)
         {
             this._urlRequest.method = method;
         }
         else
         {
             this._urlRequest.method = "GET";
         }
         function onStatus(event) {
             that.monitor.available = Number(event.status) == 200;
             that._urlStream.close();
         }
         function onError(event)
         {
             that.monitor.available = false;
             that._urlStream.close();
         }
         this._urlStream.addEventListener(air.HTTPStatusEvent.HTTP_RESPONSE_STATUS, onStatus);
         this._urlStream.addEventListener(air.SecurityErrorEvent.SECURITY_ERROR, onError);
         this._urlStream.addEventListener(air.IOErrorEvent.IO_ERROR, onError);
     }
     
     // Augment JavaScript prototype with public methods from ServiceMonitor
     air.ServiceMonitor.makeJavascriptSubclass(MyHTTPMonitor);
     
     // Implement specializer functions, just as you would when subclassing a JavaScript class
     MyHTTPMonitor.prototype.checkStatus = function()
     {
         air.trace('OVERRIDDEN checkStatus!', this);
         this._urlStream.load(this._urlRequest);
     }
     

Aby użyć klasy języka JavaScript:

     var httpMon = new MyHTTPMonitor('http://www.adobe.com')
     

Należy koniecznie załadować pliki AIRAliases.js oraz aircore.swf ze znacznikami script.

Parametry

Uruchamia monitor usług.

Zatrzymuje monitorowanie usługi.

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.

Wskazuje, że stan usługi uległ zmianie.

Właściwość code ma wartość "Service.available" albo "Service.unavailable", ale w praktyce sprawdza się wartość właściwości ServiceMonitor.available.

To zdarzenie ma następujące właściwości: