AVURLStream - Guide de référence de l’API Adobe ActionScript® 3 (AS3 )

Package	flash.media
Classe	public class AVURLStream
Héritage	AVURLStream URLStream EventDispatcher Object

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

La classe URLStream offre un accès de bas niveau pour le téléchargement des URL. Les données sont mises à la disposition du code dès le début de leur téléchargement. Il n’est donc pas nécessaire d’attendre la fin du téléchargement du fichier comme avec URLLoader. La classe URLStream vous permet également de fermer un flux continu avant la fin du téléchargement. Le contenu du fichier téléchargé est disponible sous forme de données binaires brutes.

Les opérations de lecture dans URLStream ne sont pas bloquantes. Cela signifie que vous devez utiliser la propriété bytesAvailable pour déterminer si suffisamment de données sont disponibles avant de tenter de les lire. Si les données disponibles sont insuffisantes, une exception EOFError est renvoyée.

Toutes les données binaires sont codées par défaut au format BE (gros-boutiste), l’octet le plus significatif étant en première position.

Les règles de sécurité qui s’appliquent au téléchargement d’URL avec la classe URLStream sont identiques à celles appliquées aux objets URLLoader. Il est possible de télécharger les fichiers de régulation, si nécessaire. Les règles de sécurité des fichiers locaux sont appliquées et des avertissements de sécurité sont générés, si besoin est.

Eléments de l’API associés

URLLoader
URLRequest

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		bytesAvailable : uint [lecture seule] Renvoie le nombre d’octets de données disponibles pour la lecture dans le tampon de saisie.	URLStream
		connected : Boolean [lecture seule] Indique si l’objet URLStream est actuellement connecté.	URLStream
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		cookieHeader : String [écriture seule]	AVURLStream
		endian : String Indique l’ordre d’octet des données.	URLStream
		objectEncoding : uint Contrôle la version du format AMF (Action Message Format) utilisé lors de l’écriture ou de la lecture d’un objet.	URLStream

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		close():void Ferme immédiatement le flux continu et annule le téléchargement.	URLStream
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		isPrototypeOf(theClass:Object):Boolean 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
		load(request:URLRequest):void [override] Amorce le téléchargement de l’URL spécifiée dans le paramètre request.	AVURLStream
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		readBoolean():Boolean Lit une valeur booléenne dans le flux continu.	URLStream
		readByte():int Lit un octet signé dans le flux continu.	URLStream
		readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void Lit les octets length des données dans le flux.	URLStream
		readDouble():Number Lit un nombre à virgule flottante avec deux décimales, conforme à IEEE 754, dans le flux continu.	URLStream
		readFloat():Number Lit un nombre à virgule flottante et à une décimale, conforme à IEEE 754, dans le flux continu.	URLStream
		readInt():int Lit un entier signé de 32 bits dans le flux continu.	URLStream
		readMultiByte(length:uint, charSet:String):String Lit une chaîne à plusieurs octets de longueur spécifiée à partir du flux d’octets et à l’aide du jeu de caractères désigné.	URLStream
		readObject():* Lit dans le socket un objet codé au format AMF (Action Message Format).	URLStream
		readShort():int Lit un entier signé de 16 bits dans le flux continu.	URLStream
		readUnsignedByte():uint Lit un octet non signé dans le flux continu.	URLStream
		readUnsignedInt():uint Lit un entier de 32 bits non signé dans le flux continu.	URLStream
		readUnsignedShort():uint Lit un entier de 16 bits non signé dans le flux continu.	URLStream
		readUTF():String Lit une chaîne UTF-8 dans le flux continu.	URLStream
		readUTFBytes(length:uint):String Lit une séquence d’octets UTF-8 length dans le flux et renvoie une chaîne.	URLStream
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
complete	Distribué lorsque le chargement de données a abouti.	URLStream
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
httpResponseStatus	Distribué si un appel de la méthode URLStream.load() tente d’accéder aux données via HTTP, et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.	URLStream
httpStatus	Distribué si un appel de la méthode URLStream.load() tente d’accéder aux données via HTTP, et si Flash Player ou Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.	URLStream
ioError	Distribué lorsqu’il se produit une erreur d’entrée/sortie entraînant l’échec d’un chargement.	URLStream
open	Distribué lors du démarrage d’une opération de chargement.	URLStream
progress	Distribué à la réception des données au fur et à mesure du téléchargement.	URLStream
securityError	Distribué si un appel de la méthode URLStream.load() tente de charger des données d’un serveur en dehors d’un sandbox de sécurité.	URLStream

Détails de la propriété

cookieHeader

propriété

cookieHeader:String [écriture seule]

Implémentation
public function set cookieHeader(value:String):void

Détails de la méthode

load

()

méthode

override public function load(request:URLRequest):void

Version du langage:

ActionScript 3.0

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9, Flash Lite 4

Commence le téléchargement de l’URL spécifiée dans le paramètre request.

Remarque : si un fichier en cours de chargement contient des caractères non-ASCII (comme s’en trouvent dans de nombreuses langues autres que l’anglais), nous vous recommandons d’enregistrer le fichier en utilisant le codage UTF-8 ou UTF-16, plutôt que sous un format non-Unicode, ASCII par exemple.

Si le chargement échoue immédiatement, une exception IOError ou SecurityError (erreur de sécurité de fichier local comprise) décrivant l’échec est renvoyée. Dans le cas contraire, un événement open est distribué si le téléchargement de l’URL démarre correctement ou un événement d’erreur est distribué en cas d’erreur.

