XMLSocket  - AS3

Indica se este objeto XMLSocket está conectado no momento. Você também pode verificar se a conexão foi bem-sucedida, registrando o evento connect e ioError.

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 XMLSocket. 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.

Elementos da API relacionados

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

Elementos da API relacionados

Estabelece uma conexão com o host da Internet especificado usando a porta TCP especificada.

Se você especificar null para o parâmetro host, o host contatado será aquele no qual reside o arquivo que chama XMLSocket.connect(). Por exemplo, se o arquivo de chamada foi baixado de www.adobe.com, a especificação de null para o parâmetro host significa que você está estabelecendo conexão com www.adobe.com.

Você pode impedir o arquivo de usar esse método configurando o parâmetro allowNetworking das marcas object e embed na página HTML com o conteúdo SWF.

Para obter mais informações, consulte o tópico do Centro de desenvolvedores do Flash Player: Security.

Parâmetros

Elementos da API relacionados

Converte os dados ou objetos XML especificados no parâmetro objeto em uma string e a transmite ao servidor, seguida de um byte zero (0). Se objeto for um objeto XML, a string será a representação textual XML desse objeto XML. A operação de envio é assíncrona; ela é retornada imediatamente, mas os dados podem ser transmitidos mais tarde. O método XMLSocket.send() não retorna um valor indicando se os dados foram transmitidos com êxito.

Se você não conectar o objeto XMLSocket ao servidor usando XMLSocket.connect()), a operação XMLSocket.send() falhará.

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 XMLSocket.close().

Esse evento tem as seguintes propriedades:

Despachado após uma chamada bem-sucedida para o método XMLSocket.connect().

Esse evento tem as seguintes propriedades:

Despachado após o envio ou o recebimento de dados brutos.

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 recebimento.

Esse evento tem as seguintes propriedades:

Despachado se uma chamada para o método XMLSocket.connect() tentar se conectar a um servidor fora da área de segurança do chamador ou a uma porta menor do que 1024.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

1. O construtor XMLSocketExample cria uma ocorrência de XMLSocket denominada socket e transmite socket para ConfigureListeners() (descrito a seguir) e então chama o método connect() de XMLSocket usando o nome de host "localhost" e o número de porta 8080.
2. O método configureListeners() é então chamado, adicionando ouvintes para cada um dos eventos XMLSocket suportados:
   • closeHandler(): monitora o evento close, que é despachado após o encerramento da conexão com a rede.
   • connectHandler(): monitora o evento connect, despachado quando a conexão com a rede é estabelecida.
   • dataHandler(): monitora os eventos data, despachados sempre que XMLSocket recebe novos dados.
   • progressHandler(): monitora os eventos progress, despachados quando uma chamada a send() foi feita e enquanto o envio está em andamento.
   • securityErrorHandler(): monitora eventos securityError, que poderiam ser despachados se fosse feita uma tentativa de acessar XMLSocket com a configuração incorreta de segurança de reprodução local ou usando uma porta menor do que 1024.
   • ioErrorHandler(): monitora eventos ioError, que ocorreriam somente se uma operação de envio ou recebimento de dados falhasse.

Observações:

• É necessário compilar o arquivo SWF com a "Segurança de reprodução local" definida como "Acessar somente a rede".
• Para esse exemplo funcionar, você precisará de um servidor em execução no domínio usando a porta 8080.
• Se você estiver executando o Flash Player 9.0.124.0 ou posterior, será necessário colocar um arquivo de diretivas de soquete no servidor que permita conexões de soquete do domínio com a porta 8080. Para obter informações sobre como fornecer arquivos de diretivas de soquete, consulte o Tópico do Centro de desenvolvedores do Adobe Flash Player: Setting up a socket policy file server (Configuração do servidor de arquivos de diretivas de soquete).

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.XMLSocket;

    public class XMLSocketExample extends Sprite {
        private var hostName:String = "localhost";
        private var port:uint = 8080;
        private var socket:XMLSocket;

        public function XMLSocketExample() {
            socket = new XMLSocket();
            configureListeners(socket);
            if (hostName && port) {
                socket.connect(hostName, port);
            }
        }

        public function send(data:Object):void {
            socket.send(data);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CLOSE, closeHandler);
            dispatcher.addEventListener(Event.CONNECT, connectHandler);
            dispatcher.addEventListener(DataEvent.DATA, dataHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
        }

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

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

        private function dataHandler(event:DataEvent):void {
            trace("dataHandler: " + event);
        }

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

        private function progressHandler(event:ProgressEvent):void {
            trace("progressHandler loaded:" + event.bytesLoaded + " total: " + event.bytesTotal);
        }

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