Paquete | air.net |
Clase | public dynamic class ServiceMonitor |
Herencia | ServiceMonitor EventDispatcher Object |
Subclases | SocketMonitor, URLMonitor |
Versiones de motor de ejecución: | AIR 1.0 |
Esta clase está incluida en el archivo aircore.swc. Adobe® Flash™ Builder™ carga esta clase automáticamente al crear un proyecto para Adobe® AIR™. El SDK de Adobe® Flex™ también contiene este archivo aircore.swc, que se debe incluir al compilar la aplicación si se utiliza el SDK de Flex.
En Adobe ® Flash ® CS3 Professional, esta clase se incluye en el archivo ServiceMonitorShim.swc. Para utilizar las clases del paquete air.net, primero debe arrastrar el componente ServiceMonitorShim desde el panel Componentes a la Biblioteca y, después, añadir la siguiente declaración import
al código ActionScript 3.0:
import air.net.*;
Para utilizar el paquete air.net en Adobe® Flash® Professional (CS4 o posterior):
- Seleccione el comando Archivo > Configuración de publicación.
- En el panel Flash, haga clic en el botón Configuración de Seleccionar ruta de biblioteca de ActionScript 3.0.
- Haga clic en el botón Navegar hasta el archivo SWC. En la carpeta de instalación de Adobe Flash Professional, navegue hasta Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc.
- Haga clic en el botón Aceptar.
- Añada la siguiente sentencia
import
al código ActionScript 3.0:import air.net.*;
Propiedad | Definido por | ||
---|---|---|---|
available : Boolean
Si el servicio se considera "disponible" en este momento. El valor inicial es false hasta que una comprobación de estado establece la propiedad como true o la propiedad se inicializa en true de forma explícita. Normalmente, esta propiedad se establece mediante la implementación de checkStatus() en una subclase o especializador, pero si la aplicación tiene información independiente sobre la disponibilidad del servicio (por ejemplo, acaba de fallar o realizarse correctamente una petición), la propiedad se puede establecer explícitamente.
| ServiceMonitor | ||
constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | ||
lastStatusUpdate : Date [solo lectura]
Hora de la última actualización del estado. | ServiceMonitor | ||
pollInterval : Number
Intervalo, en milisegundos, para sondear el servidor. | ServiceMonitor | ||
running : Boolean [solo lectura]
Si la supervisión se ha iniciado. | ServiceMonitor |
Método | Definido por | ||
---|---|---|---|
Crea un objeto ServiceMonitor. | ServiceMonitor | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | ||
Distribuye un evento en el flujo del evento. | EventDispatcher | ||
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
[estática]
Añade métodos ServiceMonitor públicos a un prototipo de función de constructor de JavaScript. | ServiceMonitor | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Inicia la supervisión del servicio. | ServiceMonitor | ||
Detiene la supervisión del servicio. | ServiceMonitor | ||
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | ||
[override]
Devuelve la representación de cadena del objeto especificado. | ServiceMonitor | ||
Devuelve el valor simple del objeto especificado. | Object | ||
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher |
Método | Definido por | ||
---|---|---|---|
Comprueba el estado del servicio. | ServiceMonitor |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Indica que el estado del servicio ha cambiado. | ServiceMonitor |
available | propiedad |
available:Boolean
Versiones de motor de ejecución: | AIR 1.0 |
Si el servicio se considera "disponible" en este momento.
El valor inicial es false
hasta que una comprobación de estado establece la propiedad como true
o la propiedad se inicializa en true
de forma explícita.
Normalmente, esta propiedad se establece mediante la implementación de checkStatus()
en una subclase o especializador, pero si la aplicación tiene información independiente sobre la disponibilidad del servicio (por ejemplo, acaba de fallar o realizarse correctamente una petición), la propiedad se puede establecer explícitamente.
Implementación
public function get available():Boolean
public function set available(value:Boolean):void
lastStatusUpdate | propiedad |
pollInterval | propiedad |
pollInterval:Number
Versiones de motor de ejecución: | AIR 1.0 |
Intervalo, en milisegundos, para sondear el servidor.
Si es cero, el servidor no se sondea periódicamente, sino inmediatamente después de haber llamado a start()
y cuando cambia el estado de la red.
El objeto ServiceMonitor sólo distribuye un evento status
si el estado del servicio cambia (no en cada intervalo de sondeo). El objeto también distribuye un evento status
como resultado de los cambios en la conectividad de la red (independientemente del intervalo de sondeo).
El valor predeterminado es 0.
Implementación
public function get pollInterval():Number
public function set pollInterval(value:Number):void
running | propiedad |
ServiceMonitor | () | Información sobre |
public function ServiceMonitor()
Versiones de motor de ejecución: | AIR 1.0 |
Crea un objeto ServiceMonitor.
Esta clase suele tener varias subclases para supervisar tipos concretos de servicios.
Una vez creado el objeto ServiceMonitor (o un objeto de su subclase), llame al método start()
para comenzar la supervisión del estado del servicio.
Al igual que ocurre con el objeto Timer, el llamante debe conservar una referencia al objeto ServiceMonitor. En caso contrario, el motor de ejecución elimina el objeto y finaliza la supervisión.
checkStatus | () | método |
protected function checkStatus():void
Versiones de motor de ejecución: | AIR 1.0 |
Comprueba el estado del servicio.
Método de anulación de subclase para comprobar el estado del servicio.
Normalmente, este método inicia una operación cuya realización correcta o fallo termina configurando la propiedad available
.
El código JavaScript puede especializar este método definiendo un método checkStatus()
en el objeto "specializer".
makeJavascriptSubclass | () | método |
public static function makeJavascriptSubclass(constructorFunction:Object):void
Versiones de motor de ejecución: | AIR 1.0 |
Añade métodos ServiceMonitor públicos a un prototipo de función de constructor de JavaScript.
Añade funciones al prototipo de función de constructor de JavaScript que reenvía las funciones de ServiceMonitor al objeto ServiceMonitor. De este modo, su funcionamiento es similar al de una subclase normal de JavaScript de la clase base de ActionScript.
Una clase de JavaScript especializada en ServiceMonitor tiene el siguiente aspecto:
// 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); }
Para utilizar la clase de JavaScript:
var httpMon = new MyHTTPMonitor('http://www.adobe.com')
Asegúrese de que los archivos AIRAliases.js y aircore.swf están cargados con etiquetas script
.
Parámetros
constructorFunction:Object — Propiedad prototype del objeto de JavaScript. Por ejemplo, si el objeto de JavaScript que está utilizando como objeto especializador se llama MyHTTPMonitor, transfiera MyHTTPMonitor.prototype como valor de este parámetro.
|
start | () | método |
public function start():void
Versiones de motor de ejecución: | AIR 1.0 |
Inicia la supervisión del servicio.
stop | () | método |
public function stop():void
Versiones de motor de ejecución: | AIR 1.0 |
Detiene la supervisión del servicio.
toString | () | método |
override public function toString():String
Versiones de motor de ejecución: | AIR 1.0 |
Devuelve la representación de cadena del objeto especificado.
Nota: los métodos de la clase Object se crean dinámicamente en el prototipo de Object. Para redefinir este método en una subclase de Object, no utilice la palabra clave override
. Por ejemplo, una subclase de Object implementa function toString():String
en lugar de utilizar una sustitución de la clase base.
String — Una representación de cadena del objeto.
|
status | Evento |
flash.events.StatusEvent
propiedad StatusEvent.type =
flash.events.StatusEvent.STATUS
Versiones de motor de ejecución: | AIR 1.0 |
Indica que el estado del servicio ha cambiado.
El valor de la propiedad code
es "Service.available"
o "Service.unavailable"
, pero lo recomendable es comprobar el valor de la propiedad ServiceMonitor.available
.
type
de un objeto de evento status
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
code | Descripción del estado del objeto. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
level | La categoría del mensaje, por ejemplo, "status" , "warning" o "error" . |
target | El objeto que informa sobre su estado. |
Tue Jun 12 2018, 02:12 PM Z