Socket  - AS3

O número de bytes de dados disponíveis para leitura no buffer de entrada.

O seu código deve acessar bytesAvailable para garantir que dados suficientes estejam disponíveis antes de você tentar fazer a leitura com um dos métodos de leitura.

Indica o número de bytes restantes no buffer de gravação.

Use essa propriedade combinada ao OutputProgressEvent. Um OutputProgressEvent é lançado cada vez que os dados são gravados do buffer de gravação para a rede. No manipulador de eventos, você pode verificar bytesPending para saber quantos dados restam no buffer aguardando para ser gravado. Quando bytesPending retorna 0, isso significa que todos os dados foram transferidos do buffer de gravação para a rede, e é seguro realizar ações como remover manipuladores de evento, anular referências de soquete, iniciar o próximo carregamento na fila, etc.

Elementos da API relacionados

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

Indica a ordem de byte para os dados. Os valores possíveis são constantes da classe flash.utils.Endian, Endian.BIG_ENDIAN ou Endian.LITTLE_ENDIAN.

O valor padrão é Endian.BIG_ENDIAN.

Elementos da API relacionados

O endereço IP deste soquete está vinculado à máquina local.

Elementos da API relacionados

A porta deste soquete está vinculada à máquina local.

Elementos da API relacionados

Controla a versão do AMF usada ao gravar ou ler um objeto.

Elementos da API relacionados

O endereço IP da máquina remota à qual este soquete está conectado.

Você pode usar esta propriedade para determinar o endereço IP de um soquete de cliente despachado em um ServerSocketConnectEvent por um objeto de ServerSocket. Use a classe DNSResolver para converter um endereço IP em um nome do domínio, se desejar.

Elementos da API relacionados

A porta na máquina remota à qual este soquete está conectado.

Você pode usar esta propriedade para determinar o número de porta de um soquete de cliente despachado em um ServerSocketConnectEvent por um objeto de ServerSocket.

Elementos da API relacionados

Indica o número de milissegundos de espera por uma conexão.

Se a conexão não for estabelecida dentro do tempo especificado, ela falhará. O valor padrão é 20.000 (20 segundos).

Cria um novo objeto Socket. Se nenhum parâmetro for especificado, um soquete inicialmente desconectado será criado. Se parâmetros forem especificados, uma conexão será tentada com o host e a porta especificados.

Observação: É altamente recomendável usar a forma do construtor sem parâmetros, adicionar os ouvintes de evento e chamar o método connect com parâmetros host e port. Essa sequência garante que todos os ouvintes de evento funcionem corretamente.

Fecha o soquete. Não será possível ler ou gravar dados após a chamada do método close().

O evento close somente é despachado quando o servidor encerra a conexão; ele não é despachado quando você chama o método close().

Você pode reutilizar o objeto Socket chamando o método connect() nesse objeto novamente.

Conecta o soquete ao host e porta especificados.

Se a conexão falhar imediatamente, um evento será despachado ou uma exceção será lançada: um evento de erro será despachado se um host tiver sido especificado, e uma exceção será lançada se nenhum host tiver sido especificado. Caso contrário, o status da conexão será reportado por um evento. Se o soquete já estiver conectado, a conexão existente será encerrada primeiro.

Parâmetros

Descarrega todos os dados acumulados no buffer de saída do soquete.

Em alguns sistemas operacionais, flush() é chamado automaticamente entre os quadros de execução, mas em outros sistemas operacionais, tais como o Windows, os dados nunca são despachados, a menos que você chame flush() explicitamente. Pa assegurar que o aplicatio se comporte de maneira confiável em todos sistemas operacionais, é uma boa prática chamar o método flush() depois de escrever cada mensagem (ou grupo de dados relacionado) para o soquete.

Lê um valor booliano do soquete. Após a leitura de um único byte, o método retornará true será o byte for diferente de zero; caso contrário, false será retornado.

Lê um byte com sinal do soquete.

Lê o número de bytes de dados especificados pelo parâmetro de comprimento a partir do soquete. Os bytes são lidos na matriz de bytes especificada, começando na posição indicada por deslocamento.

Parâmetros

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

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

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

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

Parâmetros

Lê um objeto a partir do soquete, codificado no formato serializado AMF.

Elementos da API relacionados

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

Lê um byte sem sinal do soquete.

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

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

Lê uma string UTF-8 do soquete. Supõe-se que a string seja prefixada com um inteiro curto sem sinal que indique o comprimento em bytes.

Lê o número de bytes de dados UTF-8 especificados pelo parâmetro length a partir do soquete e retorna uma string.

Parâmetros

Grava um valor booliano no soquete. Esse método grava um único byte, com um valor de 1 (true) ou 0 (false).

Parâmetros

Elementos da API relacionados

Grava um byte no soquete.

Parâmetros

Elementos da API relacionados

Grava uma sequência de bytes a partir da matriz de bytes especificada. A operação de gravação começa na posição especificada por deslocamento.

Se você omitir o parâmetro comprimento, o comprimento padrão de 0 fará com que o método grave o buffer inteiro, começando em deslocamento.

