URLStream  - AS3

Hiermee wordt het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer geretourneerd. Uw code moet de eigenschap bytesAvailable aanroepen om er zeker van te zijn dat voldoende gegevens beschikbaar zijn voordat u deze probeert te lezen met een van de methoden read.

Hiermee wordt aangegeven of dit object URLStream momenteel is verbonden. Het aanroepen van deze eigenschap retourneert de waarde true wanneer het object URLStream is verbonden, anders false.

Geeft de bytevolgorde voor de gegevens aan. Mogelijke waarden zijn Endian.BIG_ENDIAN of Endian.LITTLE_ENDIAN.

De standaardwaarde is Endian.BIG_ENDIAN.

Verwante API-elementen

Hiermee wordt de AMF-versie (Action Message Format) beheerd die wordt gebruikt bij het schrijven of lezen van een object.

Verwante API-elementen

Sluit de stream onmiddellijk en annuleert het downloaden. Er kunnen geen gegevens in de stream worden gelezen nadat de methode close() is aangeroepen.

Begint met het downloaden van de URL die in de parameter request is opgegeven.

Opmerking: wanneer een bestand dat wordt geladen niet-ASCII-tekens bevat (zoals in vele niet-Engelse talen), wordt geadviseerd het bestand met UTF-8- of UTF-16-codering op te slaan in plaats van een niet-Unicode-indeling zoals ASCII.

Wanneer het laden onmiddellijk mislukt, wordt een IOError- of SecurityError-fout (inclusief de fout met betrekking tot lokale bestandsbeveiliging) gegenereerd met een beschrijving van de fout. Anders wordt een gebeurtenis open verzonden bij het starten van de URL-download of wordt een gebeurtenis error verzonden wanneer alsnog een fout optreedt.

Standaard moeten het aanroepende SWF-bestand en de URL die u laadt zich in exact hetzelfde domein bevinden. Een SWF-bestand op www.adobe.com kan bijvoorbeeld alleen gegevens laden van bronnen die zelf ook aanwezig zijn op www.adobe.com. Wanneer u gegevens van een ander domein wilt laden, plaatst u een bestand met URL-beleid op de server die als host fungeert voor de gegevens.

In Flash Player kunt u geen verbinding maken met poorten die meestal zijn gereserveerd. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.

In Flash Player kunt u voorkomen dat een SWF-bestand deze methode gebruikt door de parameter allowNetworking van de tags object en embed in te stellen op de HTML-pagina die de SWF-inhoud bevat.

Als u in Flash Player 10 en hoger en in AIR 1.5 en hoger een multipart-inhoudstype gebruikt (bijvoorbeeld 'multipart/form-data') dat een upload bevat (aangegeven met de parameter 'bestandsnaam' in een header 'content-disposition' binnen de POST-body), gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads:

• De POST-bewerking moet worden uitgevoerd in reactie op een door de gebruiker geïnitieerde actie, zoals het klikken met de muis of het indrukken van een toets.
• Als bij de POST-bewerking verschillende domeinen betrokken zijn (het doel van de POST-bewerking bevindt zich niet op dezelfde server als het SWF-bestand dat de POST-aanvraag verstuurt), moet de doelserver een URL-beleidsbestand leveren dat interdomeintoegang toestaat.

In het geval van een multipart-inhoudstype is het ook essentieel dat de syntaxis juist is (in overeenstemming met de norm RFC2046). Als de syntaxis ongeldig lijkt te zijn, gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads.

Deze regels gelden ook voor AIR-inhoud in niet-toepassingssandboxen. In Adobe AIR is de inhoud in de toepassingssandbox (inhoud die met de AIR-toepassing is geïnstalleerd) echter niet beperkt tot deze beveiligingsbeperkingen.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

In AIR kan een object URLRequest worden geregistreerd voor de statusgebeurtenis httpResponse. In tegenstelling tot de gebeurtenis httpStatus, wordt de gebeurtenis httpResponseStatusvóór eventuele responsgegevens bezorgd. Bovendien bevat de gebeurtenis httpResponseStatus waarden voor de eigenschappen responseHeaders en responseURL (die ongedefinieerd zijn voor een httpStatus-gebeurtenis). De gebeurtenis httpResponseStatus (indien aanwezig) wordt verzonden vóór (en als aanvulling op) een gebeurtenis complete of error.

Als er een httpResponseStatus gebeurtenislistener is, wordt de hoofdtekst van het antwoordbericht altijd verzonden en leidt de statuscode van HTTP-antwoorden altijd tot een gebeurteniscomplete. Dit is altijd waar, of de statuscode van het HTTP-antwoord nu een geslaagde of een mislukte bewerking aangeeft.

