XMLSocket  - AS3

Indica si este objeto XMLSocket está conectado actualmente. Para comprobar si la conexión es correcta, también se puede registrar para los eventos connect y ioError.

Elementos de API relacionados

Indica el número de milisegundos para esperar una conexión.

Si la conexión no se realiza en el tiempo especificado, se produce un error de conexión. El valor predeterminado es 20,000 (veinte segundos).

Crea un nuevo objeto XMLSocket. Si no se especifica ningún parámetro, se crea un socket desconectado inicialmente. Si se especifican parámetros, se intenta realizar la conexión con el host y el puerto especificados.

Nota: se recomienda encarecidamente el uso del formulario constructor sin parámetros, posteriormente la adición de todos los detectores de eventos y, a continuación, la llamada al método connect con los parámetros host y port. Esta secuencia garantiza que todos los detectores de eventos funcionen correctamente.

Elementos de API relacionados

Cierra la conexión especificada por el objeto XMLSocket. El evento close sólo se distribuye si el servidor cierra la conexión; no se distribuye al llamar al método close().

Elementos de API relacionados

Establece una conexión con el servidor de Internet especificado mediante el puerto TCP indicado.

Si especifica el valor null para el parámetro host, el servidor con el que se entra en contacto es en el que reside el archivo que llama a XMLSocket.connect(). Por ejemplo, si el archivo de llamada se descargara de www.adobe.com, especificando null para el parámetro de host, significa que se está conectando con www.adobe.com.

Asimismo, se puede impedir que un archivo 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.

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

Parámetros

Elementos de API relacionados

Convierte el objeto XML o los datos especificados en el parámetro object en una cadena y la transmite al servidor seguida de un byte cero (0). Si object es un objeto XML, la cadena es una representación textual XML del objeto XML. La operación de envío (send) es asíncrona; se devuelve inmediatamente, pero puede que los datos se transmitan posteriormente. El método XMLSocket.send() no devuelve ningún valor que indique si los datos se han transmitido correctamente.

Si no conecta el objeto XMLSocket al servidor mediante XMLSocket.connect()), la operación XMLSocket.send() generará un error.

Parámetros

Elementos de API relacionados

Se distribuye cuando el servidor cierra la conexión de socket. El evento close sólo se distribuye si el servidor cierra la conexión; no se distribuye al llamar al método XMLSocket.close().

Este evento tiene las propiedades siguientes:

Se distribuye tras realizar una llamada correcta al método XMLSocket.connect().

Este evento tiene las propiedades siguientes:

Se distribuye una vez enviados o recibidos datos sin formato.

Este evento tiene las propiedades siguientes:

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

Este evento tiene las propiedades siguientes:

Se distribuye si la llamada al método XMLSocket.connect() intenta conectar con un servidor fuera del entorno limitado de seguridad del elemento que realiza la llamada o con un puerto inferior al 1024.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

1. El constructor XMLSocketExample crea una instancia de XMLSocket denominada socket y transfiere socket a ConfigureListeners() (descrito a continuación). Posteriormente, llama al método connect() de XMLSocket utilizando el nombre de host "localhost" y el número de puerto 8080.
2. Se llama al método configureListeners(), que añade detectores para cada uno de los eventos XMLSocket admitidos:
   • closeHandler(): detecta el evento close, que se distribuye una vez cerrada la conexión de red.
   • connectHandler(): detecta el evento connect, que se distribuye al establecer la conexión de red.
   • dataHandler(): detecta eventos data, que se distribuyen cada vez que XMLSocket recibe nuevos datos.
   • progressHandler(): detecta eventos progress, que se distribuyen cuando se realiza una llamada a send() y durante el proceso de envío.
   • securityErrorHandler(): detecta eventos securityError, que se distribuirían si se intentase acceder al objeto XMLSocket con al configuración de seguridad de reproducción local errónea o si se utiliza un puerto inferior a 1024.
   • ioErrorHandler(): detecta eventos ioError, que se producirían sólo si hay algún error en el envío y la recepción de los datos.

Notas:

• Debe compilar el archivo SWF con la opción "Seguridad de reproducción local" definida como "Acceso sólo a la red".
• Necesita un servidor que se ejecute en su dominio utilizando el puerto 8080 para que este ejemplo funcione.
• Si está ejecutando Flash Player 9.0.124.0 o posterior, debe colocar un archivo de política de socket en el servidor que permite las conexiones de socket desde su dominio con el puerto 8080. Para obtener más información sobre los archivos de política de socket, consulte el tema del centro de desarrollo de Flash Player sobre la configuración de un servidor de archivos de política de socket.

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