URLStream  - AS3

Returnerar antalet databyte som kan läsas i indatabufferten. Koden måste anropa egenskapen bytesAvailable för att kontrollera att det finns tillräckligt med data innan läsningen med någon av read-metoderna.

Anger om det här URLStream-objektet är anslutet. Ett anrop till den här egenskapen returnerar värdet true om URLStream-objektet är anslutet, annars returneras false.

Anger byteordningen för data. Möjliga värden är Endian.BIG_ENDIAN eller Endian.LITTLE_ENDIAN.

Standardvärdet är Endian.BIG_ENDIAN.

Relaterade API-element

Styr vilken version av AMF (Action Message Format) som används när ett objekt skrivs eller läses.

Relaterade API-element

Stänger omedelbart dataflödet och avbryter nedladdningen. Inga data kan läsas från flödet när metoden close() har anropats.

Börjar ladda ned URL:en som anges i parametern request.

Obs: Om en fil som läses in innehåller andra tecken än ASCII-tecken (finns i många icke-engelska språk) rekommenderas du att spara filen med UTF-8 eller UTF-16-kodning i stället för ett icke-Unicode-format som ASCII.

Om inläsningen misslyckas på en gång genereras ett I/O-fel eller säkerhetsfel och ett felmeddelande visas. I annat fall skickas händelsen open om URL-nedladdningen påbörjas eller så skickas en felhändelse om ett fel uppstår.

Den anropade SWF-filen och URL:en som du läser in, måste som standard finnas i exakt samma domän. En SWF-fil på www.adobe.com kan till exempel bara läsa in data från källor som också finns på www.adobe.com. Om du vill läsa in data från en annan domän sparar du en URL-principfil på servern där data finns.

I Flash Player kan du inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.

I Flash Player kan du förhindra att en SWF-fil använder denna metod genom inställningen av parametern allowNetworking för taggarna object och embed på HTML-sidan med SWF-innehållet.

Om du i Flash Player 10 och senare, och i AIR 1.5 och senare, använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.

• POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
• Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.

För en multipart-innehållstyp måste också syntaxen vara giltig (enligt RFC2046-standarderna). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.

Dessa regler gäller också för AIR-innehåll i icke-programsandlådor. I Adobe AIR begränsas emellertid inte innehåll i programsandlådan (innehåll som installeras med AIR-programmet) av de här säkerhetsbegränsningarna.

Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.

I AIR kan ett URLRequest-objekt registrera sig för statushändelsen httpResponse. Till skillnad från httpStatus-händelsen levereras httpResponseStatus-händelsen innan eventuella svarsdata. Dessutom inkluderar httpResponseStatus-händelsen värdena för responseHeaders och responseURL-egenskaperna (som är odefinierade i en httpStatus-händelse). Observera att httpResponseStatus-händelsen (om sådan finns) skickas före (och utöver) händelserna complete eller error.

Om det finns en httpResponseStatus-händelseavlyssnare, är svarsmeddelandets brödtext alltid skickat, och HTTP-statuskodsvar leder alltid till en complete-händelse. Detta gäller även om HTTP-svarsstatuskoden anger om åtgärden har lyckats eller misslyckats.

I AIR, om det inte finns någon httpResponseStatus-händelseavlyssnare, kan det här beteendet fungera annorlunda, beroende på SWF-versionen:

• För SWF 9-innehåll skickas brödtexten i HTTP-svarsmeddelandet bara om HTTP-svarsstatuskoden anger att åtgärden har lyckats. Annars (om ett fel uppstår) skickas ingen brödtext och URLRequest-objektet skickar en IOError-händelse.
• För SWF 10-innehåll skickas alltid brödtexten i HTTP-svarsmeddelandet. Om ett fel uppstår skickar URLRequest-objektet en IOError-händelse.

Parametrar

Läser ett booleskt värde från flödet. En enkel byte läses och true returneras om bytevärdet inte är noll, i annat fall false.

Läser en byte med tecken från flödet.

Det returnerade värdet ligger inom intervallet -128 till 127.

Läser det antal databyte som anges av parametern length från flödet. Alla databyte läses in i ByteArray-objektet enligt parametern bytes, med början vid databyte offset i ByteArray-objektet.

Parametrar

Läser ett IEEE 754-flyttal med dubbel precision från flödet.

Läser ett IEEE 754-flyttal med enkel precision från flödet.

Läser ett 32-bitars heltal med tecken från flödet.

Det returnerade värdet ligger inom intervallet -2147483648 till 2147483647.

Läser en multibyte-sträng med den angivna längden från byteströmmen med den angivna teckenuppsättningen.

Parametrar

Läser ett objekt från socketen, kodat i serialiserat AMF-format (Action Message Format).

Relaterade API-element

Läser ett 16-bitars heltal med tecken från flödet.

Det returnerade värdet ligger inom intervallet -32768 till 32767.

Läser en byte utan tecken från flödet.

Det returnerade värdet ligger inom intervallet 0 till 255.

Läser ett 32-bitars heltal utan tecken från flödet.

Det returnerade värdet ligger inom intervallet 0 till 4294967295.

Läser ett 16-bitars heltal utan tecken från flödet.

Det returnerade värdet ligger inom intervallet 0 till 65535.

Läser en UTF-8-sträng från flödet. Strängen antas inledas av typen short utan tecken som visar längden i byte.

Läser en sekvens UTF-8-byte med den angivna längden length från flödet och returnerar en sträng.

Parametrar

Skickas när alla data är inlästa.

Den här händelsen har följande egenskaper:

Skickas om ett anrop till metoden URLStream.load() försöker få åtkomst till data via HTTP och Adobe AIR upptäcker och returnerar statuskoden för begäran.

Om ett URLStream-objekt registreras för en httpStatusEvent-händelse levereras felsvar som om de vore innehåll. I stället för att skicka en ioError-händelse skickar URLStream alltså progress- och complete-händelser i takt med att feldata läses in i URLStream.

HTTPStatusEvent.HTTP_RESPONSE_STATUS-konstanten definierar värdet på type-egenskapen i ett httpResponseStatus-händelseobjekt.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas om ett anrop till URLStream.load() försöker få tillgång till data via HTTP, och Flash Player eller Adobe AIR kan identifiera och returnera statuskoden för begäran. (I vissa webbläsarmiljöer kanske den här informationen inte kan returneras.) Observera att eventuell httpStatus-händelse skickas före (och utöver) händelserna complete och error.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas om ett in- eller utdatafel orsakar en misslyckad inläsningsåtgärd.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas när en inläsning initieras.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas när data tas emot under nedladdningsförloppet. Data som har tagits emot kan läsas omedelbart via metoderna i klassen URLStream.

Den här händelsen har följande egenskaper:

Relaterade API-element

Skickas när ett anrop till URLStream.load() försöker läsa in data från en server utanför säkerhetssandlådan.

Den här händelsen har följande egenskaper:

Relaterade API-element

För att köra exemplet placerar du en fil med namnet URLStreamExample.swf i samma katalog som SWF-filen.

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