ServiceMonitor  - AS3

Indique si le service est actuellement disponible (« available »).

La valeur initiale est false jusqu’à ce que la propriété soit définie sur true après une vérification d’état ou jusqu’à ce qu’elle soit définie sur true de façon explicite.

En général, cette propriété est définie lorsque la méthode checkStatus() est implémentée dans une sous-classe ou un objet specializer ; toutefois, si l’application possède des informations indépendantes sur la disponibilité d’un service (par exemple, une requête qui vient d’aboutir ou d’échouer), il est possible de définir la propriété de façon explicite.

Heure de la dernière mise à jour de l'état.

Intervalle d’interrogation du serveur, en millisecondes.

Si cet intervalle est de zéro, le serveur n’est pas interrogé régulièrement, mais uniquement après l’appel de la méthode start() et lorsque l’état du réseau change.

L’objet ServiceMonitor ne distribue qu’un événement status si l’état du service a changé (pas sur tous les intervalles d’interrogation). Cet objet distribue également un événement status suite à des modifications de connectivité réseau (quel que soit l’intervalle d’interrogation).

La valeur par défaut est 0.

Indique si le contrôle a démarré.

Crée un objet ServiceMonitor.

Cette classe est généralement sous-classée pour contrôler des types de service spécifiques.

Après avoir créé un objet ServiceMonitor (ou un objet de sous-classe), appelez la méthode start() pour procéder au contrôle de l’état du service.

A l’instar de l’objet Timer, l’appelant doit conserver une référence à l’objet ServiceMonitor. Dans le cas contraire, l’objet est supprimé à l’exécution et le contrôle cesse.

Vérifie l’état du service.

Méthode d’annulation de sous-classes pour le contrôle de l’état du service.

En règle générale, cette méthode lance une opération réseau dont la réussite ou l’échec entraîne la définition de la propriété available.

Le code JavaScript peut spécialiser cette méthode en définissant une méthode checkStatus() dans l’objet « specializer ».

Ajoute des méthodes ServiceMonitor publiques à un prototype de la fonction constructeur de JavaScript.

Ajoute des fonctions au prototype de la fonction constructeur JavaScript qui transfèrent des fonctions publiques ServiceMonitor à l’objet ServiceMonitor. Elle se rapproche d’une sous-classe JavaScript standard de la classe ActionScript de base.

Une classe JavaScript spécialisant une méthode ServiceMonitor pourrait se présenter sous la forme suivante :

     // 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);
     }
     

Pour utiliser la classe JavaScript :

     var httpMon = new MyHTTPMonitor('http://www.adobe.com')
     

Veillez à charger les fichiers AIRAliases.js et aircore.swf avec les balises script.

Paramètres

Démarre le moniteur du service.

Interrompt le moniteur du service.

Renvoie la représentation sous forme de chaîne de l’objet spécifié.

Remarque : les méthodes de la classe Object sont créées dynamiquement sur le prototype correspondant. Pour redéfinir cette méthode dans une sous-classe d’Object, n’utilisez pas le mot-clé override. Par exemple, une sous-classe d’Object implémente function toString():String au lieu d’utiliser un remplacement de la classe de base.

Indique que l’état du service a changé.

La valeur de la propriété code est soit "Service.available", soit "Service.unavailable", mais il est conseillé de vérifier la valeur de la propriété ServiceMonitor.available.

Les propriétés de cet événement sont les suivantes :