Pacchettoflash.net
Classepublic class Socket
EreditarietàSocket Inheritance EventDispatcher Inheritance Object
Implementa IDataInput, IDataOutput

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

La classe Socket consente al codice ActionScript di effettuare connessioni socket e di leggere e scrivere dati binari originari. È simile a XMLSocket ma non impone il formato dei dati ricevuti o trasmessi.

La classe Socket è utile nelle operazioni con i server che utilizzano protocolli binari.

Quando si utilizza questa classe, considerare il modello di sicurezza di Flash Player.

Per ulteriori informazioni, vedere i seguenti riferimenti:

Vedere gli esempi

Vedere anche

Connessioni socket


Proprietà pubbliche
 ProprietàDefinito da
  bytesAvailable: uint
[sola lettura] Il numero di byte di dati disponibili per la lettura nel buffer di input.
Socket
  connected: Boolean
[sola lettura] Indica se l'oggetto Socket è correntemente connesso.
Socket
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
  endian: String
Indica l'ordine dei byte per i dati; i valori possibili sono costanti della classe flash.utils.Endian: Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.
Socket
  objectEncoding: uint
Controlla la versione di Action Message Format (AMF) utilizzata per scrivere o leggere un oggetto.
Socket
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
Metodi pubblici
 MetodoDefinito da
  
Socket(host:String = null, port:int = 0)
Crea un oggetto Socket.
Socket
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.
EventDispatcher
  
Chiude il socket.
Socket
  
connect(host:String, port:int):void
Connette il socket all'host e alla porta specificati.
Socket
 Inherited
Invia un evento nel flusso di eventi.
EventDispatcher
  
Svuota·tutti i dati eventualmente accumulati nel buffer di output del socket.
Socket
 Inherited
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.
EventDispatcher
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
  
Legge un valore booleano dal socket.
Socket
  
Legge un byte con segno dal socket.
Socket
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Legge il numero di byte di dati, specificato dal parametro lunghezza, dal socket.
Socket
  
Legge un numero a virgola mobile e a precisione doppia IEEE 754 dal socket.
Socket
  
Legge un numero a virgola mobile e a precisione singola IEEE 754 dal socket.
Socket
  
Legge un numero intero a 32 bit con segno dal socket.
Socket
  
readMultiByte(length:uint, charSet:String):String
Legge una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.
Socket
  
Legge un oggetto dal socket, codificato in formato serializzato AMF.
Socket
  
Legge un numero intero a 16 bit con segno dal socket.
Socket
  
Legge un byte senza segno dal socket.
Socket
  
Legge un numero intero a 32 bit senza segno dal socket.
Socket
  
Legge un numero intero a 16 bit senza segno dal socket.
Socket
  
Legge una stringa UTF-8 dal socket.
Socket
  
Legge il numero di byte di dati UTF-8, specificato dal parametro length, dal socket e restituisce una stringa.
Socket
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Rimuove un listener dall'oggetto EventDispatcher.
EventDispatcher
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Restituisce la rappresentazione in formato stringa dell'oggetto specificato.
Object
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
 Inherited
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.
EventDispatcher
  
Scrive un valore booleano nel socket.
Socket
  
writeByte(value:int):void
Scrive un byte nel socket.
Socket
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Scrive una sequenza di byte dall'array dei byte specificato.
Socket
  
Scrive un numero a virgola mobile e a precisione doppia IEEE 754 nel socket.
Socket
  
Scrive un numero a virgola mobile e a precisione singola IEEE 754 nel socket.
Socket
  
writeInt(value:int):void
Scrive un numero intero con segno a 32 bit nel socket.
Socket
  
writeMultiByte(value:String, charSet:String):void
Scrive una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.
Socket
  
writeObject(object:*):void
Scrive un oggetto nel socket in formato serializzato AMF.
Socket
  
Scrive un numero intero a 16 bit nel socket.
Socket
  
Scrive un numero intero senza segno a 32 bit nel socket.
Socket
  
Scrive i dati seguenti nel socket: un numero intero senza segno a 16 bit, che indica la lunghezza della stringa UTF-8 specificata espressa in byte, seguita dalla stringa stessa.
Socket
  
