air.netURLMonitor La classe URLMonitor surveille la disponibilité d’un service de type HTTP ou HTTPS.air.net:ServiceMonitor La classe URLMonitor surveille la disponibilité d’un service de type HTTP ou HTTPS.

Cette classe est incluse dans le fichier aircore.swc. Adobe® Flash™ Builder charge cette classe automatiquement lors de la création d’un projet pour Adobe® AIR™. Le kit de développement d’Adobe® Flex™ comprend également le fichier aircore.swc, que vous devez inclure lors de la compilation de l’application.

Dans Adobe® Flash® CS3 Professional, cette classe est incluse dans le fichier ServiceMonitorShim.swc. Pour utiliser les classes du package air.net, vous devez tout d’abord faire glisser le composant ServiceMonitorShim situé dans le panneau Composants jusqu’à la bibliothèque, puis ajouter l’instruction import suivante à votre code ActionScript 3.0 :

import air.net.~~;

Pour utiliser le package air.net dans Adobe® Flash® Professional (CS4 ou version ultérieure) :

  1. Sélectionnez la commande Fichier > Paramètres de publication.
  2. Dans le panneau Flash, cliquez sur le bouton Paramètres pour ActionScript 3.0, puis sélectionnez Chemin de la bibliothèque.
  3. Cliquez sur le bouton Localiser le fichier SWC. Recherchez le fichier Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dans le dossier d’installation d’Adobe Flash Professional.
  4. Cliquez sur le bouton OK.
  5. Ajoutez l'instruction import suivante à votre code ActionScript 3.0 : import air.net.~~;
URLMonitor Crée un objet URLMonitor pour un service HTTP ou HTTPS spécifique.urlRequestflash.net:URLRequestObjet URLRequest représentant une requête de sondage pour interroger le serveur. acceptableStatusCodesArraynullTableau de codes d’état numériques qui répertorie les codes représentant un résultat satisfaisant.

Si vous ne spécifiez aucune valeur pour la propriété acceptableStatusCodes, les codes d’état suivants sont considérés comme réponses satisfaisantes :

  • 200 (OK)
  • 202 (Accepté)
  • 204 (Pas de contenu)
  • 205 (Contenu réinitialisé)
  • 206 (Contenu partiel, en réponse à la requête comportant un en-tête Range)
Crée un objet URLMonitor pour un service HTTP ou HTTPS spécifique.

Après avoir créé un objet URLMonitor, l’appelant doit appeler 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 URLMonitor. Dans le cas contraire, l’objet pourrait être supprimé à l’exécution, ce qui mettrait fin au contrôle.

Un paramètre URLRequest spécifie la requête de sondage permettant d’interroger le serveur. En règle générale, la méthode de requête est soit "GET", soit "HEAD".

checkStatus Il s’est produit une tentative de chargement de contenu dans l’arrière-plan à partir d’une URL en vue de vérifier un code d’état HTTP renvoyé. Il s’est produit une tentative de chargement de contenu dans l’arrière-plan à partir d’une URL en vue de vérifier un code d’état HTTP renvoyé.

Si un code d’état répertorié dans la propriété acceptableStatusCodes est reçu, la propriété available est définie sur true. Si un code d’état ne figurant pas dans la liste des propriétés acceptableStatusCodes est reçu, ou s’il existe une erreur de sécurité ou d’E/S, la propriété available est définie sur false.

toString Renvoie la représentation sous forme de chaîne de l’objet spécifié.Représentation sous forme de chaîne de l’objet. String 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.

acceptableStatusCodes Codes d’état numériques représentant un résultat satisfaisant.Array Codes d’état numériques représentant un résultat satisfaisant. urlRequest Objet URLRequest représentant la requête de sondage.flash.net:URLRequest Objet URLRequest représentant la requête de sondage. ServiceMonitor La classe ServiceMonitor implémente la structure qui permet de surveiller l’état et la disponibilité des services réseau.flash.events:EventDispatcher La classe ServiceMonitor implémente la structure qui permet de surveiller l’état et la disponibilité des services réseau. La classe ServiceMonitor agit en tant que classe de base de tous les autres moniteurs de services.