Par défaut, le fichier SWF appelant et l’URL chargée doivent se trouver dans le même domaine. Par exemple, un fichier SWF à l’adresse www.adobe.com peut charger uniquement des données provenant de sources situées aussi à l’adresse www.adobe.com. Pour charger des données à partir d’un autre domaine, placez un fichier de régulation d’URL sur le serveur hébergeant les données.

Dans Flash Player, vous ne pouvez pas vous connecter à des ports normalement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

Dans Flash Player, vous pouvez éviter qu’un fichier SWF n’utilise cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui héberge le contenu SWF.

Dans Flash Player 10 et versions ultérieures, et dans AIR 1.5 et versions ultérieures, si vous utilisez un Content-Type en plusieurs parties (par exemple « multipart/form-data ») qui contient un chargement (indiqué par un paramètre « filename » dans un en-tête «content-disposition » au sein du corps POST), l’opération POST est soumise aux règles de sécurité appliquées aux chargements :

L’opération POST doit être effectuée en réponse à l’action d’un utilisateur, comme un clic de souris ou la pression d’une touche.
Si l’opération POST se fait entre plusieurs domaines (la cible POST ne se trouve pas sur le même serveur que le fichier SWF qui envoie la demande POST), le serveur cible doit fournir un fichier de régulation d’URL qui permette l’accès interdomaines.

Par ailleurs, la syntaxe de tous les Content-Type en plusieurs parties doit être correcte (selon la norme RFC2046). Si la syntaxe s’avère incorrecte, l’opération POST est soumise aux règles de sécurité appliquées aux chargements.

Le contenu AIR dans des sandbox non-applicatifs est également soumis à ces règles. Cependant, dans Adobe AIR, le contenu du sandbox de l’application (contenu installé avec l’application AIR) n’est pas soumis à ces limites de sécurité.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Dans AIR, un objet URLRequest peut enregistrer l’événement d’état httpResponse. 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.

S’il existe un écouteur d’événement httpResponseStatus, le corps du message de réponse est toujours envoyé. En outre, le code d’état de la réponse HTTP distribue toujours un événement complete, qu’il indique un message de réussite ou un message d’erreur.

Dans AIR, s’il n’existe aucun écouteur d’événement httpResponseStatus, le comportement varie selon la version du fichier SWF d’AIR :

Pour le contenu SWF 9, le corps du message de la réponse HTTP est envoyé uniquement si le code d’état de la réponse HTTP indique que l’opération a réussi. Dans le cas contraire (si le code indique une erreur), le corps du message n’est pas envoyé et l’objet URLRequest distribue un événement IOError.
Pour le contenu SWF 10, le corps du message de la réponse HTTP est toujours envoyé. En cas d’erreur, l’objet URLRequest distribue un événement IOError.

Paramètres

request:URLRequest — Objet URLRequest indiquant l’URL à télécharger. Si la valeur de ce paramètre ou la propriété URLRequest.url de l’objet URLRequest transmis correspondent à null, l’application renvoie une erreur de pointeur Null.

Evénements

	`complete:Event` — Distribué après le chargement effectif de données. S’il existe un écouteur d’événement `httpResponseStatus`, l’objet URLRequest distribue également un événement `complete`, que le code d’état de la réponse HTTP indique une réussite ou une erreur.

	`httpStatus:HTTPStatusEvent` — Si l’accès s’effectue par HTTP et que l’environnement actuel permet l’obtention des codes d’état, il se peut que vous receviez ces événements en plus des événements `complete` ou `error`.

	`httpResponseStatus:HTTPStatusEvent` — Distribué si un appel de la méthode `load()` tente d’accéder aux données via HTTP et si Adobe AIR est capable de détecter et de renvoyer le code d’état de la requête.

	`ioError:IOErrorEvent` — L’opération de chargement n’a pu se terminer.

	`open:Event` — Distribué lors du démarrage d’une opération de chargement.

	`securityError:SecurityErrorEvent` — Une opération de chargement a tenté d’extraire des données à partir d’un serveur situé en dehors du sandbox de sécurité de l’appelant. Vous pouvez contourner le problème en utilisant un fichier de régulation au niveau du serveur.

Valeur émise

	`ArgumentError` — Les objets `URLRequest.requestHeader` ne devraient pas contenir certains en-têtes de requête HTTP interdits. Pour plus d’informations, voir la description de la classe URLRequestHeader.

	`MemoryError` — Cette erreur peut se produire pour les raisons suivantes : Flash Player ou Adobe AIR ne peut pas convertir le paramètre `URLRequest.data` du format UTF8 au format MBCS. Cette erreur est concernée si l’objet URLRequest transmis à la méthode `load()` est configuré pour exécuter une opération `GET` et si `System.useCodePage` est réglé sur `true`. Flash Player ou Adobe AIR ne peut pas allouer de mémoire aux données `POST`. Cette erreur est applicable si l’objet URLRequest transmis à load est configuré pour exécuter une opération `POST`.

	`SecurityError` — Les fichiers SWF non approuvés au niveau local ne peuvent pas communiquer avec Internet. Pour contourner ce problème, reclassifiez le fichier SWF en tant que fichier local avec accès au réseau ou en tant que fichier approuvé.

	`SecurityError` — Si vous tentez de vous connecter à un port généralement réservé. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

Informations juridiques | Politique de confidentialité en ligne

AVURLStream - AS3

Packagesx

Eléments du langage

Annexes

Package flash.media

cookieHeader

load