Als er in AIR geen httpResponseStatus-gebeurtenislistener is, is het gedrag afhankelijk van de SWF-versie:

• Bij SWF 9-inhoud wordt de hoofdtekst van het HTTP-antwoordbericht alleen verzonden als de statuscode van het HTTP-antwoord aangeeft dat de bewerking is geslaagd. Als de bewerking niet is geslaagd (er is een fout opgetreden), wordt de hoofdtekst niet verzonden en verzendt het object URLRequest de gebeurtenis IOError.
• Bij SWF 10-inhoud wordt de hoofdtekst van het HTTP-antwoordbericht altijd verzonden. Als er een fout is opgetreden, verzendt het object URLRequest een gebeurtenis IOError.

Parameters

Leest een Booleaanse waarde uit de stream. Er wordt één byte gelezen en true wordt geretourneerd wanneer de byte niet gelijk is aan 0. Anders wordt false geretourneerd.

Leest een byte met teken uit de stream.

De geretourneerde waarde ligt in het bereik -128...127.

Leest length bytes gegevens uit de stream. De bytes worden ingelezen in het object ByteArray dat door bytes wordt opgegeven, beginnend bij offset bytes in het object ByteArray.

Parameters

Leest een IEEE 754 drijvende-kommagetal met dubbele precisie uit de stream.

Leest een IEEE 754 drijvende-kommagetal met enkele precisie uit de stream.

Leest een 32-bits geheel getal met teken uit de stream.

De geretourneerde waarde ligt in het bereik -2147483648...2147483647.

Leest een multibyte-tekenreeks van de opgegeven lengte met de opgegeven tekenset uit de bytestream.

Parameters

Hiermee wordt een object dat in AMF-indeling (Action Message Format) is gecodeerd, uit de socket gelezen.

Verwante API-elementen

Leest een 16-bits geheel getal met teken uit de stream.

De geretourneerde waarde ligt in het bereik -32768...32767.

Leest een byte zonder teken uit de stream.

De geretourneerde waarde ligt in het bereik 0...255.

Leest een 32-bits geheel getal zonder teken uit de stream.

De geretourneerde waarde ligt in het bereik 0...4294967295.

Leest een 16-bits geheel getal zonder teken uit de stream.

De geretourneerde waarde ligt in het bereik 0...65535.

Leest een UTF-8-tekenreeks uit de stream. Er wordt aangenomen dat de tekenreeks begint met een kort geheel getal zonder teken dat de lengte in bytes aangeeft.

Leest een reeks UTF-8-lengtebytes uit de stream, waarna een tekenreeks wordt geretourneerd.

Parameters

Wordt verzonden nadat gegevens zijn geladen.

Deze gebeurtenis heeft de volgende eigenschappen:

Wordt verzonden als een aanroep naar de methode URLStream.load() via HTTP toegang tot gegevens probeert te krijgen, en Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren.

Als een URLStream-object zich registreert voor een httpStatusEvent-gebeurtenis, worden foutreacties als inhoud afgeleverd. In plaats van een ioError-gebeurtenis te verzenden, verzendt URLStream progress- en complete-gebeurtenissen wanneer de foutgegevens in de URLStream worden geladen.

De constante HTTPStatusEvent.HTTP_RESPONSE_STATUS definieert de waarde van de eigenschap type van een httpResponseStatus-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een aanroep naar URLStream.load() toegang probeert te krijgen tot gegevens via HTTP en Flash Player of Adobe AIR de statuscode voor de aanvraag kan detecteren en retourneren. (Sommige browseromgevingen kunnen deze informatie mogelijk niet bieden.) De gebeurtenis httpStatus (indien aanwezig) wordt verzonden vóór (en als aanvulling op) een gebeurtenis complete of error.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een invoer-/uitvoerfout optreedt die ertoe leidt dat een laadbewerking mislukt.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een laadbewerking begint.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer gegevens tijdens de downloadbewerking worden ontvangen. Ontvangen gegevens kunnen onmiddellijk worden gelezen met de methoden van de klasse URLStream.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Wordt verzonden wanneer een aanroep van URLStream.load() probeert gegevens te laden van een server buiten de beveiligingssandbox.

Deze gebeurtenis heeft de volgende eigenschappen:

Verwante API-elementen

Bij het uitvoeren van dit voorbeeld plaatst u een bestand genaamd URLStreamExample.swf in dezelfde map als het SWF-bestand.

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);
        }
    }
}