Cette classe est incluse dans le fichier aircore.swc. Adobe® Flash™ Builder™ charge cette classe automatiquement lors de la création d’un projet pour Adobe ® AIR™. Le kit de développement d’Adobe® Flex™ comprend également le fichier aircore.swc, que vous devez inclure lors de la compilation de l’application.

Dans Adobe® Flash® CS3 Professional, cette classe est incluse dans le fichier ServiceMonitorShim.swc. Pour utiliser les classes du package air.net, vous devez tout d’abord faire glisser le composant ServiceMonitorShim situé dans le panneau Composants jusqu’à la bibliothèque, puis ajouter l’instruction import suivante à votre code ActionScript 3.0 :

import air.net.~~;

Pour utiliser le package air.net dans Adobe® Flash® Professional (CS4 ou version ultérieure) :

  1. Sélectionnez la commande Fichier > Paramètres de publication.
  2. Dans le panneau Flash, cliquez sur le bouton Paramètres pour ActionScript 3.0, puis sélectionnez Chemin de la bibliothèque.
  3. Cliquez sur le bouton Localiser le fichier SWC. Recherchez le fichier Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dans le dossier d’installation d’Adobe Flash Professional.
  4. Cliquez sur le bouton OK.
  5. Ajoutez l'instruction import suivante à votre code ActionScript 3.0 : import air.net.~~;
status Indique que l’état du service a changé.flash.events.StatusEvent.STATUSflash.events.StatusEvent 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.

ServiceMonitor Crée un objet ServiceMonitor. 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.

checkStatus Vérifie l’état du service. 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 ».

makeJavascriptSubclass Ajoute des méthodes ServiceMonitor publiques à un prototype de la fonction constructeur de JavaScript.constructorFunctionObjectPropriété prototype de l’objet JavaScript. Par exemple, si l’objet JavaScript que vous utilisez pour agir comme objet specializer est nommé MyHTTPMonitor, transmettez MyHTTPMonitor.prototype comme valeur de ce paramètre. 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.

start Démarre le moniteur du service. Démarre le moniteur du service. stop Interrompt le moniteur du service. Interrompt le moniteur du service. toString Renvoie la représentation sous forme de chaîne de l’objet spécifié.Représentation sous forme de chaîne de l’objet. String 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.

available 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. Boolean 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.

lastStatusUpdate Heure de la dernière mise à jour de l'état.Date Heure de la dernière mise à jour de l'état. pollInterval Intervalle d’interrogation du serveur, en millisecondes.Number0 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).

running Indique si le contrôle a démarré.Boolean Indique si le contrôle a démarré. SecureSocketMonitor Un objet SecureSocketMonitor gère la disponibilité d’un point de terminaison TCP via les protocoles SSL (Secure Sockets Layer) et TLS (Transport Layer Security).air.net:SocketMonitor Un objet SecureSocketMonitor gère la disponibilité d’un point de terminaison TCP via les protocoles SSL (Secure Sockets Layer) et TLS (Transport Layer Security).

Cette classe est incluse dans le fichier aircore.swc. Flash Builder charge cette classe automatiquement lors de la création d’un projet pour AIR. Le kit de développement de Flex comprend également le fichier aircore.swc, que vous devez inclure lors de la compilation de l’application.

Dans Adobe® Flash® CS3 Professional, cette classe est incluse dans le fichier ServiceMonitorShim.swc. Pour utiliser les classes du package air.net, vous devez tout d’abord faire glisser le composant ServiceMonitorShim situé dans le panneau Composants jusqu’à la bibliothèque, puis ajouter l’instruction import suivante à votre code ActionScript 3.0 :

import air.net.~~;

