URLStream  - AS3

Renvoie le nombre d’octets de données disponibles pour la lecture dans le tampon de saisie. Votre code doit appeler la propriété bytesAvailable pour garantir que les données disponibles sont suffisantes, avant leur lecture à l’aide d’une des méthodes read.

Indique si l’objet URLStream est actuellement connecté. Un appel de cette propriété renvoie la valeur true si l’objet URLStream est connecté, false dans le cas contraire.

Indique l’ordre d’octet des données. Les valeurs possibles sont Endian.BIG_ENDIAN ou Endian.LITTLE_ENDIAN.

La valeur par défaut est Endian.BIG_ENDIAN.

Eléments de l’API associés

Contrôle la version du format AMF (Action Message Format) utilisé lors de l’écriture ou de la lecture d’un objet.

Eléments de l’API associés

Ferme immédiatement le flux continu et annule le téléchargement. Après l’appel de la méthode close(), aucune donnée ne peut être lue dans le flux continu.

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

Lit une valeur booléenne dans le flux continu. Un seul octet est lu, et la valeur true est renvoyée s’il n’est pas nul, false dans le cas contraire.

Lit un octet signé dans le flux continu.

La valeur renvoyée est comprise entre -128 et 127.

Lit le nombre d’octets de données spécifié par le paramètre length dans le flux. Les octets sont lus dans l’objet ByteArray spécifié par le paramètre bytes, à partir des octets offset dans l’objet ByteArray.

Paramètres

Lit un nombre à virgule flottante avec deux décimales, conforme à IEEE 754, dans le flux continu.

Lit un nombre à virgule flottante et à une décimale, conforme à IEEE 754, dans le flux continu.

Lit un entier signé de 32 bits dans le flux continu.

La valeur renvoyée est comprise entre -2147483648 et 2147483647.

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é.

Paramètres

Lit dans le socket un objet codé au format AMF (Action Message Format).

Eléments de l’API associés

Lit un entier signé de 16 bits dans le flux continu.

La valeur renvoyée est comprise entre -32768 et 32767.

Lit un octet non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 255.

Lit un entier de 32 bits non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 4294967295.

Lit un entier de 16 bits non signé dans le flux continu.

La valeur renvoyée est comprise entre 0 et 65535.

Lit une chaîne UTF-8 dans le flux continu. La chaîne doit être précédée d’un caractère non signé indiquant la longueur en octets.

Lit une séquence d’octets UTF-8 length dans le flux et renvoie une chaîne.

Paramètres

Distribué lorsque le chargement de données a abouti.

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

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.

Si un objet URLStream s’inscrit à un événement httpStatusEvent, les réponses aux erreurs sont livrées, même s’il s’agit de contenu. Par conséquent, au lieu de distribuer un événement ioError, l’objet URLStream distribue des événements progress et complete lorsque les données d’erreur sont chargées dans l’objet URLStream.

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 :

Eléments de l’API associés

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 (certains environnements de navigateur ne sont pas capables de fournir cette information). Vous remarquerez que httpStatus (le cas échéant) sera envoyé avant (et en complément de) tout événement complete ou error.

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

Eléments de l’API associés

Distribué lorsqu’il se produit une erreur d’entrée/sortie entraînant l’échec d’un chargement.

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

Eléments de l’API associés

Distribué lors du démarrage d’une opération de chargement.

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

Eléments de l’API associés

Distribué à la réception des données au fur et à mesure du téléchargement. Les données reçues peuvent être lues immédiatement à l’aide des méthodes de la classe URLStream.

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

Eléments de l’API associés

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é.

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

Eléments de l’API associés

Pour exécuter l’exemple, placez un fichier intitulé URLStreamExample.swf dans le même répertoire que vos fichiers SWF.

package {
    import flash.display.Sprite;
    import flash.errors.*;
    import flash.events.*;
    import flash.net.URLRequest;
    import flash.net.URLStream;

    public class URLStreamExample extends Sprite {
        private static const ZLIB_CODE:String = "CWS";
        private var stream:URLStream;

        public function URLStreamExample() {
            stream = new URLStream();
            var request:URLRequest = new URLRequest("URLStreamExample.swf");
            configureListeners(stream);
            try {
                stream.load(request);
            } catch (error:Error) {
                trace("Unable to load requested URL.");
            }
        }

        private function configureListeners(dispatcher:EventDispatcher):void {
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(HTTPStatusEvent.HTTP_STATUS, httpStatusHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

        private function parseHeader():void {
            trace("parseHeader");
            trace("isCompressed: " + isCompressed());
            trace("version: " + stream.readByte());
        }

        private function isCompressed():Boolean {
            return (stream.readUTFBytes(3) == ZLIB_CODE);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
            parseHeader();
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:Event):void {
            trace("progressHandler: " + event);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

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

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}