| 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.
- Il caricamento dei dati non è consentito se il file SWF si trova nella sandbox locale con file system e la risorsa di destinazione si trova in una sandbox di rete.
- Il caricamento dei dati non è consentito nemmeno se il file SWF chiamante si trova in una sandbox di rete mentre la risorsa di destinazione è locale.
- Il file SWF chiamante e la risorsa di rete a cui si accede devono trovarsi esattamente nello stesso dominio. Ad esempio, un file SWF in adobe.com può connettersi solo al daemon di un server in adobe.com.
- L'accesso a una risorsa su siti Web da domini diversi è consentito mediante un file dei criteri per i domini.
Per ulteriori informazioni, vedere i seguenti riferimenti:
Vedere gli esempi
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
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
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
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
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.
|
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.
|
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
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.
|
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.
|
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.
|
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.
|
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
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.
|
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
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.
|
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.
|
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.
|
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
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.
|
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.
|
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.
|
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.
|
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
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.
|
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
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.
|
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
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
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
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
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
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
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
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
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
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
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
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
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 |
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto la cui connessione è stata chiusa. |
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 |
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto Socket o XMLSocket che ha stabilito una connessione di rete. |
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 |
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete interessato dall'errore di input/output. |
text | Testo da visualizzare come messaggio di errore. |
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 |
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che riporta l'errore di sicurezza. |
text | Testo da visualizzare come messaggio di errore. |
Vedere anche
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 |
bubbles | false |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che sta elaborando attivamente l'evento. |
bytesLoaded | Il numero di elementi o di byte caricati nel momento in cui il listener elabora l'evento. |
bytesTotal | 0; questa proprietà non viene utilizzata dagli oggetti evento socketData. |
target | L'oggetto Socket che riporta l'avanzamento. |
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:
- 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.
- 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();
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 3:14 AM GMT-07:00
Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/net/Socket.html