URLStream  - AS3

Gibt für die zum Lesen verfügbaren Daten im Eingabepuffer die Anzahl der Byte an. Ihr Code muss die Eigenschaft bytesAvailable aufrufen, um sicherzustellen, dass genügend Daten verfügbar sind, bevor Sie diese mit einer der read-Methoden lesen.

Gibt an, ob dieses URLStream-Objekt zurzeit verbunden ist. Beim Aufruf dieser Eigenschaft wird der Wert true zurückgegeben, wenn das URLStream-Objekt verbunden ist, oder andernfalls false.

Gibt die Byte-Reihenfolge der Daten an. Mögliche Werte sind Endian.BIG_ENDIAN oder Endian.LITTLE_ENDIAN.

Der Standardwert ist Endian.BIG_ENDIAN.

Verwandte API-Elemente

Steuert die beim Schreiben oder Lesen eines Objekts verwendete Version von Action Message Format (AMF).

Verwandte API-Elemente

Schließt den Stream unmittelbar und bricht den Download-Vorgang ab. Nach dem Aufrufen der close()-Methode können aus dem Stream keine Daten gelesen werden.

Startet den Download der im Parameter request angegebenen URL.

Hinweis: Enthält eine geladene Datei Nicht-ASCII-Zeichen (wie sie z. B. in vielen Sprachen außerhalb des englischen Sprachraums vorkommen), wird empfohlen, dass Sie die Datei im Format UTF-8 oder UTF-16 und nicht in einem Unicode-fremden Format (z. B. ASCII) speichern.

Wenn der Ladevorgang unmittelbar fehlschlägt, wird eine IOError- oder eine SecurityError-Ausnahme (mit dem lokalen Dateisicherheitsfehler) mit der Beschreibung des Fehlers ausgegeben. Andernfalls wird ein open-Ereignis ausgelöst, wenn der URL-Download erfolgreich gestartet wird, bzw. ein Fehlerereignis, wenn ein Fehler auftritt.

Standardmäßig müssen die aufrufende SWF-Datei und die von Ihnen geladene URL in genau der gleichen Domäne sein. Eine SWF-Datei unter www.adobe.com kann beispielsweise nur Daten laden, die sich ebenfalls unter www.adobe.com befinden. Legen Sie eine URL-Richtliniendatei auf dem Server ab, der die Daten hostet, um Daten aus einer anderen Domäne zu laden.

In Flash Player können Sie keine Verbindung mit normalerweisen reservierten Ports herstellen. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.

In Flash Player können Sie eine SWF-Datei daran hindern, diese Methode zu verwenden, indem Sie den allowNetworking-Parameter des object- und embed-Tags auf der HTML-Seite setzen, die den SWF-Inhalt enthält.

Wenn Sie in Flash Player 10 und höher und in AIR 1.5 und höher einen Multipart-Content-Type (z. B. „multipart/form-data“) verwenden, der ein Upload enthält (angegeben durch einen „filename“-Parameter in einem „content-disposition“-Header innerhalb des POST-Body), unterliegt die POST-Methode den auf Uploads angewendeten Sicherheitsregeln:

• Der POST-Vorgang muss als Reaktion auf eine durch den Benutzer initiierte Aktion, z. B. Mausklick oder Tastendruck, erfolgen.
• Ist die POST-Methode domänenübergreifend (das POST-Ziel befindet sich auf einem anderen Server als die SWF-Datei, die die POST-Anforderung sendet), so muss der Zielserver eine URL-Richtliniendatei bereitstellen, die den domänenübergreifenden Zugriff erlaubt.

Für alle mehrteiligen Content-Typen muss ebenfalls die Syntax nach Standard RFC2046 gültig sein. Scheint die Syntax ungültig zu sein, so unterliegt die POST-Methode den Sicherheitsregeln für Uploads.

Diese Regeln gelten auch für AIR-Inhalt in anwendungsfremden Sandboxen. In Adobe AIR dagegen ist Inhalt in der Anwendungssandbox (mit der AIR-Anwendung installierter Inhalt) nicht durch diese Sicherheitseinschränkungen beschränkt.

Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.

In AIR kann sich ein URLRequest-Objekt für das httpResponse-Statusereignis registrieren. Anders als das httpStatus-Ereignis wird das httpResponseStatus-Ereignis ausgelöst, bevor Antwortdaten vorliegen. Außerdem enthält das httpResponseStatus-Ereignis Werte für die Eigenschaften responseHeaders und responseURL (die für ein httpStatus-Ereignis nicht definiert sind). Beachten Sie, dass das Ereignis httpResponseStatus (falls vorhanden) vor (und zusätzlich zu) jedem complete- oder error-Ereignis gesendet wird.

