Pacote | air.net |
Classe | public dynamic class ServiceMonitor |
Herança | ServiceMonitor EventDispatcher Object |
Subclasses | SocketMonitor, URLMonitor |
Versões de runtime: | AIR 1.0 |
Esta classe está incluída no arquivo aircore.swc file. O Adobe® Flash™ Builder™ carrega essa classe automaticamente quando você cria um projeto no Adobe® AIR™. O SDK do Adobe® Flex™ também inclui o arquivo aircore.swc, que você deverá incluir na compilação do aplicativo se estiver usando o SDK do Flex.
No Adobe ® Flash ® CS3 Professional, esta classe está incluída no arquivo ServiceMonitorShim.swc. Para usar as classes no pacote air.net, arraste primeiro o componente ServiceMonitorShim do painel Componentes para a Biblioteca e, em seguida, adicione a seguinte instrução import
ao código do ActionScript 3.0:
import air.net.*;
Para usar o pacote air.net no Adobe ® Flash ® Professional´(CS4 ou superior):
- Selecione o comando Arquivo > Configurações de publicação.
- No painel do Flash, clique no botão Configurações do ActionScript 3.0. Selecione Caminho da biblioteca.
- Clique no botão Procurar arquivo SWC. Navegue até o arquivo Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc na pasta de instalação do Adobe Flash Professional.
- Clique no botão OK.
- Adicione a seguinte instrução
import
ao código do ActionScript 3.0:import air.net.*;
Propriedade | Definido por | ||
---|---|---|---|
available : Boolean
Se o serviço é considerado ou não "disponível" atualmente. O valor inicial é false até que a verificação de status defina a propriedade como true ou que a propriedade seja inicializada como true explicitamente. Geralmente, essa propriedade é definida pela implementação checkStatus() em uma subclasse ou specializer, mas se o aplicativo tiver informações independentes sobre a disponibilidade de um serviço (por exemplo, uma solicitação foi bem-sucedida ou falhou), a propriedade poderá ser definida explicitamente.
| ServiceMonitor | ||
constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | ||
lastStatusUpdate : Date [somente leitura]
A hora da última atualização do status. | ServiceMonitor | ||
pollInterval : Number
O intervalo, em milissegundos, para interrogar o servidor. | ServiceMonitor | ||
running : Boolean [somente leitura]
Se o monitor foi iniciado. | ServiceMonitor |
Método | Definido por | ||
---|---|---|---|
Cria um objeto ServiceMonitor. | ServiceMonitor | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | EventDispatcher | ||
Envia um evento para o fluxo de eventos. | EventDispatcher | ||
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | ||
Indica se um objeto tem uma propriedade especificada definida. | Object | ||
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | ||
[estático]
Adiciona métodos ServiceMonitor públicos a um protótipo de função do construtor JavaScript. | ServiceMonitor | ||
Indica se a propriedade especificada existe e é enumerável. | Object | ||
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | ||
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | ||
Inicia o monitor de serviço. | ServiceMonitor | ||
Para o monitoramento do serviço. | ServiceMonitor | ||
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | ||
[substituir]
Retorna a representação de string do objeto especificado. | ServiceMonitor | ||
Retorna o valor primitivo do objeto especificado. | Object | ||
Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado. | EventDispatcher |
Método | Definido por | ||
---|---|---|---|
Verifica o status do serviço. | ServiceMonitor |
Evento | Resumo | Definido por | ||
---|---|---|---|---|
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo. | EventDispatcher | |||
Indica que o status do serviço foi alterado. | ServiceMonitor |
available | propriedade |
available:Boolean
Versões de runtime: | AIR 1.0 |
Se o serviço é considerado ou não "disponível" atualmente.
O valor inicial é false
até que a verificação de status defina a propriedade como true
ou que a propriedade seja inicializada como true
explicitamente.
Geralmente, essa propriedade é definida como a implementação checkStatus()
em uma subclasse ou um specializer, mas se o aplicativo tiver informações independentes sobre a disponibilidade de um serviço (por exemplo, uma solicitação foi bem-sucedida ou falhou), a propriedade poderá ser definida explicitamente.
Implementação
public function get available():Boolean
public function set available(value:Boolean):void
lastStatusUpdate | propriedade |
pollInterval | propriedade |
pollInterval:Number
Versões de runtime: | AIR 1.0 |
O intervalo, em milissegundos, para interrogar o servidor.
Se for zero, o servidor não será interrogado periodicamente, mas apenas imediatamente após start()
ser chamado e quando o status de rede for alterado.
O objeto ServiceMonitor só envia um evento status
se o status do serviço for alterado (não em todos os intervalos de interrogação). O objeto também envia um evento status
como um resultado de alterações na conectividade de rede (independentemente do intervalo de interrogação).
O valor padrão é 0.
Implementação
public function get pollInterval():Number
public function set pollInterval(value:Number):void
running | propriedade |
ServiceMonitor | () | Construtor |
public function ServiceMonitor()
Versões de runtime: | AIR 1.0 |
Cria um objeto ServiceMonitor.
Essa classe geralmente é distribuída em subclasses para monitorar tipos de serviços específicos.
Depois de criar um objeto ServiceMonitor (ou objeto de subclasse), chame o método start()
para começar a monitorar o status do serviço.
Como com o objeto Timer, o chamador deve manter uma referência do objeto ServiceMonitor. Caso contrário, o tempo de execução exclui o objeto e o monitoramento é encerrado.
checkStatus | () | método |
protected function checkStatus():void
Versões de runtime: | AIR 1.0 |
Verifica o status do serviço.
Um método de substituição de subclasse para verificar o status do serviço.
Geralmente, esse método iniciará uma operação de rede cuja conclusão ou falha resultará na definição da propriedade available
.
O código JavaScript pode especializar esse método definindo um método checkStatus()
no objeto "specializer".
makeJavascriptSubclass | () | método |
public static function makeJavascriptSubclass(constructorFunction:Object):void
Versões de runtime: | AIR 1.0 |
Adiciona métodos ServiceMonitor públicos a um protótipo de função do construtor JavaScript.
Adiciona funções ao protótipo da função do construtor JavaScript que encaminham funções públicas ServiceMonitor para o objeto ServiceMonitor. Isso aproxima uma subclasse JavaScript normal da classe ActionScript básica.
Uma classe JavaScript que especifica um ServiceMonitor se pareceria com:
// 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 usar a classe JavaScript:
var httpMon = new MyHTTPMonitor('http://www.adobe.com')
Certifique-se de carregar os arquivos AIRAliases.js e aircore.swf com marcas script
.
Parâmetros
constructorFunction:Object — A propriedade prototype do objeto JavaScript. Por exemplo, se o objeto JavaScript que você está usando para servir como um objeto specializer é chamado MyHTTPMonitor, transmita MyHTTPMonitor.prototype como o valor para esse parâmetro.
|
start | () | método |
stop | () | método |
toString | () | método |
override public function toString():String
Versões de runtime: | AIR 1.0 |
Retorna a representação de string do objeto especificado.
Nota: os métodos da classe Object são dinamicamente criados no protótipo de Object. Para redefinir esse método em uma subclasse de Object, não use a palavra-chave override
. Por exemplo, uma subclasse de Object implementa function toString():String
em vez de usar uma substituição da classe base.
String — Uma representação de string do objeto.
|
status | Evento |
flash.events.StatusEvent
propriedade StatusEvent.type =
flash.events.StatusEvent.STATUS
Versões de runtime: | AIR 1.0 |
Indica que o status do serviço foi alterado.
O valor da propriedade code
é "Service.available"
ou "Service.unavailable"
, mas a melhor prática é verificar o valor da propriedade ServiceMonitor.available
.
type
de um objeto de evento status
.
Esse evento tem as seguintes propriedades:
Propriedade | Valor |
---|---|
bubbles | false |
cancelable | false ; não há comportamento padrão a ser cancelado. |
code | Uma descrição do status do objeto. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
nível | A categoria da mensagem, como "status" , "warning" ou "error" . |
target | O objeto que está reportando o status. |
Wed Jun 13 2018, 11:10 AM Z