| 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
importao 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.StatusEventpropriedade 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
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas