URLStream  - AS3

Devuelve el número de bytes de datos disponibles para su lectura en el búfer de entrada. El código debe llamar a la propiedad bytesAvailable para garantizar que hay datos suficientes disponibles antes de intentar leerlos con uno de los métodos read.

Indica si este objeto URLStream está conectado actualmente. Una llamada a esta propiedad devuelve true si el objeto URLStream está conectado; en caso contrario, devuelve false.

Indica el orden de bytes de los datos. Los valores posibles son Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.

El valor predeterminado es Endian.BIG_ENDIAN.

Elementos de API relacionados

Controla la versión del formato de mensaje de acción (AMF) utilizado al escribir o leer un objeto.

Elementos de API relacionados

Cierra la transmisión inmediatamente y cancela la operación de descarga. No se pueden leer datos de la transmisión después de llamar al método close().

Comienza a descargar la URL especificada en el parámetro request.

Nota: si un archivo que se está cargando contiene caracteres no ASCII (como ocurre en muchos idiomas, no así en inglés), se recomienda que guarde el archivo con codificación UTF-8 o UTF-16, en lugar de utilizar un formato no Unicode, como ASCII.

Si la operación de carga falla inmediatamente, se emite una excepción IOError o SecurityError (incluido el error de seguridad del archivo local) en la que se describe el error. En caso contrario, se distribuye un evento open si la descarga de la URL comienza correctamente, o se distribuye un evento de error si se produce un error.

De forma predeterminada, el archivo SWF que realiza la llamada y la URL que se carga deben estar exactamente en el mismo dominio. Por ejemplo, un archivo SWF de www.adobe.com puede cargar datos únicamente de orígenes que también estén en www.adobe.com. Para cargar datos desde un dominio distinto, coloque un archivo de política URL en el servidor que aloja los datos.

En Flash Player no es posible conectarse a puertos comunes reservados. Para obtener una lista completa de los puertos bloqueados, consulte la sección “Restricción de API de red” en el Guía del desarrollador de ActionScript 3.0.

En Flash Player, se puede impedir que un archivo SWF utilice este método si define el parámetro allowNetworking de las etiquetas object y embed de la página HTML que aloja el contenido SWF.

En Flash Player 10 y versiones posteriores, y en AIR 1.5 y versiones posteriores, si utiliza una estructura Content-Type de varias partes (por ejemplo, "multipart/form-data") con una acción de carga (indicada por un parámetro "filename" en un encabezado "content-disposition" dentro del cuerpo POST), la operación POST está sujeta a las reglas de seguridad aplicadas a las cargas:

• Es preciso realizar una operación POST como respuesta a una acción iniciada por el usuario, por ejemplo, un clic de ratón o la pulsación de una tecla.
• Si la operación POST afecta a varios dominios (el destino POST no se encuentra en el mismo servidor que el archivo SWF que envía la petición POST), el servidor de destino debe proporcionar un archivo de política URL que permita el acceso a varios dominios.

Asimismo, en cualquier estructura Content-Type de varias partes, la sintaxis debe ser válida (de acuerdo con la norma RFC2046). Si la sintaxis no es válida, la operación POST está sujeta a las reglas de seguridad que se aplican a las cargas.

Estas reglas también se aplican al contenido de AIR ajeno a los entornos limitados de la aplicación. Sin embargo, en Adobe AIR, el contenido del entorno limitado de la aplicación (contenido instalado con la aplicación de AIR) no está limitado por estas restricciones de seguridad.

Para obtener más información sobre la seguridad, consulte el tema del Centro de desarrollo de Flash Player Seguridad.

En AIR, un objeto URLRequest puede registrar el evento de estado httpResponse. Al contrario que httpStatus, el evento httpResponseStatus se envía antes de cualquier dato de respuesta. Asimismo, el evento httpResponseStatus incluye valores para las propiedades responseHeaders y responseURL (que son undefined en un evento httpStatus). Tenga en cuenta que se enviará el evento httpResponseStatus (si existe) antes que (y además de) cualquier evento complete o error.

