URLStream  - AS3

Retorna o número de bytes de dados disponíveis para leitura no buffer de entrada. O seu código deve chamar a propriedade bytesAvailable para garantir que dados suficientes estejam disponíveis antes de você tentar fazer a leitura com um dos métodos de leitura.

Indica se este objeto URLStream está conectado no momento. Uma chamada para essa propriedade retornará um valor true se o objeto URLStream estiver conectado; caso contrário, retornará false.

Indica a ordem de byte para os dados. Os valores possíveis são Endian.BIG_ENDIAN ou Endian.LITTLE_ENDIAN.

O valor padrão é Endian.BIG_ENDIAN.

Elementos da API relacionados

Controla a versão do AMF (Action Message Format) usada ao gravar ou ler um objeto.

Elementos da API relacionados

Encerra o fluxo imediatamente e cancela a operação de download. Nenhum dado poderá ser lido a partir do fluxo depois que o método close() for chamado.

Inicia o download da URL especificada no parâmetro solicitação.

Observação: se um arquivo que está sendo carregado contiver caracteres não ASCII (como é o caso de muitos idiomas que não são o inglês), convém salvar o arquivo com codificação UTF-8 ou UTF-16, em contraste com um formato não Unicode, como ASCII.

Se a operação de carregamento falhar imediatamente, uma exceção IOError ou SecurityError (incluindo o erro de segurança de arquivo local) será lançada com uma descrição da falha. Caso contrário, um evento open será despachado se o download da URL for iniciado com êxito. ou um evento "erro" será despachado se um erro ocorrer.

Por padrão, a URL e o arquivo SWF da chamada que você carrega precisam estar exatamente no mesmo domínio. Por exemplo, um arquivo SWF em www.adobe.com pode carregar dados apenas de fontes que também estejam em www.adobe.com. Para carregar dados de outro domínio, coloque um arquivo de diretivas de URL no servidor que está hospedando os dados.

No Flash Player, você não pode conectar-se às portas normalmente reservadas. Para ver uma lista completa de portas bloqueadas, consulte "Restrição de APIs de rede" no Guia do Desenvolvedor do ActionScript 3.0.

No Flash Player, é possível impedir que um arquivo SWF use esse método, definindo o parâmetro allowNetworking das marcas object e embed na página HTML que tem o conteúdo SWF.

No Flash Player 10 e posterior, além do AIR 1.5 e posterior, caso você use um multipart Content-Type (por exemplo, "multipart/form-data") que contenha um carregamento (indicado por um parâmetro "filename" em um cabeçalho "content-disposition" dentro do corpo POST), a operação POST está sujeita a regras de segurança aplicadas a carregamentos:

• A operação POST deverá ser executada em resposta a uma ação iniciada pelo usuário, por exemplo, clique de mouse ou pressionamento de tecla.
• Se a operação POST for entre domínios (se o destino de POST não estiver no mesmo servidor do arquivo SWF que está enviando a solicitação POST), o servidor de destino deverá fornecer um arquivo de diretivas de URL que permita o acesso entre domínios.

Além disso, a sintaxe deverá ser válida (de acordo com os padrões RFC2046) para qualquer Content-Type de partes múltiplas. Se a sintaxe for inválida, a operação POST ficará sujeita às regras de segurança aplicadas a uploads.

Essas regras também se aplicam ao conteúdo do AIR nas caixas de proteção de segurança do aplicativo. Contudo, no Adobe AIR, o conteúdo na área de segurança application (conteúdo instalado com o Adobe AIR) não é restringido por essas limitações de segurança.

Para obter mais informações relacionadas à segurança, consulte o tópico do Centro do desenvolvedores do Flash Player Security.