Wenn es einen httpResponseStatus Ereignis-Listener gibt, wird der Rumpf der Antwortmeldung immer gesendet, und HTTP-Statuscodeantworten resultierten immer in einem complete-Ereignis. Dies ist unabhängig davon wahr, ob der HTTP-Antwortstatuscode einen Erfolg oder einen Fehler anzeigt.

Wenn es in AIR keine httpResponseStatus-Ereignis-Listener gibt, ist das Verhalten basierend auf der SWFAIR-Version unterschiedlich:

• Bei SWF 9-Inhalten wird der Hauptteil der HTTP-Antwortnachricht nur dann gesendet, wenn der HTTP-Antwortstatuscode Erfolg anzeigt. Andernfalls (wenn ein Fehler vorliegt) wird kein Rumpf gesendet und das URLRequest-Objekt löst ein IOError-Ereignis aus.
• Bei SWF 10-Inhalten wird der Hauptteil der HTTP-Antwortnachricht immer gesendet. Wenn ein Fehler vorliegt, löst das URLRequest-Objekt ein IOError-Ereignis aus.

Parameter

Liest einen booleschen Wert aus dem Stream. Es wird ein einzelnes Byte gelesen und true zurückgegeben, wenn das Byte ungleich 0 ist, oder andernfalls false.

Liest ein Byte mit Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von -128 bis 127.

Liest length Byte Daten aus dem Stream. Die Bytedaten werden ab der im Parameter offset festgelegten Position in das im Parameter bytes angegebene ByteArray-Objekt gelesen.

Parameter

Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Stream.

Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Stream.

Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von -2147483648 bis 2147483647.

Liest einen Multibyte-String der angegebenen Länge unter Verwendung des angegebenen Zeichensatzes vom Bytedatenstream.

Parameter

Liest ein im Action Message Format (AMF) kodiertes Objekt vom Socketserver.

Verwandte API-Elemente

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von -32768 bis 32767.

Liest ein Byte ohne Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von 0 bis 255.

Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von 0 bis 4294967295.

Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Stream.

Der Rückgabewert liegt im Bereich von 0 bis 65535.

Liest einen UTF-8-String aus dem Bytestream. Es wird davon ausgegangen, dass dem String eine short-Ganzzahl ohne Vorzeichen mit der Länge in Byte vorangestellt ist.

Liest eine Folge von length-UTF-8-Byte aus dem Bytestream und gibt einen String zurück.

Parameter

Wird nach dem erfolgreichen Laden von Daten ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Wird ausgelöst, wenn ein Aufruf der URLStream.load()-Methode versucht, über HTTP auf Daten zuzugreifen und Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann.

Wenn ein URLStream-Objekt für ein httpStatusEvent-Eigenschaft registriert wird, werden Fehlerantworten zugestellt, als ob es sich um Inhalt handelt. Anstatt ein ioError-Ereignis auszulösen, löst der URLStream progress- und complete-Ereignisse aus, während die Fehlerdaten in den URLStream geladen werden.

Die HTTPStatusEvent.HTTP_RESPONSE_STATUS-Konstante definiert den Wert der type-Eigenschaft eines httpResponseStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn ein URLStream.load() versucht, auf Daten über HTTP zuzugreifen, und Flash Player oder Adobe AIR den Statuscode für die Anforderung erkennen und zurückgeben kann. (Diese Informationen können in einigen Browser-Umgebungen möglicherweise nicht bereitgestellt werden.) Beachten Sie, dass das Ereignis httpStatus (falls vorhanden) vor (und zusätzlich zu) jedem complete- oder error-Ereignis gesendet wird.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Auftreten eines I/O-Fehlers ausgelöst, durch den der Ladevorgang fehlschlägt.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird beim Start eines Ladevorgangs ausgelöst.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden. Empfangene Daten können mit den Methoden der URLStream-Klasse sofort gelesen werden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Wird ausgelöst, wenn ein URLStream.load()-Aufruf versucht, Daten von einem Server außerhalb der Sicherheitssandbox zu laden.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

Verwandte API-Elemente

Legen Sie zur Ausführung des Beispiels eine Datei mit dem Namen „URLStreamExample.swf“ in dem Verzeichnis ab, in dem sich die SWF-Datei befindet.

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