Se você também omitir o parâmetro deslocamento, o buffer inteiro será gravado.

Parâmetros

Elementos da API relacionados

Grava no soquete um número de ponto flutuante de precisão dupla IEEE 754.

Parâmetros

Elementos da API relacionados

Grava no soquete um número de ponto flutuante de precisão única IEEE 754.

Parâmetros

Elementos da API relacionados

Grava um inteiro de 32 bits com sinal no soquete.

Parâmetros

Elementos da API relacionados

Grava uma string de vários bytes a partir do fluxo de bytes, usando o conjunto de caracteres especificado.

Parâmetros

Elementos da API relacionados

Grava um objeto no soquete no formato serializado AMF.

Parâmetros

Elementos da API relacionados

Grava um inteiro de 16 bits no soquete. Os bytes gravados são os seguintes:

(v >> 8) & 0xff v & 0xff

Os 16 bits inferiores do parâmetro são usados e os 16 bits superiores são ignorados.

Parâmetros

Elementos da API relacionados

Grava um inteiro de 32 bits sem sinal no soquete.

Parâmetros

Elementos da API relacionados

Grava os seguintes dados no soquete: um inteiro de 16 bits sem sinal, que indica o comprimento da string UTF-8 especificada em bytes, seguido da string propriamente dita.

Antes de gravar a string, o método calcula o número de bytes necessários para representar todos os caracteres da string.

Parâmetros

Elementos da API relacionados

Grava uma string UTF-8 no soquete.

Parâmetros

Elementos da API relacionados

Despachado quando o servidor fecha a conexão de soquete.

O evento close somente é despachado quando o servidor encerra a conexão; ele não é despachado quando você chama o método Socket.close().

Esse evento tem as seguintes propriedades:

Despachado quando uma conexão de rede foi estabelecida.

Esse evento tem as seguintes propriedades:

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

Esse evento tem as seguintes propriedades:

Despachado quando um soquete move dados do buffer de gravação para a camada de transporte de rede

Despachado se uma chamada de Socket.connect() tentar se conectar a um servidor proibido pela caixa de proteção do autor da chamada ou a uma porta inferior a 1024 e não houver nenhum arquivo de política de soquete para permitir esta conexão.

Nota: em um aplicativo AIR, o conteúdo executado dentro da área de segurança do aplicativo pode se conectar a qualquer servidor e número de porta sem um arquivo de diretiva de soquete.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

Despachado quando um soquete recebeu dados.

Os dados recebidos pelo soquete permanecem no soquete até serem lidos. Não é preciso ler todos os dados disponíveis durante o manipulador deste evento.

Eventos do tipo socketData não usam a propriedade ProgressEvent.bytesTotal.

Esse evento tem as seguintes propriedades:

1. O construtor cria uma ocorrência de CustomSocket denominada socket e transmite o nome do host localhost e a porta 80 como argumentos. Como o CustomSocket estende Socket, uma chamada do super() chama o construtor de Socket.
2. O exemplo chama o método configureListeners(), que adiciona ouvintes para eventos Socket.
3. Por fim, o método connect() de soquete é chamado com hostlocal como o nome do host e 80 como o número da porta.

Observação: Para executar o exemplo, você precisa de um servidor em execução no mesmo domínio em que reside o SWF (no exemplo, localhost) e monitorando na porta 80.

package {
    import flash.display.Sprite;

    public class SocketExample extends Sprite {
        private var socket:CustomSocket;
        
        public function SocketExample() {
            socket = new CustomSocket("localhost", 80);
        }
    }
}

import flash.errors.*;
import flash.events.*;
import flash.net.Socket;

class CustomSocket extends Socket {
    private var response:String;

    public function CustomSocket(host:String = null, port:uint = 0) {
        super();
        configureListeners();
        if (host && port)  {
            super.connect(host, port);
        }
    }

    private function configureListeners():void {
        addEventListener(Event.CLOSE, closeHandler);
        addEventListener(Event.CONNECT, connectHandler);
        addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
        addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        addEventListener(ProgressEvent.SOCKET_DATA, socketDataHandler);
    }

    private function writeln(str:String):void {
        str += "\n";
        try {
            writeUTFBytes(str);
        }
        catch(e:IOError) {
            trace(e);
        }
    }

    private function sendRequest():void {
        trace("sendRequest");
        response = "";
        writeln("GET /");
        flush();
    }

    private function readResponse():void {
        var str:String = readUTFBytes(bytesAvailable);
        response += str;
    }

    private function closeHandler(event:Event):void {
        trace("closeHandler: " + event);
        trace(response.toString());
    }

    private function connectHandler(event:Event):void {
        trace("connectHandler: " + event);
        sendRequest();
    }

    private function ioErrorHandler(event:IOErrorEvent):void {
        trace("ioErrorHandler: " + event);
    }

    private function securityErrorHandler(event:SecurityErrorEvent):void {
        trace("securityErrorHandler: " + event);
    }

    private function socketDataHandler(event:ProgressEvent):void {
        trace("socketDataHandler: " + event);
        readResponse();
    }
}