Pakket | flash.net |
Klasse | public class Socket |
Overerving | Socket EventDispatcher Object |
Implementatie | IDataInput, IDataOutput |
Subklassen | SecureSocket |
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
De klasse Socket is nuttig wanneer u werkt met servers die binaire protocollen gebruiken.
U moet eerst een object Socket maken met de constructor newSocket
voordat u de methoden van de klasse Socket kunt gebruiken.
Een socket verzendt en ontvangt gegevens asynchroon.
Op bepaalde besturingssystemen wordt flush() automatisch aangeroepen tussen uitvoeringsframes. Op andere besturingssystemen, zoals Windows, worden de gegevens nooit verzonden tenzij u flush()
expliciet aanroept. Om ervoor te zorgen dat uw toepassing betrouwbaar is op alle besturingssystemen, kunt u het best de methode flush()
aanroepen nadat u elk bericht (of gerelateerde groep gegevens) naar de socket schrijft.
In Adobe AIR worden Socket-objecten ook gemaakt als een luisterende ServerSocket een verbinding ontvangt van een extern proces. De Socket die de verbinding vertegenwoordigt, wordt verstuurd in een ServerSocketConnectEvent. Uw toepassing is verantwoordelijk voor het onderhouden van een referentie naar dit Socket-object. Als u dit niet doet, kan het Socket-object in aanmerking komen voor opschoning en kan deze tijdens de uitvoering zonder waarschuwing worden vernietigd.
SWF-inhoud die wordt uitgevoerd in de beveiligingssandbox Lokaal-met-bestandssysteem kan geen sockets gebruiken.
Bestanden met socketbeleid op de doelhost bepalen vanaf welke hosts SWF-bestanden socketverbindingen kunnen maken en naar welke poorten die verbindingen kunnen worden gemaakt. De beveiligingsvereisten met betrekking tot bestanden met socketbeleid zijn in de laatste paar versies van Flash Player strenger geworden. Adobe raadt u aan om in alle versies van Flash Player een bestand met socketbeleid te gebruiken, in sommige gevallen is een bestand met socketbeleid zelfs vereist. Als u werkt met Socket-objecten, moet u er dus voor zorgen dat de doelhost indien nodig een bestand met socketbeleid levert.
De onderstaande lijst geeft de vereisten voor bestanden met socketbeleid in verschillende versies van Flash Player:
- In Flash Player 9.0.124.0 en hoger is voor elke Socket-verbinding een bestand met socketbeleid vereist. Oftewel, een bestand met socketbeleid op de doelhost is vereist, met welke poort u ook verbinding maakt, en is zelfs vereist als u verbinding maakt met een poort op dezelfde host die als server voor het SWF-bestand fungeert.
- In Flash Player 9.0.115.0 en eerder kunt u alleen verbinding maken met een poortnummer lager dan 1024, of met een andere host dan de host met het SWF-bestand, als er op de doelhost een bestand met socket-beleid aanwezig is.
- Als de doelhost geen bestand met socketbeleid heeft, wordt in Flash Player 9.0.115.0 een waarschuwing weergegeven wanneer de Flash Debug Player wordt gebruikt, zelfs als er geen bestand met socketbeleid is vereist.
- In AIR is geen socketbeleidsbestand vereist voor content die wordt uitgevoerd in de beveiligingssandbox van de toepassing. Socketbeleidsbestanden zijn vereist voor elke socketverbinding die wordt gemaakt door inhoud die wordt uitgevoerd buiten de beveiligingssandbox van de AIR-toepassing.
Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
bytesAvailable : uint [alleen-lezen]
Het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer. | Socket | ||
bytesPending : uint [alleen-lezen]
Geeft het aantal resterende bytes in de schrijfbuffer aan. | Socket | ||
connected : Boolean [alleen-lezen]
Geeft aan of dit object Socket momenteel is verbonden. | Socket | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
endian : String
Geeft de bytevolgorde voor de gegevens aan. | Socket | ||
localAddress : String [alleen-lezen]
Het IP-adres waaraan deze socket gekoppeld is op een lokale machine. | Socket | ||
localPort : int [alleen-lezen]
De poort waaraan deze socket gekoppeld is op een lokale machine. | Socket | ||
objectEncoding : uint
Beheert de AMF-versie die bij het schrijven of lezen van een object wordt gebruikt. | Socket | ||
remoteAddress : String [alleen-lezen]
Het IP-adres van de machine op afstand waaraan deze socket is verbonden. | Socket | ||
remotePort : int [alleen-lezen]
De poort van de machine op afstand waaraan deze socket is verbonden. | Socket | ||
timeout : uint
Hiermee wordt aangegeven hoeveel milliseconden er op een verbinding wordt gewacht. | Socket |
Methode | Gedefinieerd door | ||
---|---|---|---|
Maakt een nieuw object Socket. | Socket | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
Sluit de socket. | Socket | ||
Verbindt de socket met de opgegeven host en poort. | Socket | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
Hiermee worden verzamelde gegevens uit de uitvoerbuffer van de socket verwijderd. | Socket | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Leest een Booleaanse waarde uit de socket. | Socket | ||
Leest een byte met teken uit de socket. | Socket | ||
Leest het aantal gegevensbytes dat in de parameter length van de socket is opgegeven. | Socket | ||
Leest een IEEE 754-getal met drijvende komma en dubbele precisie uit de socket. | Socket | ||
Leest een IEEE 754-getal met drijvende komma en enkele precisie uit de socket. | Socket | ||
Leest een 32-bits geheel getal met teken uit de socket. | Socket | ||
Leest een multibyte-tekenreeks met de opgegeven tekenset uit de bytestream. | Socket | ||
readObject():*
Hiermee wordt een in AMF-indeling met serienummering gecodeerd object uit de socket gelezen. | Socket | ||
Leest een 16-bits geheel getal met teken uit de socket. | Socket | ||
Leest een byte zonder teken uit de socket. | Socket | ||
Leest een 32-bits geheel getal zonder teken uit de socket. | Socket | ||
Leest een 16-bits geheel getal zonder teken uit de socket. | Socket | ||
Leest een UTF-8-tekenreeks uit de socket. | Socket | ||
Leest het aantal UTF-8-gegevensbytes dat met de parameter length van de socket is opgegeven, waarna een tekenreeks wordt geretourneerd. | Socket | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | ||
Schrijft een Booleaanse waarde naar de socket. | Socket | ||
Schrijft een byte naar de socket. | Socket | ||
Schrijft een reeks bytes vanuit de opgegeven bytearray. | Socket | ||
Schrijft een IEEE 754 getal met drijvende komma en dubbele precisie naar de socket. | Socket | ||
Schrijft een IEEE 754-getal met drijvende komma en enkele precisie naar de socket. | Socket | ||
Schrijft een 32-bits geheel getal met teken naar de socket. | Socket | ||
Schrijft een multibyte-tekenreeks vanuit de bytestream met de opgegeven tekenset. | Socket | ||
Schrijft een object in AMF-indeling met serienummering naar de socket. | Socket | ||
Schrijft een 16-bits geheel getal naar de socket. | Socket | ||
Schrijft een 32-bits geheel getal zonder teken naar de socket. | Socket | ||
Schrijft de volgende gegevens naar de socket: een 16-bits geheel getal zonder teken dat de lengte in bytes van de opgegeven UTF-8-tekenreeks aangeeft, gevolgd door de tekenreeks zelf. | Socket | ||
Schrijft een UTF-8-tekenreeks naar de socket. | Socket |
Gebeurtenis | Overzicht | Gedefinieerd door | ||
---|---|---|---|---|
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | |||
Wordt verzonden wanneer de server de socketverbinding sluit. | Socket | |||
Wordt verzonden wanneer een netwerkverbinding tot stand is gebracht. | Socket | |||
[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | |||
Wordt verzonden wanneer een invoer-/uitvoerfout optreedt die ertoe leidt dat een verzend- of laadbewerking mislukt. | Socket | |||
Wordt verzonden wanneer een socket gegevens verplaatst van de schrijfbuffer naar de netwerktransportlaag. | Socket | |||
Wordt verzonden wanneer een aanroep naar Socket.connect() verbinding probeert te maken met een server die is verboden door de beveiligingssandbox van de aanroeper of met een poort lager dan 1024 en er geen socketbeleid bestaat voor een dergelijke verbinding. | Socket | |||
Wordt verzonden wanneer een socket gegevens heeft ontvangen. | Socket |
bytesAvailable | eigenschap |
bytesAvailable:uint
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Het aantal beschikbare gegevensbytes voor het lezen in de invoerbuffer.
Uw code moet bytesAvailable
aanroepen om er zeker van te zijn dat voldoende gegevens beschikbaar zijn voordat wordt geprobeerd deze te lezen met een van de methoden read
.
Implementatie
public function get bytesAvailable():uint
bytesPending | eigenschap |
bytesPending:uint
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 11, AIR 3.0 |
Geeft het aantal resterende bytes in de schrijfbuffer aan.
Gebruik deze eigenschap in combinatie met de OutputProgressEvent. Er treedt een OutputProgressEvent op wanneer gegevens van de schrijfbuffer naar het netwerk worden geschreven. In de gebeurtenishandler kunt u bytesPending
controleren om te zien hoeveel resterende gegevens in de buffer wachten om te worden geschreven. Als bytesPending
0 retourneert, betekent dit dat alle gegevens van de schrijfbuffer naar het netwerk werden doorgegeven en dat het veilig is om dingen te doen als het verwijderen van gebeurtenishandlers, het leegmaken van socketverwijzingen, het starten van de volgende upload in een wachtrij enzovoort.
Implementatie
public function get bytesPending():uint
Verwante API-elementen
connected | eigenschap |
connected:Boolean
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft aan of dit object Socket momenteel is verbonden. Het aanroepen van deze eigenschap retourneert de waarde true
wanneer de socket momenteel is verbonden, anders false
.
Implementatie
public function get connected():Boolean
endian | eigenschap |
endian:String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Geeft de bytevolgorde van de gegevens aan. Mogelijke waarden zijn constanten uit de klasse flash.utils.Endian, namelijk Endian.BIG_ENDIAN
of Endian.LITTLE_ENDIAN
.
De standaardwaarde is Endian.BIG_ENDIAN.
Implementatie
public function get endian():String
public function set endian(value:String):void
Verwante API-elementen
localAddress | eigenschap |
localPort | eigenschap |
objectEncoding | eigenschap |
objectEncoding:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Beheert de AMF-versie die bij het schrijven of lezen van een object wordt gebruikt.
Implementatie
public function get objectEncoding():uint
public function set objectEncoding(value:uint):void
Verwante API-elementen
remoteAddress | eigenschap |
remoteAddress:String
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 2 |
Het IP-adres van de machine op afstand waaraan deze socket is verbonden.
U kunt deze eigenschap gebruiken om het IP-adres vast te stellen van een clientsocket die door een ServerSocket-object in een ServerSocketConnectEvent-gebeurtenis is verzonden. Gebruik de klasse DNSResolver om indien gewenst een IP-adres om te zetten naar een domeinnaam.
Implementatie
public function get remoteAddress():String
Verwante API-elementen
remotePort | eigenschap |
remotePort:int
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 2 |
De poort van de machine op afstand waaraan deze socket is verbonden.
U kunt deze eigenschap gebruiken om het poortnummer vast te stellen van een clientsocket die door een ServerSocket-object in een ServerSocketConnectEvent-gebeurtenis is verzonden.
Implementatie
public function get remotePort():int
Verwante API-elementen
timeout | eigenschap |
timeout:uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Hiermee wordt aangegeven hoeveel milliseconden er op een verbinding wordt gewacht.
Als de verbinding niet binnen de opgegeven tijd tot stand kan worden gebracht, is de verbinding mislukt. De standaardwaarde is 20,000 (twintig seconden).
Implementatie
public function get timeout():uint
public function set timeout(value:uint):void
Socket | () | Constructor |
public function Socket(host:String = null, port:int = 0)
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Maakt een nieuw object Socket. Wanneer geen parameters worden opgegeven, wordt een aanvankelijk niet-verbonden socket gemaakt. Wanneer wel parameters worden opgegeven, wordt geprobeerd verbinding te maken met de opgegeven host en poort.
Opmerking: het wordt sterk aanbevolen om gebruik te maken van het constructorformulier zonder parameters, vervolgens eventuele gebeurtenislisteners toe te voegen en vervolgens de methode connect
aan te roepen met de parameters host
en poort
. Deze volgorde zorgt ervoor dat alle gebeurtenislisteners goed werken.
host:String (default = null ) — Een volledig gekwalificeerde DNS-domeinnaam of een IP-adres. IPv4-adressen zijn 'puntdecimale' getallen, zoals 192.0.2.0. In Flash Player 9.0.115.0 en AIR 1.0 en hoger kunt u hexadecimale IPv6-adressen opgeven, zoals 2001:db8:ccc3:ffff:0:444d:555e:666f. U kunt ook null opgeven om verbinding te maken met de hostserver waarop het SWF-bestand zich bevindt. Wanneer het SWF-bestand dat deze aanroep maakt in een webbrowser wordt uitgevoerd, moet host zich in het domein bevinden waar het SWF-bestand oorspronkelijk vandaan komt.
| |
port:int (default = 0 ) — Het TCP-poortnummer op de doelhost dat wordt gebruikt om een verbinding tot stand te brengen. In Flash Player 9.0.124.0 en hoger moet de doelhost een bestand met socketbeleid hebben waarin is aangegeven dat socketverbindingen zijn toegestaan tussen de host die als server voor het SWF-bestand fungeert en de opgegeven poort. In eerdere versies van Flash Player is alleen een bestand met socket-beleid nodig als u verbinding wilt maken met een poortnummer lager dan 1024 of met een andere host dan de host met het SWF-bestand.
|
Gebeurtenissen
connect: — Wordt verzonden wanneer een netwerkverbinding tot stand is gebracht.
| |
ioError: — Wordt verzonden wanneer een invoer-/uitvoerfout optreedt die ertoe leidt dat de verbinding mislukt.
| |
securityError: —
Wordt verzonden wanneer een aanroep naar Socket.connect() verbinding probeert te maken met een server zonder socketbeleidsbestand of met een server waarvan het beleidsbestand de aanroepende host geen toegang tot de opgegeven poort geeft. Zie "Website-bediening (beleidsbestanden)" in de Adobe ActionScript 3.0-ontwikkelaarsgids en het Flash Player Developer Center-onderwerp:Security voor meer informatie.
|
Gegenereerde uitzondering
SecurityError — Deze fout kan om de volgende redenen in SWF-inhoud optreden:
|
close | () | methode |
public function close():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Sluit de socket. U kunt geen gegevens lezen of schrijven nadat de methode close()
is aangeroepen.
De gebeurtenis close
wordt alleen verzonden wanneer de server de verbinding sluit. De gebeurtenis wordt niet verzonden wanneer u de methode close()
aanroept.
U kunt het object Socket opnieuw gebruiken door nogmaals de methode connect()
ervoor aan te roepen.
Gegenereerde uitzondering
IOError — De socket kon niet worden gesloten of de socket was niet geopend.
|
connect | () | methode |
public function connect(host:String, port:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Verbindt de socket met de opgegeven host en poort.
Wanneer de verbinding direct mislukt, is een gebeurtenis verzonden of een uitzondering gegenereerd: er wordt een foutgebeurtenis verzonden wanneer een host is opgegeven, terwijl een uitzondering wordt gegenereerd wanneer geen host is opgegeven. Anders wordt de status van de verbinding door een gebeurtenis gemeld. Wanneer de socket al verbinding heeft, wordt eerst de bestaande verbinding gesloten.
Parameters
host:String — De naam of het IP-adres waarmee de host verbinding maakt. Wanneer geen host is opgegeven, wordt contact gemaakt met de host waarop het aanroepende bestand zich bevindt. Wanneer u geen host opgeeft, gebruikt u een gebeurtenislistener om te bepalen of de verbinding gelukt is.
| |
port:int — Het poortnummer waarmee verbinding moet worden gemaakt.
|
Gebeurtenissen
connect: — Wordt verzonden wanneer een netwerkverbinding tot stand is gebracht.
| |
ioError: — Wordt verzonden wanneer een host is opgegeven en een invoer-/uitvoerfout optreedt die ertoe leidt dat de verbinding mislukt.
| |
securityError: — Wordt verzonden als een aanroep van een Socket.connect() verbinding probeert te maken met een server zonder bestand met socketbeleid of met een server waarvan het beleidsbestand de aanroepende host geen toegang tot de opgegeven poort geeft. Zie "Website-bediening (beleidsbestanden)" in de Adobe ActionScript 3.0-ontwikkelaarsgids en het Flash Player Developer Center-onderwerp:Security voor meer informatie.
|
Gegenereerde uitzondering
IOError — Er is geen host opgegeven en de verbinding is mislukt.
| |
SecurityError — Deze fout kan om de volgende redenen in SWF-inhoud optreden:
|
flush | () | methode |
public function flush():void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hiermee worden verzamelde gegevens uit de uitvoerbuffer van de socket verwijderd.
Op bepaalde besturingssystemen wordt flush() automatisch aangeroepen tussen uitvoeringsframes. Op andere besturingssystemen, zoals Windows, worden de gegevens nooit verzonden tenzij u flush()
expliciet aanroept. Om ervoor te zorgen dat uw toepassing betrouwbaar is op alle besturingssystemen, kunt u het best de methode flush()
aanroepen nadat u elk bericht (of gerelateerde groep gegevens) naar de socket schrijft.
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readBoolean | () | methode |
public function readBoolean():Boolean
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een Booleaanse waarde uit de socket. Nadat een enkele byte is gelezen, retourneert de methode true
wanneer de byte niet-nul is en anders false
.
Boolean — De waarde true wanneer de gelezen byte niet-nul is, anders false .
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readByte | () | methode |
public function readByte():int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een byte met teken uit de socket.
Geretourneerde waardeint — Een waarde van -128 tot 127.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readBytes | () | methode |
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest het aantal gegevensbytes dat in de parameter length van de socket is opgegeven. De bytes worden ingelezen in de opgegeven bytearray, te beginnen met de positie die wordt aangegeven met offset
.
Parameters
bytes:ByteArray — Het object ByteArray waarin gegevens worden ingelezen.
| |
offset:uint (default = 0 ) — De positie waar het lezen van de gegevens in de bytearray moet beginnen.
| |
length:uint (default = 0 ) — Het aantal bytes dat moet worden gelezen. De standaardwaarde 0 zorgt ervoor dat alle beschikbare gegevens worden gelezen.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readDouble | () | methode |
public function readDouble():Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een IEEE 754-getal met drijvende komma en dubbele precisie uit de socket.
Geretourneerde waardeNumber — Een IEEE 754 drijvende-kommagetal met dubbele precisie.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readFloat | () | methode |
public function readFloat():Number
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een IEEE 754-getal met drijvende komma en enkele precisie uit de socket.
Geretourneerde waardeNumber — Een IEEE 754 drijvende-kommagetal met enkele precisie.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readInt | () | methode |
public function readInt():int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een 32-bits geheel getal met teken uit de socket.
Geretourneerde waardeint — Een waarde van -2147483648 tot 2147483647.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readMultiByte | () | methode |
public function readMultiByte(length:uint, charSet:String):String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een multibyte-tekenreeks met de opgegeven tekenset uit de bytestream.
Parameters
length:uint — Het aantal bytes van de bytestream dat moet worden gelezen.
| |
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt om de bytes te interpreteren. Mogelijke tekensetreeksen zijn onder andere "shift_jis" , "CN-GB" en "iso-8859-1" . Zie Ondersteunde tekensets voor een complete lijst.
Opmerking: Als de waarde voor de parameter |
String — Een UTF-8-gecodeerde tekenreeks.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
|
readObject | () | methode |
public function readObject():*
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Hiermee wordt een in AMF-indeling met serienummering gecodeerd object uit de socket gelezen.
Geretourneerde waarde* — Het gedeserialiseerde object.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
readShort | () | methode |
public function readShort():int
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een 16-bits geheel getal met teken uit de socket.
Geretourneerde waardeint — Een waarde van -32768 tot 32767.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readUnsignedByte | () | methode |
public function readUnsignedByte():uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een byte zonder teken uit de socket.
Geretourneerde waardeuint — Een waarde van 0 tot 255.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readUnsignedInt | () | methode |
public function readUnsignedInt():uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een 32-bits geheel getal zonder teken uit de socket.
Geretourneerde waardeuint — Een waarde van 0 tot 4294967295.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readUnsignedShort | () | methode |
public function readUnsignedShort():uint
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een 16-bits geheel getal zonder teken uit de socket.
Geretourneerde waardeuint — Een waarde van 0 tot 65535.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readUTF | () | methode |
public function readUTF():String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest een UTF-8-tekenreeks uit de socket. Er wordt aangenomen dat de tekenreeks begint met een kort geheel getal zonder teken dat de lengte in bytes aangeeft.
Geretourneerde waardeString — Een UTF-8-tekenreeks.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
readUTFBytes | () | methode |
public function readUTFBytes(length:uint):String
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Leest het aantal UTF-8-gegevensbytes dat met de parameter length
van de socket is opgegeven, waarna een tekenreeks wordt geretourneerd.
Parameters
length:uint — Het aantal bytes dat moet worden gelezen.
|
String — Een UTF-8-tekenreeks.
|
Gegenereerde uitzondering
EOFError — Er zijn onvoldoende gegevens beschikbaar om te lezen.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
writeBoolean | () | methode |
public function writeBoolean(value:Boolean):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een Booleaanse waarde naar de socket. Deze methode schrijft één byte met de waarde 1 (true
) of 0 (false
).
Parameters
value:Boolean — De waarde die naar de socket moet worden geschreven: 1 (true ) of 0 (false ).
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeByte | () | methode |
public function writeByte(value:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een byte naar de socket.
Parameters
value:int — De waarde die naar de socket moet worden geschreven. De lage 8 bits van de waarde worden gebruikt, de hoge 24 bits worden genegeerd.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeBytes | () | methode |
public function writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een reeks bytes vanuit de opgegeven bytearray. De schrijfbewerking begint op de positie die door offset
wordt opgegeven.
Wanneer u de parameter length
weglaat, zorgt de standaardwaarde 0 ervoor dat de methode de gehele buffer schrijft, te beginnen bij offset
.
Wanneer u de parameter offset
weglaat, wordt de gehele buffer geschreven.
Parameters
bytes:ByteArray — Het object ByteArray waarvan de gegevens worden geschreven.
| |
offset:uint (default = 0 ) — De op nul gebaseerde positie in het object ByteArray bytes waar het schrijven van de gegevens moet beginnen.
| |
length:uint (default = 0 ) — Het aantal bytes dat moet worden geschreven. Bij de standaardwaarde 0 wordt de gehele buffer geschreven, te beginnen bij de waarde die door de parameter offset wordt opgegeven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
| |
RangeError — Als offset groter is dan de lengte van de ByteArray die opgegeven is in bytes of als de hoeveelheid opgegeven gegevens voor schrijven door offset plus length groter is dan de beschikbare gegevens.
|
Verwante API-elementen
writeDouble | () | methode |
public function writeDouble(value:Number):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een IEEE 754 getal met drijvende komma en dubbele precisie naar de socket.
Parameters
value:Number — De waarde die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeFloat | () | methode |
public function writeFloat(value:Number):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een IEEE 754-getal met drijvende komma en enkele precisie naar de socket.
Parameters
value:Number — De waarde die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeInt | () | methode |
public function writeInt(value:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een 32-bits geheel getal met teken naar de socket.
Parameters
value:int — De waarde die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeMultiByte | () | methode |
public function writeMultiByte(value:String, charSet:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een multibyte-tekenreeks vanuit de bytestream met de opgegeven tekenset.
Parameters
value:String — De tekenreekswaarde die moet worden geschreven.
| |
charSet:String — De tekenreeks die de tekenset aangeeft die moet worden gebruikt om de bytes te interpreteren. Mogelijke tekensetreeksen zijn onder andere "shift_jis" , "CN-GB" en "iso-8859-1" . Zie Ondersteunde tekensets voor een complete lijst.
|
Verwante API-elementen
writeObject | () | methode |
public function writeObject(object:*):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een object in AMF-indeling met serienummering naar de socket.
Parameters
object:* — Het object waarop serienummering moet worden toegepast.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeShort | () | methode |
public function writeShort(value:int):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een 16-bits geheel getal naar de socket. De bytes worden als volgt geschreven:
(v >> 8) & 0xff v & 0xff
De lage 16 bits van de parameter worden gebruikt, de hoge 16 bits worden genegeerd.
Parameters
value:int — De waarde die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeUnsignedInt | () | methode |
public function writeUnsignedInt(value:uint):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een 32-bits geheel getal zonder teken naar de socket.
Parameters
value:uint — De waarde die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeUTF | () | methode |
public function writeUTF(value:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft de volgende gegevens naar de socket: een 16-bits geheel getal zonder teken dat de lengte in bytes van de opgegeven UTF-8-tekenreeks aangeeft, gevolgd door de tekenreeks zelf.
Voordat de tekenreeks wordt geschreven, berekent de methode het aantal bytes dat nodig is om alle tekens in de tekenreeks te vertegenwoordigen.
Parameters
value:String — De tekenreeks die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
RangeError — De lengte is groter dan 65535.
| |
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
writeUTFBytes | () | methode |
public function writeUTFBytes(value:String):void
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Schrijft een UTF-8-tekenreeks naar de socket.
Parameters
value:String — De tekenreeks die naar de socket moet worden geschreven.
|
Gegenereerde uitzondering
IOError — Er is een I/O-fout opgetreden bij de socket of de socket is niet geopend.
|
Verwante API-elementen
close | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CLOSE
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer de server de socketverbinding sluit.
De gebeurtenis close
wordt alleen verzonden wanneer de server de verbinding sluit. De gebeurtenis wordt niet verzonden wanneer u de methode Socket.close()
aanroept.
Event.CLOSE
definieert de waarde van de eigenschap type
van een close
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object waarvan de verbinding is gesloten. |
connect | Gebeurtenis |
flash.events.Event
eigenschap Event.type =
flash.events.Event.CONNECT
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een netwerkverbinding tot stand is gebracht.
De constanteEvent.CONNECT
definieert de waarde van de eigenschap type
van een connect
-gebeurtenisobject.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het object Socket of XMLSocket dat een netwerkverbinding tot stand heeft gebracht. |
ioError | Gebeurtenis |
flash.events.IOErrorEvent
eigenschap IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een invoer-/uitvoerfout optreedt die ertoe leidt dat een verzend- of laadbewerking mislukt.
Definieert de waarde van de eigenschaptype
van een gebeurtenisobject ioError
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
errorID | Een referentienummer dat aan de specifieke fout is gekoppeld (alleen AIR). |
target | Het netwerkobject dat de invoer-/uitvoerfout ondervindt. |
text | Tekst die moet worden weergegeven als foutbericht. |
outputProgress | Gebeurtenis |
flash.events.OutputProgressEvent
Wordt verzonden wanneer een socket gegevens verplaatst van de schrijfbuffer naar de netwerktransportlaag.
securityError | Gebeurtenis |
flash.events.SecurityErrorEvent
eigenschap SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een aanroep naar Socket.connect()
verbinding probeert te maken met een server die is verboden door de beveiligingssandbox van de aanroeper of met een poort lager dan 1024 en er geen socketbeleid bestaat voor een dergelijke verbinding.
Opmerking: bij een AIR-toepassing kan inhoud die wordt uitgevoerd in de beveiligingssandbox van de toepassing verbinding maken met elke server en poortnummer zonder socketbeleidsbestand.
De constanteSecurityErrorEvent.SECURITY_ERROR
definieert de waarde van de eigenschap type
van een gebeurtenisobject securityError
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. |
target | Het netwerkobject dat de beveiligingsfout rapporteert. |
text | Tekst die moet worden weergegeven als foutbericht. |
Verwante API-elementen
socketData | Gebeurtenis |
flash.events.ProgressEvent
eigenschap ProgressEvent.type =
flash.events.ProgressEvent.SOCKET_DATA
Taalversie: | ActionScript 3.0 |
Runtimeversies: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wordt verzonden wanneer een socket gegevens heeft ontvangen.
De gegevens die door de socket worden ontvangen, blijven in de socket totdat ze zijn gelezen. U hoeft niet alle beschikbare gegevens te lezen tijdens de handler voor deze gebeurtenis.
Gebeurtenissen van het type socketData
gebruiken de eigenschap ProgressEvent.bytesTotal
niet.
type
van een gebeurtenisobject socketData
.
Deze gebeurtenis heeft de volgende eigenschappen:
Eigenschap | Waarde |
---|---|
bubbles | false |
cancelable | false ; er is geen standaardgedrag om te annuleren. |
currentTarget | Het object dat actief de Event verwerkt. |
bytesLoaded | Het aantal items of bytes dat wordt geladen wanneer de listener de gebeurtenis verwerkt. |
bytesTotal | 0; deze eigenschap wordt niet gebruikt door gebeurtenisobjecten socketData . |
target | De socket die de voortgang rapporteert. |
- De constructor maakt een instantie
CustomSocket
genaamdsocket
en geeft de hostnaamlocalhost
en poort 80 door als argumenten. Aangezien Socket wordt uitgebreid doorCustomSocket
, wordt met een aanroep vansuper()
de constructor van Socket aangeroepen. - In het voorbeeld wordt vervolgens de methode
configureListeners()
aangeroepen, die listeners voor gebeurtenissen Socket toevoegt. - Tot slot wordt de methode
connect()
voor socket aangeroepen metlocalhost
als hostnaam en 80 als poortnummer.
Opmerking: wanneer u het voorbeeld wilt uitvoeren, hebt u een server nodig die wordt uitgevoerd in hetzelfde domein als waarin het SWF-bestand zich bevindt (in het voorbeeld localhost
) en die luistert op poort 80.
package { import flash.display.Sprite; public class SocketExample extends Sprite { private var socket:CustomSocket; public function SocketExample() { socket = 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(); configureListeners(); if (host && port) { super.connect(host, port); } } 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(); } }
Wed Jun 13 2018, 11:42 AM Z