Packageflash.events
Classepublic class HTTPStatusEvent
HéritageHTTPStatusEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

L'application distribue des objets HTTPStatusEvent lorsqu'une requête réseau renvoie un code d'état HTTP.

Les objets HTTPStatusEvent sont toujours envoyés avant les événements d'erreur ou d'achèvement. Un objet HTTPStatusEvent n'indique pas nécessairement une erreur. Il reflète simplement le code d'état HTTP (s'il existe) fourni par la pile réseau. Certains environnements Flash Player ne peuvent pas détecter les codes d'état HTTP. Dans ce cas, le code d'état 0 est systématiquement renvoyé.

Dans Flash Player, il n'existe qu'un type d'événement HTTPStatus : httpStatus. Dans le moteur d'exécution AIR, un FileReference, URLLoader, ou URLStream peut enregistrer pour écouter un httpResponseStatus, qui inclut des propriétés responseURL et responseHeaders. Ces propriétés ne sont pas définies dans un événement httpStatus.

Consulter les exemples



Propriétés publiques
 PropriétéDéfini par
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l'événement peut être annulé.
Event
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d'événements.
Event
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
  AIR-only responseHeaders : Array
Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader.
HTTPStatusEvent
  AIR-only responseURL : String
L'URL à partir de laquelle la réponse à été renvoyée.
HTTPStatusEvent
  status : int
[lecture seule] Le code d'état HTTP renvoyé par le serveur.
HTTPStatusEvent
 Inheritedtarget : Object
[lecture seule] Cible de l'événement.
Event
 Inheritedtype : String
[lecture seule] Type d'événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)
Crée un objet Event contenant des informations sur les événements HTTPStatus.
HTTPStatusEvent
  
Crée une copie de l'objet HTTPStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.
HTTPStatusEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l'événement.
Event
 Inherited
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre.
Object
 Inherited
Annule le comportement par défaut d'un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
Bloque le traitement des écouteurs d'événement dans les nœuds qui suivent le nœud actuel dans le flux d'événements.
Event
  
Renvoie une chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent.
HTTPStatusEvent
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change.
Event
 InheritedCLEAR : String = "clear"
[statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear.
Event
 InheritedCLOSE : String = "close"
[statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing.
Event
 InheritedCOMPLETE : String = "complete"
[statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedCOPY : String = "copy"
[statique] Définit la valeur de la propriété type d'un objet d'événement copy.
Event
 InheritedCUT : String = "cut"
[statique] Définit la valeur de la propriété type d'un objet d'événement cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender.
Event
  AIR-only HTTP_RESPONSE_STATUS : String = "httpResponseStatus"
[statique] Contrairement à l'événement httpStatus, l'événement httpResponseStatus est renvoyé avant toute donnée de réponse.
HTTPStatusEvent
  HTTP_STATUS : String = "httpStatus"
[statique] La constante HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d'un objet événement httpStatus.
HTTPStatusEvent
 InheritedID3 : String = "id3"
[statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange.
Event
 InheritedOPEN : String = "open"
[statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedPASTE : String = "paste"
[statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste.
Event
 InheritedREMOVED : String = "removed"
[statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent.
Event
Détails de la propriété
AIR-only responseHeaderspropriété
responseHeaders:Array  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader.



Implémentation
    public function get responseHeaders():Array
    public function set responseHeaders(value:Array):void

Voir aussi

AIR-only responseURLpropriété 
responseURL:String  [lecture-écriture]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

L'URL à partir de laquelle la réponse à été renvoyée. En cas de redirections, ceci sera différent de l'URL de requête.



Implémentation
    public function get responseURL():String
    public function set responseURL(value:String):void
statuspropriété 
status:int  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Le code d'état HTTP renvoyé par le serveur. Par exemple, une valeur 404 indique que le serveur n'a pas détecté de correspondance pour l'URL requise. Les valeurs de code HTTP sont répertoriées dans les sections 10.4 et 10.5 de la spécification HTTP à l'adresse ftp://ftp.isi.edu/in-notes/rfc2616.txt.

Si Flash Player ouAIR ne peut pas obtenir un code d'état auprès du serveur, ou s'il ne peut pas communiquer avec le serveur, la valeur 0 est transmise par défaut à votre code. Une valeur 0 peut être générée dans un lecteur quelconque (par exemple, si une URL mal formée est demandée), et une valeur 0 est toujours générée par le module Flash Player lorsqu'il est exécuté dans les navigateurs suivants, qui ne transmettent pas de codes d'état HTTP au lecteur : Netscape, Mozilla, Safari, Opera et Internet Explorer pour Macintosh.



Implémentation
    public function get status():int
Détails du constructeur
HTTPStatusEvent()Constructeur
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0)

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée un objet Event contenant des informations sur les événements HTTPStatus. Les objets Event sont transmis en tant que paramètres aux écouteurs d'événements.

Paramètres
type:String — Type de l'événement. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n'existe qu'un seul type d'événement HTTPStatus : HTTPStatusEvent.HTTP_STATUS.
 
bubbles:Boolean (default = false) — Détermine si l'objet Event prend part à la phase de propagation vers le haut (bubbling) du flux d'événements. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
 
cancelable:Boolean (default = false) — Détermine si l'objet Event peut être annulé. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
 
status:int (default = 0) — Etat numérique. Les écouteurs d'événement peuvent accéder à cette information par le biais de la propriété status.

Voir aussi

Détails de la méthode
clone()méthode
override public function clone():Event

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Crée une copie de l'objet HTTPStatusEvent et définit la valeur de chaque propriété de sorte qu'elle corresponde à la valeur d'origine.

Valeur renvoyée
Event — Nouvel objet HTTPStatusEvent dont les propriétés ont la même valeur que celles de l'objet d'origine.
toString()méthode 
override public function toString():String

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

Renvoie une chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent. La chaîne est écrite au format suivant :

[HTTPStatusEvent type=valeur bubbles=valeur cancelable=valeur status=valeur ]

Valeur renvoyée
String — Chaîne répertoriant toutes les propriétés de l'objet HTTPStatusEvent.
Détails de la constante
AIR-only HTTP_RESPONSE_STATUSConstante
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Contrairement à l'événement httpStatus, l'événement httpResponseStatus est renvoyé avant toute donnée de réponse. De plus, l'événement httpResponseStatus inclut des valeurs pour les propriétés responseHeaders et responseURL (qui ne sont pas définies pour un événement httpStatus. Notez que httpResponseStatus (le cas échéant) est envoyé avant (et en complément de) tout événement complete ou error.

La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS définit la valeur de la propriété type d'un objet événement httpResponseStatus.

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

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet qui traite activement l'objet Event avec un écouteur d'événements.
responseURL L'URL de laquelle la réponse a été renvoyée.
responseHeaders Les en-têtes de réponse que la réponse a renvoyés, sous la forme d'un tableau d'objets URLRequestHeader.
status Le code d'état HTTP renvoyé par le serveur.
target L'objet réseau recevant un code d'état HTTP.

Voir aussi

HTTP_STATUSConstante 
public static const HTTP_STATUS:String = "httpStatus"

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0 Flash Player 9

La constante HTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d'un objet événement httpStatus.

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

PropriétéValeur
bubbles false
cancelable false ; il n'existe aucun comportement par défaut à annuler.
currentTarget L'objet qui traite activement l'objet Event avec un écouteur d'événements.
status Le code d'état HTTP renvoyé par le serveur.
target L'objet réseau recevant un code d'état HTTP.

Voir aussi

Exemples Utilisation des exemples
HTTPStatusEventExample.as

L'exemple suivant tente de charger un fichier non existant depuis le répertoire Web racine http://www.[yourDomain].com, qui doit distribuer un événement httpStatusHandler avec l'état 404, indiquant que le fichier est introuvable. L'événement httpStatusHandler est traité par httpStatusHandler(), qui imprime simplement deux lignes d'informations sur l'événement.

Remarques :

  1. Pour générer un événement securityError dans cet exemple, vous devez compiler le fichier SWF en définissant « Sécurité de lecture locale » sur « Accès au réseau uniquement ».
  2. Vous devez disposer d'un serveur s'exécutant sur http://www.[yourDomain].com et qui écoute le port 80 ou vous recevrez un événement httpStatusHandler avec le code d'état 0 au lieu de 404.
  3. Il ne doit pas y avoir de fichier nommé MissingFile.html dans le répertoire Web racine http://www.[yourDomain].com car vous ne recevriez pas dans ce cas l'événement httpStatusHandler approprié.

package {
    import flash.display.Sprite;
    import flash.net.URLLoader;
    import flash.net.URLRequest;
    import flash.events.HTTPStatusEvent;

    public class HTTPStatusEventExample extends Sprite {

        public function HTTPStatusEventExample() {
            var loader:URLLoader = new URLLoader();
            loader.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);

            var request:URLRequest = new URLRequest("http://www.[yourDomain].com/MissingFile.html");
            loader.load(request);
        }

        private function httpStatusHandler(event:HTTPStatusEvent):void {
            trace("httpStatusHandler: " + event);
            trace("status: " + event.status);
        }
    }
}