No AIR, um objeto URLRequest pode se registrar no evento de status httpResponse. Ao contrário do evento httpStatus, o evento httpResponseStatus é entregue antes de qualquer dado de resposta. O evento httpResponseStatus inclui valores para as propriedades responseHeaders e responseURL (que estão indefinidas para um evento httpStatus. Observe que o evento httpResponseStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.

Caso haja um ouvinte de evento httpResponseStatus, o corpo da mensagem de resposta é sempre despachado; e as respostas do código de status HTTP sempre resultam em um evento complete. Isso é verdadeiro, independentemente do código de status da resposta HTTP indicar um êxito ou um erro.

No AIR, caso não haja nenhumouvinte de evento httpResponseStatus, o comportamento será diferente, com base na versão do SWF:

• Para o conteúdo do SWF 9, o corpo da mensagem de resposta HTTP é despachado somente se o código de status de resposta HTTP indica êxito. Do contrário (caso haja um erro), nenhum corpo é despachado e o objeto URLRequest despacha um evento IOE.
• Para o conteúdo do SWF 10, o corpo da mensagem de resposta HTTP é sempre despachado. Caso haja um erro, o objeto URLRequest despacha um evento IOError.

Parâmetros

Lê um valor booliano do fluxo. O único byte é lido e é retornado true se o byte for diferente de zero, false em caso contrário.

Lê um byte com sinal do fluxo.

O valor retornado está na faixa -128...127.

Lê bytes de comprimento de dados do fluxo. Os bytes são lidos no objeto ByteArray especificado por bytes, começando a offset bytes no objeto ByteArray.

Parâmetros

Lê do fluxo um número de ponto flutuante de precisão dupla IEEE 754.

Lê do fluxo um número de ponto flutuante de precisão única IEEE 754.

Lê um inteiro de 32 bits com sinal do fluxo.

O valor retornado está na faixa -2147483648...2147483647.

Lê uma string de vários bytes de comprimento especificado, do fluxo de bytes, usando o conjunto de caracteres especificado.

Parâmetros

Lê um objeto a partir do soquete, codificado em AMF (Action Message Format).

Elementos da API relacionados

Lê um inteiro de 16 bits com sinal do fluxo.

O valor retornado está na faixa -32768...32767.

Lê um byte sem sinal do fluxo.

O valor retornado está na faixa 0...255.

Lê um inteiro de 32 bits sem sinal do fluxo.

O valor retornado está na faixa 0...4294967295.

Lê um inteiro de 16 bits sem sinal do fluxo.

O valor retornado está na faixa 0...65535.

Lê uma string UTF-8 do fluxo. A string é assumida como prefixada com uma curta não assinada, indicativa do comprimento em bytes.

Lê uma sequência de bytes UTF-8 de length a partir do fluxo e retorna uma string.

Parâmetros

Despachado quando os dados foram carregados com êxito.

Esse evento tem as seguintes propriedades:

Despachado se uma chamada para o método URLStream.load() tentar acessar dados via HTTP e o Adobe AIR atual for capaz de detectar e retornar o código de status da solicitação.

Se um objeto URLStream se registra para um evento httpStatusEvent, as respostas de erro são entregues conforme estão no conteúdo. Em vez de despachar um evento ioError, o URLStream despacha os eventos progress e complete conforme os dados de erro são carregados no URLStream.

A constante HTTPStatusEvent.HTTP_RESPONSE_STATUS define o valor da propriedade type de um objeto de evento httpResponseStatus.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado se uma chamada para URLStream.load() tentar acessar dados via HTTP e o Flash Player ou o Adobe AIR for capaz de detectar e retornar o código de status da solicitação. (Alguns ambientes de navegador podem não ser capazes de fornecer essas informações.) Observe que httpStatus (se houver) será despachado antes (e além de) qualquer evento complete ou error.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado quando ocorre um erro de entrada/saída que resulta na falha de uma operação de carregamento.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado quando uma operação de carregamento é iniciada.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado quando os dados são recebidos ao longo do progresso da operação de download. Os dados que foram recebidos podem ser lidos imediatamente usando os métodos da classe URLStream.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado se uma chamada para URLStream.load() tentar carregar dados de um servidor fora da área de segurança.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Para executar o exemplo, insira um arquivo denominado URLStreamExample.swf no mesmo diretório que o seu arquivo 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);
        }
    }
}