Pacchetto | air.net |
Classe | public dynamic class ServiceMonitor |
Ereditarietà | ServiceMonitor EventDispatcher Object |
Sottoclassi | SocketMonitor, URLMonitor |
Versioni runtime: | AIR 1.0 |
Questa classe è incusa nel file aircore.swc. Adobe® Flash™ Builder™ carica automaticamente questa classe quando create un progetto per Adobe® AIR™. L'SDK Adobe® Flex™ comprende anche questo file aircore.swc, che dovete sempre includere quando compilate l'applicazione, se utilizzate l'SDK Flex.
In Adobe ® Flash ® CS3 Professional questa classe è inclusa nel file ServiceMonitorShim.swc. Per utilizzare le classi del pacchetto air.net, dovete prima trascinare il componente ServiceMonitorShim dal pannello Componenti alla Libreria e quindi aggiungere la seguente istruzione import
al codice ActionScript 3.0:
import air.net.*;
Per utilizzare il pacchetto air.net in Adobe ® Flash ® Professional (CS4 o successivo):
- Selezionate il comando File > Impostazioni pubblicazione.
- Nel pannello Flash fate clic sul pulsante Impostazioni per ActionScript 3.0. Selezionate Percorso di libreria.
- Fate clic sul pulsante Specifica file SWC. Passate al file Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc nella cartella di installazione di Adobe Flash Professional.
- Fate clic sul pulsante OK.
- Aggiungete l'istruzione
import
seguente al codice ActionScript 3.0:import air.net.*;
Altri esempi
Proprietà | Definito da | ||
---|---|---|---|
available : Boolean
Indica se il servizio è attualmente considerato "disponibile". Il valore iniziale è false finché un controllo dello stato non imposta la proprietà su true oppure la proprietà non viene inizializzata su true esplicitamente. Generalmente, questa proprietà viene impostata dall'implementazione di checkStatus() in una sottoclasse o un oggetto di specializzazione, ma se l'applicazione contiene informazioni indipendenti sulla disponibilità del servizio (ad esempio, una richiesta appena riuscita o non riuscita), la proprietà può essere impostata esplicitamente.
| ServiceMonitor | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
lastStatusUpdate : Date [sola lettura]
L'ora dell'ultimo aggiornamento dello stato. | ServiceMonitor | ||
pollInterval : Number
L'intervallo, in millisecondi, per il polling del server. | ServiceMonitor | ||
running : Boolean [sola lettura]
Indica se il monitoraggio è stato avviato. | ServiceMonitor |
Metodo | Definito da | ||
---|---|---|---|
Crea un oggetto ServiceMonitor. | ServiceMonitor | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
[statico]
Aggiunge metodi ServiceMonitor pubblici a un prototipo di funzione di costruzione JavaScript. | ServiceMonitor | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Avvia il monitoraggio del servizio. | ServiceMonitor | ||
Interrompe il monitoraggio del servizio. | ServiceMonitor | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
[override]
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | ServiceMonitor | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
Metodo | Definito da | ||
---|---|---|---|
Verifica lo stato del servizio. | ServiceMonitor |
Evento | Riepilogo | Definito da | ||
---|---|---|---|---|
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | |||
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | |||
Indica che lo stato del servizio è cambiato. | ServiceMonitor |
available | proprietà |
available:Boolean
Versioni runtime: | AIR 1.0 |
Indica se il servizio è attualmente considerato "disponibile".
Il valore iniziale è false
finché un controllo dello stato non imposta la proprietà su true
oppure la proprietà non viene inizializzata su true
esplicitamente.
Generalmente, questa proprietà viene impostata dall'implementazione di checkStatus()
in una sottoclasse o un oggetto di specializzazione, ma se l'applicazione contiene informazioni indipendenti sulla disponibilità del servizio (ad esempio, una richiesta appena riuscita o non riuscita), la proprietà può essere impostata esplicitamente.
Implementazione
public function get available():Boolean
public function set available(value:Boolean):void
lastStatusUpdate | proprietà |
pollInterval | proprietà |
pollInterval:Number
Versioni runtime: | AIR 1.0 |
L'intervallo, in millisecondi, per il polling del server.
Se è pari a zero, il polling del server non avviene periodicamente, bensì solo immediatamente dopo la chiamata di start()
e quando lo stato della rete cambia.
L'oggetto ServiceMonitor invia un evento status
se lo stato del servizio è cambiato (non a ogni intervallo di polling). L'oggetto invia anche un evento status
a seguito di ogni cambiamento della connettività di rete (indipendentemente dall'intervallo di polling).
Il valore predefinito è 0.
Implementazione
public function get pollInterval():Number
public function set pollInterval(value:Number):void
running | proprietà |
ServiceMonitor | () | Funzione di costruzione |
public function ServiceMonitor()
Versioni runtime: | AIR 1.0 |
Crea un oggetto ServiceMonitor.
Questa classe viene solitamente utilizzata per creare sottoclassi dedicate al monitoraggio di tipi di servizi specifici.
Dopo aver creato un oggetto ServiceMonitor (o un oggetto di sottoclasse), chiamate il metodo start()
per avviare il monitoraggio dello stato del servizio.
Come con l'oggetto Timer, il chiamante deve mantenere un riferimento all'oggetto ServiceMonitor. In caso contrario, l'esecuzione runtime determina l'eliminazione dell'oggetto e la fine del monitoraggio.
checkStatus | () | metodo |
protected function checkStatus():void
Versioni runtime: | AIR 1.0 |
Verifica lo stato del servizio.
Un metodo di sostituzione della sottoclasse per la verifica dello stato del servizio.
Solitamente, questo metodo avvia un'operazione di rete il cui esito positivo o negativo determina l'impostazione della proprietà available
.
Questo metodo può essere specializzato nel codice JavaScript definendo un metodo checkStatus()
nell'oggetto "specializer".
makeJavascriptSubclass | () | metodo |
public static function makeJavascriptSubclass(constructorFunction:Object):void
Versioni runtime: | AIR 1.0 |
Aggiunge metodi ServiceMonitor pubblici a un prototipo di funzione di costruzione JavaScript.
Aggiunge funzioni al prototipo della funzione di costruzione JavaScript per inviare le funzioni ServiceMonitor pubbliche all'oggetto ServiceMonitor. In questo modo si ottiene un'approssimazione di una normale sottoclasse JavaScript della classe base ActionScript.
Una classe JavaScript che specializza un oggetto ServiceMonitor avrebbe il seguente aspetto:
// 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); }
Per utilizzare la classe JavaScript:
var httpMon = new MyHTTPMonitor('http://www.adobe.com')
Caricate i file AIRAliases.js e aircore.swf mediante dei tag script
.
Parametri
constructorFunction:Object — La proprietà prototype dell'oggetto JavaScript. Ad esempio, se l'oggetto JavaScript che utilizzate come oggetto specializer si chiama MyHTTPMonitor, passate MyHTTPMonitor.prototype come valore per questo parametro.
|
start | () | metodo |
stop | () | metodo |
toString | () | metodo |
override public function toString():String
Versioni runtime: | AIR 1.0 |
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Nota: i metodi della classe Object vengono creati dinamicamente sul prototipo di Object. Per ridefinire questo metodo in una sottoclasse di Object, non utilizzate la parola chiave override
. Ad esempio, una sottoclasse di Object implementa function toString():String
anziché utilizzare un override della classe base.
String — La rappresentazione in formato stringa dell'oggetto.
|
status | Evento |
flash.events.StatusEvent
proprietà StatusEvent.type =
flash.events.StatusEvent.STATUS
Versioni runtime: | AIR 1.0 |
Indica che lo stato del servizio è cambiato.
Il valore della proprietà code
è "Service.available"
o "Service.unavailable"
, ma è buona norma verificare il valore della proprietà ServiceMonitor.available
.
type
di un oggetto evento status
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
code | Una descrizione dello stato dell'oggetto. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
level | La categoria del messaggio, ad esempio "status" , "warning" o "error" . |
target | L'oggetto che riporta il proprio stato. |
Tue Jun 12 2018, 02:44 PM Z