Si existe un detector de eventos httpResponseStatus, el cuerpo del mensaje de respuesta se envía siempre; las respuestas de código de estado HTTP siempre producen un evento complete. Esto se cumple a pesar de que el código de estado de la respuesta HTTP indique una finalización correcta o un error.

En AIR, si no hay detector de eventos httpResponseStatus, el comportamiento no es el mismo que el de la versión SWF:

• En contenido SWF 9, el cuerpo del mensaje de respuesta HTTP se envía sólo si el código de estado de la respuesta HTTP indica que se ha realizado correctamente. En caso contrario (si se produce un error), no se envía nada y el objeto URLRequest distribuye un evento IOError.
• En contenido SWF 10, el cuerpo del mensaje de respuesta HTTP se envía siempre. Si se produce un error, el objeto URLRequest distribuye un evento IOError.

Parámetros

Lee un valor booleano del flujo. Se lee un solo byte y devuelve true si el byte es distinto de cero; en caso contrario, devuelve false.

Lee un byte con signo del flujo.

El valor devuelto se encuentra entre -128 y 127.

Lee bytes length de datos de la transmisión. Los bytes se leen en el objeto ByteArray especificado por bytes, iniciando bytes offset en el objeto ByteArray.

Parámetros

Lee un número de coma flotante con precisión doble IEEE 754 de la transmisión.

Lee un número de coma flotante con precisión simple IEEE 754 de la transmisión.

Lee un entero de 32 bits con signo del flujo.

El valor devuelto se encuentra entre -2147483648...2147483647.

Lee una cadena multibyte de longitud especificada desde la transmisión de bytes mediante el juego de caracteres especificado.

Parámetros

Lee un objeto del socket, codificado en formato de mensaje de acción (AMF).

Elementos de API relacionados

Lee un entero de 16 bits con signo de la transmisión.

El valor devuelto se encuentra entre -32768 y 32767.

Lee un byte sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 255.

Lee un entero de 32 bits sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 4294967295.

Lee un entero de 16 bits sin signo de la transmisión.

El valor devuelto se encuentra entre 0 y 65535.

Lee una cadena UTF-8 del flujo. Se da por hecho que la cadena tiene un prefijo de declaración unsigned short que indica la longitud en bytes.

Lee una secuencia de bytes length UTF-8 desde la transmisión y devuelve una cadena.

Parámetros

Se distribuye cuando los datos se han cargado correctamente.

Este evento tiene las propiedades siguientes:

Se distribuye si una llamada al método URLStream.load() intenta acceder a los datos mediante HTTP y Adobe AIR puede detectar y devolver el código de estado de la petición.

Si un objeto URLStream se registra en un evento httpStatusEvent, las respuestas de error se envían como si fuera contenido. Por tanto, en vez de distribuir un evento ioError, el objeto URLStream distribuye eventos progress y complete cuando los datos de error se cargan en URLStream.

La constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define el valor de la propiedad type de un objeto de evento httpResponseStatus.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye si una llamada a URLStream.load() intenta acceder a los datos mediante HTTP y si Flash Player o Adobe AIR pueden detectar y devolver el código de estado de la petición. (Es posible que algunos entornos de navegador no proporcionen esta información.) Tenga en cuenta que se enviará httpStatus (si existe) antes que (y además de) cualquier evento complete o error.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga se realice incorrectamente.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye cuando se inicia la operación de carga.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye al recibirse datos mientras progresa una operación de descarga. Los datos recibidos se pueden leer inmediatamente con los métodos de la clase URLStream.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Se distribuye si se intenta llamar a URLStream.load() para cargar datos de un servidor situado fuera del entorno limitado de seguridad.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

Para ejecutar el ejemplo, coloque un archivo llamado URLStreamExample.swf en el mismo directorio que el archivo 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);
        }
    }
}