Scrive una stringa UTF-8 nel socket.
Socket
Eventi
 Evento Riepilogo Definito da
 Inherited Inviato quando Flash Player riceve lo stato di attivazione del sistema operativo e diventa attivo.EventDispatcher
   Inviato quando il server chiude la connessione socket.Socket
   Inviato quando è stata stabilita una connessione di rete.Socket
 Inherited Inviato quando Flash Player perde lo stato di attivazione del sistema operativo e sta per diventare inattivo.EventDispatcher
   Inviato quando si verifica un errore di input/output che impedisce un'operazione di invio o caricamento.Socket
   Inviato se una chiamata a Socket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o a una porta con numero inferiore a 1024.Socket
   Inviato se un socket ha ricevuto i dati.Socket
Descrizione delle proprietà
bytesAvailableproprietà
bytesAvailable:uint  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il numero di byte di dati disponibili per la lettura nel buffer di input.

Il codice deve accedere a bytesAvailable per garantire che siano disponibili dati sufficienti prima di tentarne la lettura con uno dei metodi read.


Implementazione
    public function get bytesAvailable():uint
connectedproprietà 
connected:Boolean  [sola lettura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se l'oggetto Socket è correntemente connesso. Una chiamata a questa proprietà restituisce un valore true se l'oggetto è attualmente connesso; false in caso contrario.


Implementazione
    public function get connected():Boolean
endianproprietà 
endian:String  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica l'ordine dei byte per i dati; i valori possibili sono costanti della classe flash.utils.Endian: Endian.BIG_ENDIAN o Endian.LITTLE_ENDIAN.

Il valore predefinito è Endian.BIG_ENDIAN.


Implementazione
    public function get endian():String
    public function set endian(value:String):void

Vedere anche

objectEncodingproprietà 
objectEncoding:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Controlla la versione di Action Message Format (AMF) utilizzata per scrivere o leggere un oggetto.


Implementazione
    public function get objectEncoding():uint
    public function set objectEncoding(value:uint):void

Vedere anche

Descrizione della funzione di costruzione
Socket()Funzione di costruzione
public function Socket(host:String = null, port:int = 0)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto Socket. Se non è specificato alcun parametro, viene creato un socket inizialmente disconnesso. Se sono specificati dei parametri, viene tentata una connessione all'host e alla porta specificati.

Parametri
host:String (default = null) — Il nome dell'host a cui connettersi. Se questo parametro non è specificato, viene creato un socket inizialmente disconnesso.
 
port:int (default = 0) — Il numero di porta a cui connettersi. Se questo parametro non è specificato, viene creato un socket inizialmente disconnesso.

Eventi
connect:Event — Inviato quando è stata stabilita una connessione di rete.
 
ioError:IOErrorEvent — Inviato quando si verifica un errore di input/output che impedisce la connessione.
 
securityError:SecurityErrorEvent — Inviato se una chiamata a Socket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o a una porta con numero inferiore a 1024. Questi problemi possono essere risolti utilizzando un file dei criteri dei domini sul server. Per ulteriori informazioni sui file dei criteri per i socket, consultare il capitolo Sicurezza di Flash Player nel manuale Programmazione in ActionScript 3.0.

Genera
SecurityError — Questo errore si verifica per i seguenti motivi:
  • I file SWF non attendibili locali potrebbero non essere in grado di comunicare con Internet. Questo problema può essere risolto riclassificando il file SWF come file locale con utilizzo in rete o come attendibile.
  • Non è possibile specificare una porta socket superiore a 65535.
Descrizione dei metodi
close()metodo
public function close():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Chiude il socket. Non è possibile leggere o scrivere alcun dato dopo che è stato chiamato il metodo close().

L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo close().

L'oggetto Socket può essere riutilizzato chiamando nuovamente il metodo connect() su di esso.


Genera
IOError — Impossibile chiudere il socket oppure il socket non è stato aperto.
connect()metodo 
public function connect(host:String, port:int):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Connette il socket all'host e alla porta specificati. Se la connessione fallisce immediatamente, viene inviato un evento o generata un'eccezione: viene inviato un evento di errore se è stato specificato un host; viene generata un'eccezione se non è stato specificato alcun host. In caso contrario, lo stato della connessione viene riportato da un evento. Se il socket è già connesso, prima viene chiusa la connessione esistente.

Parametri

host:String — Il nome dell'host a cui connettersi. Se non è specificato alcun host, l'host contattato è quello su cui si trova il file SWF. Se non si specifica un host, utilizzare un listener di eventi per determinare se la connessione è riuscita.
 
port:int — Il numero di porta a cui connettersi.


Eventi
connect:Event — Inviato quando è stata stabilita una connessione di rete.
 
ioError:IOErrorEvent — Inviato se è specificato un host e si verifica un errore di input/output che impedisce la connessione.
 
securityError:SecurityErrorEvent — Inviato se una chiamata a Socket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o a una porta con numero inferiore a 1024. Questi problemi possono essere risolti utilizzando un file dei criteri dei domini sul server. Per ulteriori informazioni, consultare il capitolo Sicurezza di Flash Player nel manuale Programmazione in ActionScript 3.0.

Genera
IOError — Non è stato specificato alcun host e la connessione non è riuscita.
 
SecurityError — Questo errore si verifica per i seguenti motivi:
  • I file SWF non attendibili locali potrebbero non essere in grado di comunicare con Internet. Questo problema può essere risolto riclassificando il file SWF come file locale con utilizzo in rete o come attendibile.
  • Non è possibile specificare una porta socket superiore a 65535.
  • Nella pagina HTML in cui è presente il contenuto SWF, il parametro allowNetworking dei tag object e embed è impostato su "none".

Vedere anche

flush()metodo 
public function flush():void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Svuota·tutti i dati eventualmente accumulati nel buffer di output del socket. I dati scritti dai metodi write non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readBoolean()metodo 
public function readBoolean():Boolean

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un valore booleano dal socket. Dopo aver letto un byte singolo, il metodo restituisce true se il byte è diverso da zero e false in caso contrario.

Restituisce
Boolean — Un valore true se il byte è diverso da zero; false in caso contrario.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readByte()metodo 
public function readByte():int

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un byte con segno dal socket.

Restituisce
int — Un valore compreso tra -128 e 127.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readBytes()metodo 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge il numero di byte di dati, specificato dal parametro length, dal socket. I byte vengono letti nell'array dei byte specificato, partendo dalla posizione indicata da offset.

Parametri

bytes:ByteArray — L'oggetto ByteArray in cui leggere i dati.
 
offset:uint (default = 0) — L'offset in corrispondenza del quale deve iniziare la lettura dei dati nell'array dei byte.
 
length:uint (default = 0) — Il numero di byte da leggere. Il valore predefinito 0 avvia la lettura di tutti i dati disponibili.


Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readDouble()metodo 
public function readDouble():Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero a virgola mobile e a precisione doppia IEEE 754 dal socket.

Restituisce
Number

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readFloat()metodo 
public function readFloat():Number

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero a virgola mobile e a precisione singola IEEE 754 dal socket.

Restituisce
Number

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readInt()metodo 
public function readInt():int

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero intero a 32 bit con segno dal socket.

Restituisce
int — Un valore compreso tra -2147483648 e 2147483647.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readMultiByte()metodo 
public function readMultiByte(length:uint, charSet:String):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.

Parametri

length:uint — Il numero di byte dal flusso di byte da leggere.
 
charSet:String — La stringa che indica il set di caratteri da utilizzare per interpretare i byte. Le stringhe dei set di caratteri possibili comprendono "shift_jis", "CN-GB" e "iso-8859-1". Per un elenco completo, vedere Set di caratteri supportati.

Nota: se il valore del parametro charSet non è riconosciuto dal sistema corrente, Flash Player impiega la pagina di codice predefinita del sistema come set di caratteri. Ad esempio, un valore per il parametro charSet, come inmyTest.readMultiByte(22, "iso-8859-01") che impiega 01 anziché 1 può funzionare sulla macchina utilizzata per lo sviluppo, ma non su un'altra macchina. Sull'altra macchina, Flash Player utilizzerà la pagina di codice predefinita del sistema.

Restituisce
String — Una stringa con codifica UTF-8.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
readObject()metodo 
public function readObject():*

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un oggetto dal socket, codificato in formato serializzato AMF.

Restituisce
* — L'oggetto deserializzato.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

readShort()metodo 
public function readShort():int

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero intero a 16 bit con segno dal socket.

Restituisce
int — Un valore compreso tra -32768 e 32767.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readUnsignedByte()metodo 
public function readUnsignedByte():uint

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un byte senza segno dal socket.

Restituisce
uint — Un valore compreso tra 0 e 255.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readUnsignedInt()metodo 
public function readUnsignedInt():uint

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero intero a 32 bit senza segno dal socket.

Restituisce
uint — Un valore compreso tra 0 e 4294967295.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readUnsignedShort()metodo 
public function readUnsignedShort():uint

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge un numero intero a 16 bit senza segno dal socket.

Restituisce
uint — Un valore compreso tra 0 e 65535.

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readUTF()metodo 
public function readUTF():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge una stringa UTF-8 dal socket. Presume che la stringa abbia come prefisso un numero intero short senza segno che indica la lunghezza in byte.

Restituisce
String

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
readUTFBytes()metodo 
public function readUTFBytes(length:uint):String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Legge il numero di byte di dati UTF-8, specificato dal parametro length, dal socket e restituisce una stringa.

Parametri

length:uint — Il numero di byte da leggere.

Restituisce
String

Genera
EOFError — Non sono disponibili dati sufficienti per la lettura.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.
writeBoolean()metodo 
public function writeBoolean(value:Boolean):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un valore booleano nel socket. Questo metodo scrive un byte singolo, con valore 1 (true) o 0 (false).

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:Boolean — Il valore da scrivere nel socket: 1 (true) o 0 (false).


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeByte()metodo 
public function writeByte(value:int):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un byte nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:int — Il valore da scrivere nel socket. Vengono utilizzati gli 8 bit inferiori del valore; i 24 bit superiori vengono ignorati.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeBytes()metodo 
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive una sequenza di byte dall'array dei byte specificato. L'operazione di scrittura inizia dalla posizione specificata da offset.

Se si omette il parametro length, la lunghezza predefinita 0 impone al metodo di scrivere l'intero buffer a partire da offset.

Se si omette anche il parametro offset, viene scritto l'intero buffer.

Se offset o length è fuori dall'intervallo, viene regolato per corrispondere all'inizio e alla fine dell'array bytes.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

bytes:ByteArray — L'oggetto ByteArray da cui scrivere i dati.
 
offset:uint (default = 0) — L'offset a base zero nell'oggetto ByteArray bytes in corrispondenza del quale deve iniziare la scrittura dei dati.
 
length:uint (default = 0) — Il numero di byte da scrivere. Il valore predefinito 0 specifica la scrittura dell'intero buffer, a partire dal valore specificato dal parametro offset.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeDouble()metodo 
public function writeDouble(value:Number):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un numero a virgola mobile e a precisione doppia IEEE 754 nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:Number — Il valore da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeFloat()metodo 
public function writeFloat(value:Number):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un numero a virgola mobile e a precisione singola IEEE 754 nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:Number — Il valore da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeInt()metodo 
public function writeInt(value:int):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un numero intero con segno a 32 bit nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:int — Il valore da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeMultiByte()metodo 
public function writeMultiByte(value:String, charSet:String):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive una stringa multibyte dal flusso di byte utilizzando il set di caratteri specificato.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:String — Il valore stringa da scrivere.
 
charSet:String — La stringa che indica il set di caratteri da utilizzare per interpretare i byte. Le stringhe dei set di caratteri possibili comprendono "shift_jis", "CN-GB" e "iso-8859-1". Per un elenco completo, vedere Set di caratteri supportati.

Vedere anche

writeObject()metodo 
public function writeObject(object:*):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un oggetto nel socket in formato serializzato AMF.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

object:* — L'oggetto da serializzare.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeShort()metodo 
public function writeShort(value:int):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un numero intero a 16 bit nel socket. I byte scritti sono i seguenti:

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

Vengono utilizzati i 16 bit inferiori del parametro; i 16 bit superiori vengono ignorati.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:int — Il valore da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeUnsignedInt()metodo 
public function writeUnsignedInt(value:uint):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive un numero intero senza segno a 32 bit nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:uint — Il valore da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeUTF()metodo 
public function writeUTF(value:String):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive i dati seguenti nel socket: un numero intero senza segno a 16 bit, che indica la lunghezza della stringa UTF-8 specificata espressa in byte, seguita dalla stringa stessa.

Prima di scrivere la stringa, il metodo calcola il numero di byte necessari per rappresentare tutti i caratteri della stringa.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:String — La stringa da scrivere nel socket.


Genera
RangeError — La lunghezza è superiore a 65535.
 
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

writeUTFBytes()metodo 
public function writeUTFBytes(value:String):void

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Scrive una stringa UTF-8 nel socket.

Nota: i dati scritti da questo metodo non vengono scritti immediatamente; vengono messi in coda fino a quando non viene chiamato il metodo flush().

Parametri

value:String — La stringa da scrivere nel socket.


Genera
IOError — Si è verificato un errore di I/O nel socket oppure il socket non è aperto.

Vedere anche

Descrizione degli eventi
close Evento
Tipo di oggetto evento: flash.events.Event
Event.type property = flash.events.Event.CLOSE

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato quando il server chiude la connessione socket. L'evento close viene inviato solo quando il server chiude la connessione; non viene inviato quando si chiama il metodo Socket.close().

Definisce il valore della proprietà type di un oggetto evento close.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto la cui connessione è stata chiusa.
connect Evento  
Tipo di oggetto evento: flash.events.Event
Event.type property = flash.events.Event.CONNECT

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato quando è stata stabilita una connessione di rete.

Definisce il valore della proprietà type di un oggetto evento connect.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto Socket o XMLSocket che ha stabilito una connessione di rete.
ioError Evento  
Tipo di oggetto evento: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato quando si verifica un errore di input/output che impedisce un'operazione di invio o caricamento.

Definisce il valore della proprietà type di un oggetto evento ioError.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto di rete interessato dall'errore di input/output.
textTesto da visualizzare come messaggio di errore.
securityError Evento  
Tipo di oggetto evento: flash.events.SecurityErrorEvent
SecurityErrorEvent.type property = flash.events.SecurityErrorEvent.SECURITY_ERROR

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato se una chiamata a Socket.connect() tenta di connettersi a un server che si trova al di fuori della funzione di sicurezza sandbox del chiamante o a una porta con numero inferiore a 1024.

La costante SecurityErrorEvent.SECURITY_ERROR definisce il valore della proprietà type di un oggetto evento securityError.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
targetL'oggetto di rete che riporta l'errore di sicurezza.
textTesto da visualizzare come messaggio di errore.

Vedere anche

socketData Evento  
Tipo di oggetto evento: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.SOCKET_DATA

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Inviato se un socket ha ricevuto i dati. Gli eventi di tipo socketData non utilizzano la proprietà ProgressEvent.bytesTotal.

Definisce il valore della proprietà type di un oggetto evento socketData.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblesfalse
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che sta elaborando attivamente l'evento.
bytesLoadedIl numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento.
bytesTotal0; questa proprietà non viene utilizzata dagli oggetti evento socketData.
targetL'oggetto Socket che riporta l'avanzamento.
Esempi Come utilizzare gli esempi
SocketExample.as

Nell'esempio seguente viene effettuata la lettura e la scrittura su un socket e vengono prodotti come output le informazioni trasmesse durante gli eventi socket. Qui di seguito sono riportati i punti salienti dell'esempio:
  1. La funzione di costruzione crea un'istanza CustomSocket di nome socket e passa il nome dell'host localhost e la porta 80 come argomenti. Poiché CustomSocket estende Socket, una chiamata a super() chiama la funzione di costruzione Socket con localhost come nome dell'host e 80 come numero di porta.
  2. Quindi, l'esempio chiama il metodo configureListeners(), che aggiunge i listener per gli eventi Socket.

Nota: per provare l'esempio, è necessario che un server sia in esecuzione nello stesso dominio in cui risiede il file SWF (nell'esempio, localhost) e ascolti dalla porta 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();
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/net/Socket.html