| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
La clase Socket permite que el código ActionScript realice conexiones de socket y que lea y escriba datos binarios sin formato. Es similar a la clase XMLSocket, pero no dicta el formato de los datos recibidos o transmitidos.
La clase Socket resulta útil para trabajar con servidores que utilicen protocolos binarios.
Cuando utilice esta clase, tenga en cuenta el modelo de seguridad de Flash Player:
- No se permite la carga de datos si el archivo SWF que realiza la llamada se encuentra en el entorno limitado local con el sistema de archivos y el recurso se encuentra en un entorno limitado de red.
- Tampoco se permite la carga de datos si el archivo SWF que realiza la llamada se encuentra en un entorno limitado de red y el recurso de destino es local.
- El archivo SWF que realiza la llamada y el recurso de red al que se accede deben encontrarse exactamente en el mismo dominio. Por ejemplo, un archivo SWF en adobe.com sólo puede realizar la conexión con un servidor daemon en adobe.com.
- Los sitios Web pueden conceder acceso a varios dominios a un recurso mediante un archivo de política de varios dominios.
Para más información, consulte las siguientes secciones:
Ver los ejemplos
bytesAvailable:uint [read-only]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
El número de bytes de datos disponibles para su lectura en el búfer de entrada.
El código debe poder acceder a bytesAvailable para garantizar que hay datos suficientes disponibles antes de intentar leerlos con uno de los métodos read.
Implementación
public function get bytesAvailable():uint
connected:Boolean [read-only]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica si este objeto Socket está conectado actualmente. Una llamada a esta propiedad devuelve un valor true si el socket está conectado en ese momento; en caso contrario, devuelve false.
Implementación
public function get connected():Boolean
endian:String [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Indica el orden de bytes de los datos; los valores posibles son constantes de la clase flash.utils.Endian, Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.
El valor predeterminado es Endian.BIG_ENDIAN.
Implementación
public function get endian():String
public function set endian(value:String):void
Véase también
objectEncoding:uint [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Controla la versión del AMF utilizado al escribir o leer un objeto.
Implementación
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Véase también
public function Socket(host:String = null, port:int = 0)
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Crea un objeto Socket. 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.
Parámetros
| host:String (default = null) — El nombre del host con el que se realiza la conexión. Si no se especifica este parámetro, se crea un socket desconectado inicialmente.
|
| |
| port:int (default = 0) — Número de puerto con el que se realiza la conexión. Si no se especifica este parámetro, se crea un socket desconectado inicialmente.
|
Eventos
| connect:Event — Se distribuye cuando se establece una conexión de red. |
| |
| ioError:IOErrorEvent — Se distribuye cuando se produce un error de entrada o salida que provoca que la conexión se realice incorrectamente. |
| |
| securityError:SecurityErrorEvent — Se distribuye si la llamada a Socket.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 problema se puede solucionar utilizando un archivo de política entre dominios en el servidor. Para más información acerca de los archivos de política para sockets, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0. |
Emite
| SecurityError — Este error se produce por los motivos siguientes:
- Los archivos SWF locales que no son de confianza no pueden comunicarse en Internet. Puede solucionar este problema reclasificando el archivo SWF como archivo local con acceso a red o archivo de confianza.
- No se puede especificar un puerto de socket superior a 65535.
|
public function close():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Cierra el socket. No es posible leer ni escribir datos tras llamar al método close().
El evento close sólo se distribuye si el servidor cierra la conexión; no se distribuye al llamar al método close().
Puede reutilizar el objeto Socket si llama de nuevo al método connect().
Emite
| IOError — No se pudo cerrar el socket o éste no se abrió.
|
public function connect(host:String, port:int):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Realiza la conexión del socket con el host y el puerto especificados. Si la conexión falla inmediatamente, o bien se ha distribuido un evento o se ha emitido una excepción: se distribuye un evento de error si se especificó un host y se emite una excepción si no se especificó ningún host. En caso contrario, un evento informa sobre el estado de la conexión. Si el socket ya está conectado, primero se cierra la conexión existente.
Parámetros
| host:String — El nombre del host con el que se realiza la conexión. Si no se especifica ningún host, aquél con el que se establezca el contacto será el host en el que resida el archivo SWF que realiza la llamada. Si no especifica ningún host, utilice un detector de eventos para determinar si la conexión se ha realizado correctamente.
|
| |
| port:int — Número de puerto con el que se realiza la conexión.
|
Eventos
| connect:Event — Se distribuye cuando se establece una conexión de red. |
| |
| ioError:IOErrorEvent — Se distribuye si se especifica un host y cuando se produce un error de entrada o salida que provoca que la conexión se realice incorrectamente. |
| |
| securityError:SecurityErrorEvent — Se distribuye si la llamada a Socket.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 problema se puede solucionar utilizando un archivo de política entre dominios en el servidor. Para más información, consulte el capítulo "Seguridad de Flash Player" de Programación con ActionScript 3.0. |
Emite
| IOError — No se especificó ningún host y se produjo un error de conexión.
|
| |
| SecurityError — Este error se produce por los motivos siguientes:
- Los archivos SWF locales que no son de confianza no pueden comunicarse en Internet. Puede solucionar este problema reclasificando el archivo SWF como archivo local de red o archivo de confianza.
- No se puede especificar un puerto de socket superior a 65535.
- En la página HTML con el contenido SWF, el parámetro
allowNetworking de las etiquetas object y embed se define como "none".
|
Véase también
public function flush():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Alinea los datos acumulados en el búfer de salida del socket. Los datos escritos por el método write no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readBoolean():Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un valor booleano del socket. Tras leer un solo byte, el método devuelve true si el byte es distinto de cero; en caso contrario, devuelve false.
Valor devuelto
| Boolean — Un valor true si el byte leído es distinto de cero; en caso contrario, false.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readByte():int
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un byte con signo del socket.
Valor devuelto
| int — Un valor entre -128 y 127.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee el número de bytes de datos especificado por el parámetro length desde el socket. Los bytes se leen en la matriz de bytes especificada, comenzando por la posición indicada mediante offset.
Parámetros
| bytes:ByteArray — El objeto ByteArray en el que se leerán los datos.
|
| |
| offset:uint (default = 0) — El desplazamiento en el que debería comenzar la lectura de los datos en la matriz de bytes.
|
| |
| length:uint (default = 0) — El número de bytes que se van a leer. El valor predeterminado 0 hace que se lean todos los datos disponibles.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readDouble():Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un número de coma flotante con precisión doble IEEE 754 del socket.
Valor devuelto
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readFloat():Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un número de coma flotante con precisión simple IEEE 754 del socket.
Valor devuelto
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readInt():int
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un entero de 32 bits con signo del socket.
Valor devuelto
| int — Un valor entre -2147483648 y 2147483647.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readMultiByte(length:uint, charSet:String):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee una cadena multibyte desde la transmisión de bytes mediante el juego de caracteres especificado.
Parámetros
| length:uint — El número de bytes de la transmisión de bytes que se va a leer.
|
| |
| charSet:String — La cadena que denota el juego de caracteres que se utilizará para interpretar los bytes. Las posibles cadenas del conjunto de caracteres pueden ser "shift_jis", "CN-GB" y "iso-8859-1". Para obtener una lista completa, consulte los juegos de caracteres admitidos.
Nota: si el sistema actual no reconoce el valor del parámetro charSet, Flash Player utilizará la página de códigos predeterminada del sistema como conjunto de caracteres. Por ejemplo, un valor para el parámetro charSet, como en myTest.readMultiByte(22, "iso-8859-01") que utiliza 01 en lugar de 1 podría funcionar en el equipo de desarrollo, pero no en otro equipo. En el otro equipo, Flash Player utilizará la página de códigos predeterminada del sistema.
|
Valor devuelto
| String — Una cadena con codificación UTF-8.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
public function readObject():*
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un objeto del socket, codificado en formato serializado AMF.
Valor devuelto
| * — El objeto deserializado.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function readShort():int
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un entero de 16 bits con signo del socket.
Valor devuelto
| int — Un valor entre -32768 y 32767.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readUnsignedByte():uint
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un byte sin signo del socket.
Valor devuelto
| uint — Un valor entre 0 y 255.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readUnsignedInt():uint
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un entero de 32 bits sin signo del socket.
Valor devuelto
| uint — Un valor entre 0 y 4294967295.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readUnsignedShort():uint
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee un entero de 16 bits sin signo del socket.
Valor devuelto
| uint — Un valor entre 0 y 65535.
|
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readUTF():String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee una cadena UTF-8 del socket. Se da por hecho que la cadena tiene un prefijo de declaración de entero unsigned short que indica la longitud en bytes.
Valor devuelto
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function readUTFBytes(length:uint):String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Lee el número de bytes de datos UTF-8 especificado por el parámetro length desde el socket y devuelve una cadena.
Parámetros
| length:uint — El número de bytes que se van a leer.
|
Valor devuelto
Emite
| EOFError — No hay datos suficientes disponibles para leer.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
public function writeBoolean(value:Boolean):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un valor booleano en el socket. Este método escribe un solo byte con el valor 1 (true) ó 0 (false).
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:Boolean — El valor que se va a escribir en el socket. 1 (true) o 0 (false).
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeByte(value:int):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un byte en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:int — El valor que se va a escribir en el socket. Se utilizan los 8 bits más bajos del valor; los 24 bits altos se omiten.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe una secuencia de bytes desde la matriz de bytes especificada. La operación de escritura comienza en la posición especificada por offset.
Si omite el parámetro length, la longitud predeterminada de 0 hará que el método escriba en todo el búfer, comenzando por offset.
Si también omite el parámetro offset, se escribirá en todo el búfer.
Si offset o length están fuera de rango, se ajustarán para que coincidan con el principio y el final de la matriz bytes.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| bytes:ByteArray — El objeto ByteArray desde el que se escribirán los datos.
|
| |
| offset:uint (default = 0) — El desplazamiento basado en cero del objeto ByteArray bytes en el que debería comenzar la escritura de los datos.
|
| |
| length:uint (default = 0) — El número de bytes que se van a escribir. El valor predeterminado de 0 hace que se escriba en todo el búfer, comenzando por el valor especificado con el parámetro offset.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeDouble(value:Number):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un número de coma flotante con precisión doble IEEE 754 en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:Number — El valor que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeFloat(value:Number):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un número de coma flotante con precisión simple IEEE 754 en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:Number — El valor que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeInt(value:int):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un entero de 32 bits con signo en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:int — El valor que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeMultiByte(value:String, charSet:String):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe una cadena multibyte desde la transmisión de bytes mediante el juego de caracteres especificado.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:String — El valor de la cadena que se va a escribir.
|
| |
| charSet:String — La cadena que denota el juego de caracteres que se utilizará para interpretar los bytes. Las posibles cadenas del conjunto de caracteres pueden ser "shift_jis", "CN-GB" y "iso-8859-1". Para obtener una lista completa, consulte los juegos de caracteres admitidos.
|
Véase también
public function writeObject(object:*):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un objeto en el socket en formato serializado AMF.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| object:* — El objeto que se va a serializar.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeShort(value:int):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un entero de 16 bits en el socket. Los bytes escritos son los siguientes:
(v >> 8) & 0xff v & 0xff
Se utilizan los 16 bits más bajos del parámetro; los 16 bits altos se omiten.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:int — El valor que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeUnsignedInt(value:uint):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe un entero de 32 bits sin signo en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:uint — El valor que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeUTF(value:String):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe los datos siguientes en el socket: un entero de 16 bits sin signo, que indica la longitud de la cadena UTF-8 especificada en bytes, seguido de la propia cadena.
Antes de escribir la cadena, el método calcula el número de bytes necesarios para representar todos los caracteres de la cadena.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:String — La cadena que se va a escribir en el socket.
|
Emite
| RangeError — La longitud es superior a 65535.
|
| |
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
public function writeUTFBytes(value:String):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Escribe una cadena UTF-8 en el socket.
Nota: los datos escritos por este método no se transmiten de forma inmediata; se ponen en cola hasta que se llama al método flush().
Parámetros
| value:String — La cadena que se va a escribir en el socket.
|
Emite
| IOError — Error de entrada o salida generado en el socket, o bien el socket no está abierto.
|
Véase también
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.CLOSE
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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 Socket.close().
Define el valor de la propiedad
type de un objeto de evento
close.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto cuya conexión se ha cerrado. |
Tipo de objeto de evento: flash.events.Event
Event.type property = flash.events.Event.CONNECT
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Se distribuye cuando se establece una conexión de red.
Define el valor de la propiedad
type de un objeto de evento
connect.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto Socket o XMLSocket que ha establecido una conexión de red. |
Tipo de objeto de evento: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Se distribuye cuando se produce un error de entrada o salida que provoca que una operación de carga o de envío se realice incorrectamente.
Define el valor de la propiedad
type de un objeto de evento
ioError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto de red en el que se produce el error de entrada/salida. |
text | Texto que se mostrará como mensaje de error. |
Tipo de objeto de evento: flash.events.SecurityErrorEvent
SecurityErrorEvent.type property = flash.events.SecurityErrorEvent.SECURITY_ERROR
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Se distribuye si la llamada a Socket.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.
La constante
SecurityErrorEvent.SECURITY_ERROR define el valor de la propiedad
type de un objeto de evento
securityError.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | El objeto de red que informa sobre le error de seguridad. |
text | Texto que se mostrará como mensaje de error. |
Véase también
Tipo de objeto de evento: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.SOCKET_DATA
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Se distribuye cuando el socket ha recibido datos. Los eventos de tipo socketData no utilizan la propiedad ProgressEvent.bytesTotal.
Define el valor de la propiedad
type de un objeto de evento
socketData.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el objeto de evento. |
bytesLoaded | Número de elementos o bytes cargados en el momento en que el detector procesa el evento. |
bytesTotal | 0; los objetos de evento socketData no utilizan esta propiedad. |
target | El objeto Socket que informa sobre el progreso. |
En el ejemplo siguiente, se lee desde un socket, escribe en él y obtiene la información transmitida durante los eventos socket. A continuación se detallan los fragmentos más importantes del ejemplo:
- El constructor crea una instancia de
CustomSocket denominada socket y transfiere el nombre de host localhost y el puerto 80 como argumentos. Como CustomSocket amplía Socket, una llamada a super() llamará al constructor de Socket con localhost como nombre de host y 80 como número de puerto.
- A continuación, el ejemplo llama al método
configureListeners(), que añade detectores para eventos Socket.
Nota: para ejecutar el ejemplo, necesita un servidor que se ejecute en el mismo dominio en el que reside el archivo SWF (en el ejemplo, localhost) y que detecte en el puerto 80.
package {
import flash.display.Sprite;
public class SocketExample extends Sprite {
public function SocketExample() {
var socket:CustomSocket = 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(host, port);
configureListeners();
}
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();
}
}
© 2004-2007 Adobe Systems Incorporated. Todos los derechos reservados.
Fri Oct 12 2007, 2:30 AM GMT-07:00
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/net/Socket.html