Package | flash.events |
Classe | public class HTTPStatusEvent |
Héritage | HTTPStatusEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
Propriété | Défini par | ||
---|---|---|---|
bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | ||
cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | ||
eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | ||
redirected : Boolean
Indique si la requête a été redirigée. | HTTPStatusEvent | ||
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 | ||
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 | ||
target : Object [lecture seule]
Cible de l’événement. | Event | ||
type : String [lecture seule]
Type d’événement. | Event |
Méthode | Défini par | ||
---|---|---|---|
HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Crée un objet Event contenant des informations sur les événements HTTPStatus. | HTTPStatusEvent | ||
[override]
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 | ||
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | ||
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 | ||
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | ||
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 la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne répertoriant toutes les propriétés de l’objet HTTPStatusEvent. | HTTPStatusEvent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
Constante | Défini par | ||
---|---|---|---|
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 |
redirected | propriété |
responseHeaders | propriété |
responseHeaders:Array
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
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
Eléments de l’API associés
responseURL | propriété |
responseURL:String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
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
status | propriété |
status:int
[lecture seule] Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 codes d’état HTTP sont répertoriés dans les sections 10.4 et 10.5 de la spécification HTTP à l’adresse suivante : http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html.
Si Flash Player ou AIR 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
HTTPStatusEvent | () | Constructeur |
public function HTTPStatusEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, status:int = 0, redirected:Boolean = false)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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ètrestype: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 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 .
| |
redirected:Boolean (default = false ) — Indique si la demande a été redirigée. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété redirected .
|
Eléments de l’API associés
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, Flash Lite 4 |
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éeEvent — 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, Flash Lite 4 |
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]
String — Chaîne répertoriant toutes les propriétés de l’objet HTTPStatusEvent.
|
HTTP_RESPONSE_STATUS | Constante |
public static const HTTP_RESPONSE_STATUS:String = "httpResponseStatus"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Lite 4 |
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. |
redirected | Indique si la réponse est le résultat d’une redirection. |
target | L’objet réseau recevant un code d’état HTTP. |
Eléments de l’API associés
HTTP_STATUS | Constante |
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, Flash Lite 4 |
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. |
Eléments de l’API associés
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 :
- 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 ». - 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. - 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); } } }
Tue Jun 12 2018, 09:30 AM Z