Pour utiliser le package air.net dans Adobe® Flash® Professional (CS4 ou version ultérieure) :

  1. Sélectionnez la commande Fichier > Paramètres de publication.
  2. Dans le panneau Flash, cliquez sur le bouton Paramètres pour ActionScript 3.0, puis sélectionnez Chemin de la bibliothèque.
  3. Cliquez sur le bouton Localiser le fichier SWC. Recherchez le fichier Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dans le dossier d’installation d’Adobe Flash Professional.
  4. Cliquez sur le bouton OK.
  5. Ajoutez l'instruction import suivante à votre code ActionScript 3.0 : import air.net.~~;
SecureSocketMonitor Crée un objet SecureSocketMonitor pour le point de terminaison TCP spécifié.hostStringHôte à surveiller. portintPort à surveiller. Crée un objet SecureSocketMonitor pour le point de terminaison TCP spécifié.

Après avoir créé un objet SecureSocketMonitor, l’appelant doit appeler la méthode start pour procéder au contrôle de l’état du service.

Comme avec l’objet Timer, l’appelant doit conserver une référence à l’objet SecureSocketMonitor. Dans le cas contraire, l’objet est supprimé à l’exécution et le contrôle cesse.

createSocket Crée un objet SecureSocket.SecureSocket L’objet SecureSocket à utiliser par cette classe SocketMonitor ou null si les sockets sécurisés ne sont pas pris en charge sur le système actuel. flash.net:Socket Crée un objet SecureSocket. toString Renvoie la représentation sous forme de chaîne de l’objet spécifié.Représentation sous forme de chaîne de l’objet. String 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.

SocketMonitor Un objet SocketMonitor gère la disponibilité d’un point de terminaison TCP.air.net:ServiceMonitor Un objet SocketMonitor gère la disponibilité d’un point de terminaison TCP.

Cette classe est incluse dans le fichier aircore.swc. Flash Builder charge cette classe automatiquement lors de la création d’un projet pour AIR. Le kit de développement de Flex comprend également le fichier aircore.swc, que vous devez inclure lors de la compilation de l’application.

Dans Adobe® Flash® CS3 Professional, cette classe est incluse dans le fichier ServiceMonitorShim.swc. Pour utiliser les classes du package air.net, vous devez tout d’abord faire glisser le composant ServiceMonitorShim situé dans le panneau Composants jusqu’à la bibliothèque, puis ajouter l’instruction import suivante à votre code ActionScript 3.0 :

import air.net.~~;

Pour utiliser le package air.net dans Adobe® Flash® Professional (CS4 ou version ultérieure) :

  1. Sélectionnez la commande Fichier > Paramètres de publication.
  2. Dans le panneau Flash, cliquez sur le bouton Paramètres pour ActionScript 3.0, puis sélectionnez Chemin de la bibliothèque.
  3. Cliquez sur le bouton Localiser le fichier SWC. Recherchez le fichier Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc dans le dossier d’installation d’Adobe Flash Professional.
  4. Cliquez sur le bouton OK.
  5. Ajoutez l'instruction import suivante à votre code ActionScript 3.0 : import air.net.~~;
SocketMonitor Crée un objet SocketMonitor pour un point de fin TCP spécifique.hostStringHôte à surveiller. portintPort à surveiller. Crée un objet SocketMonitor pour un point de fin TCP spécifique.

Après avoir créé un objet SocketMonitor, l’appelant doit appeler la méthode start pour commencer à surveiller l’état du service.

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

checkStatus Lors de l’appel de la méthode checkStatus() d’un objet SocketMonitor, l’application tente de se connecter au socket en vue de détecter un événement connect. Lors de l’appel de la méthode checkStatus() d’un objet SocketMonitor, l’application tente de se connecter au socket en vue de détecter un événement connect. createSocket Crée un objet Socket.L’objet Socket à utiliser par cette classe SocketMonitor. flash.net:Socket Crée un objet Socket. toString Renvoie la représentation sous forme de chaîne de l’objet spécifié.Représentation sous forme de chaîne de l’objet. String 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.

host Hôte faisant l’objet d’une surveillance.String Hôte faisant l’objet d’une surveillance. port Port faisant l’objet d’une surveillance.int Port faisant l’objet d’une surveillance.