Paqueteflash.net
Clasepublic class Socket
HerenciaSocket Inheritance EventDispatcher Inheritance Object
Implementa IDataInput, IDataOutput

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:

Para más información, consulte las siguientes secciones:

Ver los ejemplos

Véase también

Conexiones de socket


Propiedades públicas
 PropiedadDefinido por
  bytesAvailable : uint
[read-only] El número de bytes de datos disponibles para su lectura en el búfer de entrada.
Socket
  connected : Boolean
[read-only] Indica si este objeto Socket está conectado actualmente.
Socket
 Inheritedconstructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.
Object
  endian : String
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.
Socket
  objectEncoding : uint
Controla la versión del AMF utilizado al escribir o leer un objeto.
Socket
 Inheritedprototype : Object
[static] Una referencia al objeto prototipo de una clase u objeto de función.
Object
Métodos públicos
 MétodoDefinido por
  
Socket(host:String = null, port:int = 0)
Crea un objeto Socket.
Socket
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.
EventDispatcher
  
Cierra el socket.
Socket
  
connect(host:String, port:int):void
Realiza la conexión del socket con el host y el puerto especificados.
Socket
 Inherited
Distribuye un evento en el flujo del evento.
EventDispatcher
  
Alinea los datos acumulados en el búfer de salida del socket.
Socket
 Inherited
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.
EventDispatcher
 Inherited
Indica si un objeto tiene definida una propiedad especificada.
Object
 Inherited
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.
Object
 Inherited
Indica si existe la propiedad especificada y si es enumerable.
Object
  
Lee un valor booleano del socket.
Socket
  
Lee un byte con signo del socket.
Socket
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Lee el número de bytes de datos especificado por el parámetro length desde el socket.
Socket
  
Lee un número de coma flotante con precisión doble IEEE 754 del socket.
Socket
  
Lee un número de coma flotante con precisión simple IEEE 754 del socket.
Socket
  
Lee un entero de 32 bits con signo del socket.
Socket
  
readMultiByte(length:uint, charSet:String):String
Lee una cadena multibyte desde la transmisión de bytes mediante el juego de caracteres especificado.
Socket
  
Lee un objeto del socket, codificado en formato serializado AMF.
Socket
  
Lee un entero de 16 bits con signo del socket.
Socket
  
Lee un byte sin signo del socket.
Socket
  
Lee un entero de 32 bits sin signo del socket.
Socket
  
Lee un entero de 16 bits sin signo del socket.
Socket
  
Lee una cadena UTF-8 del socket.
Socket
  
Lee el número de bytes de datos UTF-8 especificado por el parámetro length desde el socket y devuelve una cadena.
Socket
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Elimina un detector del objeto EventDispatcher.
EventDispatcher
 Inherited
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.
Object
 Inherited
Devuelve la representación de cadena del objeto especificado.
Object
 Inherited
Devuelve el valor simple del objeto especificado.
Object
 Inherited
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.
EventDispatcher
  
Escribe un valor booleano en el socket.
Socket
  
writeByte(value:int):void
Escribe un byte en el socket.
Socket
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Escribe una secuencia de bytes desde la matriz de bytes especificada.
Socket
  
Escribe un número de coma flotante con precisión doble IEEE 754 en el socket.
Socket
  
Escribe un número de coma flotante con precisión simple IEEE 754 en el socket.
Socket
  
writeInt(value:int):void
Escribe un entero de 32 bits con signo en el socket.
Socket
  
writeMultiByte(value:String, charSet:String):void
Escribe una cadena multibyte desde la transmisión de bytes mediante el juego de caracteres especificado.
Socket
  
writeObject(object:*):void
Escribe un objeto en el socket en formato serializado AMF.
Socket
  
Escribe un entero de 16 bits en el socket.
Socket
  
Escribe un entero de 32 bits sin signo en el socket.
Socket
  
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.
Socket
  
Escribe una cadena UTF-8 en el socket.
Socket
Eventos
 Evento Resumen Definido por
 Inherited Se distribuye cuando Flash Player queda seleccionado por el sistema operativo y pasa a estar activo.EventDispatcher
   Se distribuye cuando el servidor cierra la conexión de socket.Socket
   Se distribuye cuando se establece una conexión de red.Socket
 Inherited Se distribuye cuando Flash Player deja de estar seleccionado por el sistema operativo y pasa a estar inactivo.EventDispatcher
   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.Socket
   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.Socket
   Se distribuye cuando el socket ha recibido datos.Socket
Información sobre propiedades
bytesAvailablepropiedad
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
connectedpropiedad 
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
endianpropiedad 
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

objectEncodingpropiedad 
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

Información sobre constructores
Socket()constructor
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.
Información sobre métodos
close()método
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ó.
connect()método 
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

flush()método 
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.
readBoolean()método 
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.
readByte()método 
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.
readBytes()método 
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.
readDouble()método 
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
Number

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.
readFloat()método 
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
Number

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.
readInt()método 
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.
readMultiByte()método 
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.
readObject()método 
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

readShort()método 
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.
readUnsignedByte()método 
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.
readUnsignedInt()método 
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.
readUnsignedShort()método 
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.
readUTF()método 
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
String

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.
readUTFBytes()método 
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
String

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.
writeBoolean()método 
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

writeByte()método 
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

writeBytes()método 
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

writeDouble()método 
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

writeFloat()método 
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

writeInt()método 
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

writeMultiByte()método 
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

writeObject()método 
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

writeShort()método 
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

writeUnsignedInt()método 
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

writeUTF()método 
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

writeUTFBytes()método 
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

Información sobre eventos
close Evento
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:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto cuya conexión se ha cerrado.
connect Evento  
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:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetObjeto Socket o XMLSocket que ha establecido una conexión de red.
ioError Evento  
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:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetEl objeto de red en el que se produce el error de entrada/salida.
textTexto que se mostrará como mensaje de error.
securityError Evento  
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:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento con un detector de eventos.
targetEl objeto de red que informa sobre le error de seguridad.
textTexto que se mostrará como mensaje de error.

Véase también

socketData Evento  
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:

PropiedadValor
bubblesfalse
cancelablefalse; no hay ningún comportamiento predeterminado que cancelar.
currentTargetEl objeto que procesa de forma activa el objeto de evento.
bytesLoadedNúmero de elementos o bytes cargados en el momento en que el detector procesa el evento.
bytesTotal0; los objetos de evento socketData no utilizan esta propiedad.
targetEl objeto Socket que informa sobre el progreso.
Ejemplos Cómo utilizar los ejemplos
SocketExample.as

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:
  1. 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.
  2. 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();
    }
}




 

Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios

Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/net/Socket.html