Pakket | air.net |
Klasse | public dynamic class ServiceMonitor |
Overerving | ServiceMonitor EventDispatcher Object |
Subklassen | SocketMonitor, URLMonitor |
Runtimeversies: | AIR 1.0 |
Deze klasse is opgenomen in het bestand aircore.swc. Adobe® Flash™ Builder™ laadt deze klasse automatisch wanneer u een project maakt voor Adobe® AIR™. De Adobe® Flex™ SDK bevat eveneens het bestand aircore.swc, dat u mee moet insluiten wanneer u de toepassing compileert als u Flex SDK gebruikt.
In Adobe ® Flash ® CS3 Professional, is deze klasse opgenomen in het bestand ServiceMonitorShim.swc. Sleep eerst de component ServiceMonitorShim vanuit het deelvenster Componenten naar de Bibliotheek en voeg vervolgens de volgende instructie import
aan uw ActionScript 3.0-code toe als u klassen in het air.net-pakket wilt gebruiken:
import air.net.*;
Zo gebruikt u het pakket air.net in Adobe® Flash® Professional (CS4 of hoger):
- Kies de opdracht Bestand > Instellingen publiceren.
- Klik in het Flash-deelvenster op de knop Instellingen voor ActionScript 3.0. Selecteer Bibliotheekpad.
- Klik op de knop Bladeren naar SWC-bestand. Blader naar het bestand Adobe Flash CSn/AIKn.n/framework/libs/air/aircore.swc in de installatiemap van Adobe Flash Professional.
- Klik op de knop OK.
- Voeg de volgende
import
-instructie toe aan de ActionScript 3.0-code:import air.net.*;
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
available : Boolean
Of de service momenteel als "available" wordt beschouwd. De beginwaarde is false totdat een statuscontrole de eigenschap instelt op true, of totdat de eigenschap expliciet wordt geïnitialiseerd naar true. Doorgaans wordt deze eigenschap ingesteld door de implementatie checkStatus() in een subklasse of specializer, maar als de toepassing onafhankelijke informatie bezit over de beschikbaarheid van een service (bijvoorbeeld een aanvraag die zopas is gelukt of mislukt) kan de eigenschap expliciet worden ingesteld.
| ServiceMonitor | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
lastStatusUpdate : Date [alleen-lezen]
Het tijdstip van de laatste statusupdate. | ServiceMonitor | ||
pollInterval : Number
Het interval, in milliseconden, om de server te pollen. | ServiceMonitor | ||
running : Boolean [alleen-lezen]
Of de monitor is gestart. | ServiceMonitor |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een object ServiceMonitor. | ServiceMonitor | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
[statisch]
Voegt publieke ServiceMonitor-methoden toe aan het prototype van een JavaScript-constructorfunctie. | ServiceMonitor | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
De servicemonitor starten. | ServiceMonitor | ||
Stopt de controle van de service. | ServiceMonitor | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
[overschrijven]
Retourneert een tekenreeksrepresentatie van het opgegeven object. | ServiceMonitor | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
Methode | Gedefinieerd door | ||
---|---|---|---|
Controleert de status van de service. | ServiceMonitor |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Hiermee wordt aangegeven dat de servicestatus is gewijzigd. | ServiceMonitor |
available | eigenschap |
available:Boolean
Runtimeversies: | AIR 1.0 |
Of de service momenteel als "available" wordt beschouwd.
De beginwaarde is false
totdat een statuscontrole de eigenschap instelt op true
, of totdat de eigenschap expliciet wordt geïnitialiseerd naar true
.
Doorgaans wordt deze eigenschap ingesteld door de implementatie checkStatus()
in een subklasse of specializer, maar als de toepassing onafhankelijke informatie bezit over de beschikbaarheid van een service (bijvoorbeeld een aanvraag die zopas is gelukt of mislukt) kan de eigenschap expliciet worden ingesteld.
Implementatie
public function get available():Boolean
public function set available(value:Boolean):void
lastStatusUpdate | eigenschap |
pollInterval | eigenschap |
pollInterval:Number
Runtimeversies: | AIR 1.0 |
Het interval, in milliseconden, om de server te pollen.
Indien nul wordt de server niet periodiek gepolled, maar alleen onmiddellijk nadat start()
wordt aangeroepen en wanneer de netwerkstatus gewijzigd wordt.
Het object ServiceMonitor verzendt alleen een gebeurtenis status
als de servicestatus gewijzigd is (niet bij elk pollinterval). Het object verzendt ook een gebeurtenis status
als gevolg van wijzigingen in de netwerkconnectiviteit (onafhankelijk van het pollinterval).
De standaardwaarde is 0.
Implementatie
public function get pollInterval():Number
public function set pollInterval(value:Number):void
running | eigenschap |
ServiceMonitor | () | Constructor |
public function ServiceMonitor()
Runtimeversies: | AIR 1.0 |
Maakt een object ServiceMonitor.
Deze klasse is doorgaans een subklasse van monitorspecifieke servicetypen.
Nadat de aanroeper een object ServiceMonitor (of een subklasseobject) heeft gecreëerd, moet u de methode start()
aanroepen om de status van de service te controleren.
Net zoals bij het object Timer moet de aanroeper een referentie naar het object ServiceMonitor behouden. Anders zal de runtime het object verwijderen en wordt de controle beëindigd.
checkStatus | () | methode |
protected function checkStatus():void
Runtimeversies: | AIR 1.0 |
Controleert de status van de service.
Een subklasse van overschrijvingsmethoden voor het controleren van de status van de service.
Doorgaans zal deze method een netwerkbewerking initiëren waarvan de lukken of het mislukken zal resulteren in het instellen van de eigenschap available
.
JavaScript-code kan deze methode specialiseren door een methode checkStatus()
in het object "specializer" te definiëren.
makeJavascriptSubclass | () | methode |
public static function makeJavascriptSubclass(constructorFunction:Object):void
Runtimeversies: | AIR 1.0 |
Voegt publieke ServiceMonitor-methoden toe aan het prototype van een JavaScript-constructorfunctie.
Voegt functies toe aan het prototype van een JavaScript-constructorfunctie die publieke ServiceMonitor-functies naar het ServiceMonitor-object doorsturen. Dit benadert een normale JavaScript-subklasse van de basisklasse ActionScript.
Een JavaScript-klasse die een ServiceMonitor specialiseert zou er als volgt uitzien:
// 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); }
U kunt de JavaScript-klasse als volgt gebruiken:
var httpMon = new MyHTTPMonitor('http://www.adobe.com')
Laad de bestanden AIRAliases.js en aircore.swf met de tags script
.
Parameters
constructorFunction:Object — De eigenschap prototype van het JavaScript-object. Als bijvoorbeeld het JavaScript-object dat u als objectspecializer gebruikt de naam MyHTTPMonitor heeft, moet u MyHTTPMonitor.prototype doorgeven als de waarde voor deze parameter.
|
start | () | methode |
stop | () | methode |
toString | () | methode |
override public function toString():String
Runtimeversies: | AIR 1.0 |
Retourneert een tekenreeksrepresentatie van het opgegeven object.
Opmerking: methoden van de klasse Object worden dynamisch gemaakt in het prototype van Object. Wanneer u deze methode opnieuw wilt definiëren in een subklasse van Object, moet u het trefwoord override
niet gebruiken. Bijvoorbeeld, een subklasse van Object implementeert de functie toString():String
in plaats van dat deze de basisklasse overschrijft.
String — De tekenreeksrepresentatie van het object.
|
status | Gebeurtenis |
flash.events.StatusEvent
eigenschap StatusEvent.type =
flash.events.StatusEvent.STATUS
Runtimeversies: | AIR 1.0 |
Hiermee wordt aangegeven dat de servicestatus is gewijzigd.
De waarde van de eigenschap code
is ofwel "Service.available"
ofwel "Service.unavailable"
, maar het wordt aangeraden de waarde van de eigenschap ServiceMonitor.available
te controleren.
type
van een gebeurtenisobject status
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
code | Beschrijving van de status van het object. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
level | De categorie van het bericht, zoals "status" , "warning" of "error" . |
target | Het object dat zijn status rapporteert. |
Wed Jun 13 2018, 11:42 AM Z