Paketflash.net
Klassepublic class Socket
VererbungSocket Inheritance EventDispatcher Inheritance Object
Implementiert IDataInput, IDataOutput

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Socket-Klasse ermöglicht die Herstellung von Socketverbindungen mit ActionScript-Code sowie das Lesen und Schreiben von unformatierten Binärdaten. Sie ist vergleichbar mit "XMLSocket", schreibt jedoch das Format der empfangenen oder übertragenen Daten nicht vor.

Die Socket-Klasse eignet sich gut für die Arbeit mit Servern, die Binärprotokolle verwenden.

Beachten Sie bei Verwendung dieser Klasse das folgende Sicherheitsmodell von Flash Player:

Weitere Informationen finden Sie in den folgenden Abschnitten:

Beispiele anzeigen

Siehe auch

Socketverbindungen


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  bytesAvailable : uint
[read-only] Die Byteanzahl der zum Lesen verfügbaren Daten im Eingabepuffer.
Socket
  connected : Boolean
[read-only] Gibt an, ob dieses Socket-Objekt zurzeit verbunden ist.
Socket
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  endian : String
Gibt die Bytereihenfolge für die Daten an. Mögliche Werte sind Konstanten der flash.utils.Endian-Klasse, "Endian.BIG_ENDIAN" oder "Endian.LITTLE_ENDIAN".
Socket
  objectEncoding : uint
Steuert die beim Schreiben oder Lesen eines Objekts verwendete AMF-Version.
Socket
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
Öffentliche Methoden
 MethodeDefiniert von
  
Socket(host:String = null, port:int = 0)
Erstellt ein Socket-Objekt.
Socket
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
  
Schließt das Socket.
Socket
  
connect(host:String, port:int):void
Stellt eine Socketverbindung mit dem angegebenen Host und Port her.
Socket
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
Gibt alle Daten im Ausgabepuffer des Sockets aus.
Socket
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
  
Liest einen booleschen Wert aus dem Socket.
Socket
  
Liest ein Byte mit Vorzeichen aus dem Socket.
Socket
  
readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Liest die Anzahl der im Parameter "length" angegebenen Datenbytes aus dem Socket.
Socket
  
Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Socket.
Socket
  
Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Socket.
Socket
  
Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Socket.
Socket
  
readMultiByte(length:uint, charSet:String):String
Liest einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Byte-Stream.
Socket
  
Liest ein Objekt aus dem Socket, das im serialisierten AMF-Format codiert ist.
Socket
  
Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Socket.
Socket
  
Liest ein Byte ohne Vorzeichen aus dem Socket.
Socket
  
Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.
Socket
  
Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.
Socket
  
Liest einen UTF-8-String aus dem Socket.
Socket
  
Liest die mit dem Parameter "length" angegebene Anzahl UTF-8-Byte aus dem Socket und gibt einen String zurück.
Socket
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
  
Schreibt einen booleschen Wert in das Socket.
Socket
  
writeByte(value:int):void
Schreibt ein Byte in das Socket.
Socket
  
writeBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void
Schreibt eine Anzahl an Byte aus dem angegebenen Byte-Array.
Socket
  
Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit in das Socket.
Socket
  
Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit in das Socket.
Socket
  
writeInt(value:int):void
Schreibt eine 32-Bit-Ganzzahl mit Vorzeichen in das Socket.
Socket
  
writeMultiByte(value:String, charSet:String):void
Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Byte-Stream.
Socket
  
writeObject(object:*):void
Schreibt ein Objekt im serialisierten AMF-Format in das Socket.
Socket
  
Schreibt eine 16-Bit-Ganzzahl in das Socket.
Socket
  
Schreibt eine 32-Bit-Ganzzahl ohne Vorzeichen in das Socket.
Socket
  
Schreibt die folgenden Daten in das Socket: Eine 16-Bit-Ganzzahl ohne Vorzeichen, die die Länge des angegebenen UTF-8-Strings in Byte angibt, gefolgt von dem eigentlichen String.
Socket
  
Schreibt einen UTF-8-String in das Socket.
Socket
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
   Wird ausgelöst, wenn der Server die Socketverbindung schließt.Socket
   Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.Socket
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
   Wird beim Auftreten eines Eingabe/Ausgabe-Fehlers ausgelöst, durch den ein Sende- oder Ladevorgang fehlschlägt.Socket
   Wird ausgelöst, wenn mit einem Aufruf von Socket.connect() versucht wird, eine Verbindung zu einem Server außerhalb der Sicherheits-Sandbox des Aufrufers oder zu einem Port mit einer niedrigeren Nummer als 1024 herzustellen.Socket
   Wird ausgelöst, wenn ein Socket Daten empfangen hat.Socket
Eigenschaftsdetail
bytesAvailableEigenschaft
bytesAvailable:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Byteanzahl der zum Lesen verfügbaren Daten im Eingabepuffer.

In Ihrem Code muss bytesAvailable aufgerufen werden, um sicherzustellen, dass genügend Daten verfügbar sind, bevor diese mit einer der read-Methoden gelesen werden.


Implementierung
    public function get bytesAvailable():uint
connectedEigenschaft 
connected:Boolean  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob dieses Socket-Objekt zurzeit verbunden ist. Beim Aufruf dieser Eigenschaft wird der Wert true zurückgegeben, wenn das Socket verbunden ist, oder andernfalls false.


Implementierung
    public function get connected():Boolean
endianEigenschaft 
endian:String  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt die Bytereihenfolge für die Daten an. Mögliche Werte sind Konstanten der flash.utils.Endian-Klasse, Endian.BIG_ENDIAN oder Endian.LITTLE_ENDIAN.

Der Standardwert lautet Endian.BIG_ENDIAN.


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

Siehe auch

objectEncodingEigenschaft 
objectEncoding:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Steuert die beim Schreiben oder Lesen eines Objekts verwendete AMF-Version.


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

Siehe auch

Konstruktordetail
Socket()Konstruktor
public function Socket(host:String = null, port:int = 0)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt ein Socket-Objekt. Wenn keine Parameter angegeben werden, wird ein Socket mit getrennter Verbindung erstellt. Wenn Parameter angegeben werden, wird versucht, eine Verbindung zu dem angegebenen Host und Port herzustellen.

Parameter
host:String (default = null) — Der Hostname für die herzustellende Verbindung. Wenn dieser Parameter nicht angegeben wird, wird ein Socket mit getrennter Verbindung erstellt.
 
port:int (default = 0) — Die Portnummer für die herzustellende Verbindung. Wenn dieser Parameter nicht angegeben wird, wird ein Socket mit getrennter Verbindung erstellt.

Ereignisse
connect:Event — Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.
 
ioError:IOErrorEvent — Wird beim Auftreten eines Eingabe/Ausgabe-Fehlers ausgelöst, durch den die Verbindung fehlschlägt.
 
securityError:SecurityErrorEvent — Wird ausgelöst, wenn mit einem Aufruf von "Socket.connect()" versucht wird, eine Verbindung zu einem Server außerhalb der Sicherheits-Sandbox des Aufrufers oder zu einem Port mit einer niedrigeren Nummer als 1024 herzustellen. In beiden Fällen können Sie das Problem umgehen, indem Sie eine domänenübergreifende Richtliniendatei auf dem Server verwenden. Weitere Informationen zu Richtliniendateien für Sockets finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" im Handbuch Programmieren mit ActionScript 3.

Auslöser
SecurityError — Dieser Fehler kann folgende Ursachen haben:
  • Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können dies umgehen, indem Sie die entsprechende SWF-Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.
  • Sie können für eine Socketverbindung keinen Port mit einer höheren Nummer als 65535 angeben.
Methodendetail
close()Methode
public function close():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schließt das Socket. Nach dem Aufruf der Methode close() können keine Daten mehr gelesen oder geschrieben werden.

Das Ereignis close wird nur ausgelöst, wenn der Server die Verbindung schließt. Es wird nicht ausgelöst, wenn Sie die Methode close() aufrufen.

Sie können das Socket-Objekt wieder verwenden, indem Sie die Methode connect() erneut aufrufen.


Auslöser
IOError — Das Socket konnte nicht geschlossen werden, oder das Socket war nicht geöffnet.
connect()Methode 
public function connect(host:String, port:int):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Stellt eine Socketverbindung mit dem angegebenen Host und Port her. Wenn die Verbindung unmittelbar fehlschlägt, wird ein Ereignis oder ein Ausnahmefehler ausgelöst: Ein Fehlerereignis wird ausgelöst, wenn ein Host angegeben wurde, ein Ausnahmefehler wird ausgelöst, wenn kein Host angegeben wurde. Andernfalls wird der Verbindungsstatus durch ein Ereignis ausgegeben. Wenn bereits eine Socketverbindung besteht, wird die vorhandene Verbindung zunächst geschlossen.

Parameter

host:String — Der Hostname für die herzustellende Verbindung. Wenn kein Host angegeben wurde, wird der Host der aufrufenden SWF-Datei verwendet. Verwenden Sie in diesem Fall einen Ereignis-Listener, um zu ermitteln, ob die Verbindung erfolgreich hergestellt werden konnte.
 
port:int — Die Portnummer für die herzustellende Verbindung.


Ereignisse
connect:Event — Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.
 
ioError:IOErrorEvent — Wird ausgelöst, wenn ein Host angegeben wurde und ein Eingabe/Ausgabe-Fehler auftritt, durch den die Verbindung fehlschlägt.
 
securityError:SecurityErrorEvent — Wird ausgelöst, wenn mit einem Aufruf von "Socket.connect()" versucht wird, eine Verbindung zu einem Server außerhalb der Sicherheits-Sandbox des Aufrufers oder zu einem Port mit einer niedrigeren Nummer als 1024 herzustellen. In beiden Fällen können Sie das Problem umgehen, indem Sie eine domänenübergreifende Richtliniendatei auf dem Server verwenden. Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.

Auslöser
IOError — Es wurde kein Host angegeben, und die Verbindung konnte nicht erstellt werden.
 
SecurityError — Dieser Fehler kann folgende Ursachen haben:
  • Über lokale nicht vertrauenswürdige SWF-Dateien kann keine Verbindung mit dem Internet hergestellt werden. Sie können dies umgehen, indem Sie die entsprechende SWF-Datei als lokal mit Netzwerkzugang oder als vertrauenswürdig klassifizieren.
  • Sie können für eine Socketverbindung keinen Port mit einer höheren Nummer als 65535 angeben.
  • In der HTML-Seite mit dem SWF-Inhalt ist der Parameter allowNetworking der Tags object und embed auf none gesetzt.

Siehe auch

flush()Methode 
public function flush():void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt alle Daten im Ausgabepuffer des Sockets aus. Die mit write-Methoden geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readBoolean()Methode 
public function readBoolean():Boolean

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest einen booleschen Wert aus dem Socket. Nach dem Lesen eines einzelnen Byte gibt die Methode true zurück, wenn das Byte ungleich null ist, andernfalls false.

Rückgabewerte
Boolean — Der Wert ist true, wenn das Byte ungleich 0 ist, oder andernfalls false.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readByte()Methode 
public function readByte():int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest ein Byte mit Vorzeichen aus dem Socket.

Rückgabewerte
int — Ein Wert im Bereich von -128 bis 127.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readBytes()Methode 
public function readBytes(bytes:ByteArray, offset:uint = 0, length:uint = 0):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest die Anzahl der im Parameter length angegebenen Datenbyte aus dem Socket. Die Byte werden in das angegebene Byte-Array gelesen, wobei an der mit offset angegebenen Position begonnen wird.

Parameter

bytes:ByteArray — Das ByteArray-Objekt, in das die Daten gelesen werden.
 
offset:uint (default = 0) — Der Offset im Byte-Array, ab dem das Lesen der Daten beginnt.
 
length:uint (default = 0) — Die Anzahl der zu lesenden Byte. Der Standardwert 0 bewirkt, dass alle verfügbaren Daten gelesen werden.


Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readDouble()Methode 
public function readDouble():Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit aus dem Socket.

Rückgabewerte
Number

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readFloat()Methode 
public function readFloat():Number

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit aus dem Socket.

Rückgabewerte
Number

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readInt()Methode 
public function readInt():int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine 32-Bit-Ganzzahl mit Vorzeichen aus dem Socket.

Rückgabewerte
int — Ein Wert im Bereich von -2147483648 bis 2147483647.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readMultiByte()Methode 
public function readMultiByte(length:uint, charSet:String):String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Byte-Stream.

Parameter

length:uint — Die Anzahl der aus dem Byte-Stream zu lesenden Byte.
 
charSet:String — Der String, der den zum Interpretieren der Byte zu verwendenden Zeichensatz angibt. Mögliche Zeichensatz-Strings sind u. a. "shift_jis", "CN-GB" und "iso-8859-1". Eine vollständige Liste finden Sie unter Unterstützte Zeichensätze.

Hinweis: Wird der Wert des Parameters charSet von dem aktuellen System nicht erkannt, verwendet Flash Player die Standard-Codepage des Systems als Zeichensatz. Beispielsweise kann ein Wert des Parameters charSet wie bei myTest.readMultiByte(22, "iso-8859-01"), wo 01 anstelle von 1 eingesetzt wird, auf Ihrem Entwicklungsrechner funktionieren, aber auf keinem anderen Rechner. Auf anderen Rechnern greift Flash Player auf die Standard-Codepage des Systems zurück.

Rückgabewerte
String — Ein UTF-8-codierter String.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
readObject()Methode 
public function readObject():*

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest ein Objekt aus dem Socket, das im serialisierten AMF-Format codiert ist.

Rückgabewerte
* — Das deserialisierte Objekt.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

readShort()Methode 
public function readShort():int

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Socket.

Rückgabewerte
int — Ein Wert im Bereich von -32768 bis 32767.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readUnsignedByte()Methode 
public function readUnsignedByte():uint

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest ein Byte ohne Vorzeichen aus dem Socket.

Rückgabewerte
uint — Ein Wert im Bereich von 0 bis 255.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readUnsignedInt()Methode 
public function readUnsignedInt():uint

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.

Rückgabewerte
uint — Ein Wert im Bereich von 0 bis 4294967295.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readUnsignedShort()Methode 
public function readUnsignedShort():uint

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest eine 16-Bit-Ganzzahl ohne Vorzeichen aus dem Socket.

Rückgabewerte
uint — Ein Wert im Bereich von 0 bis 65535.

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readUTF()Methode 
public function readUTF():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest einen UTF-8-String aus dem Socket. Es wird davon ausgegangen, dass dem String eine short-Ganzzahl ohne Vorzeichen mit der Länge in Byte vorangestellt ist.

Rückgabewerte
String

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
readUTFBytes()Methode 
public function readUTFBytes(length:uint):String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Liest die mit dem Parameter length angegebene Anzahl UTF-8-Byte aus dem Socket und gibt einen String zurück.

Parameter

length:uint — Die Anzahl der zu lesenden Byte.

Rückgabewerte
String

Auslöser
EOFError — Es sind nicht genügend zu lesende Daten vorhanden.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.
writeBoolean()Methode 
public function writeBoolean(value:Boolean):void

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt einen booleschen Wert in das Socket. Mit dieser Methode wird ein einzelnes Byte mit dem Wert 1 (true) oder 0 (false) geschrieben.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:Boolean — Der Wert, der in das Socket geschrieben werden soll: 1 (true ) oder 0 ( false ).


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt ein Byte in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:int — Der Wert, der in das Socket geschrieben werden soll. Die unteren 8 Bit des Werts werden verwendet, die oberen 24 Bit werden ignoriert.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine Anzahl an Byte aus dem angegebenen Byte-Array. Der Schreibvorgang beginnt an der mit offset angegebenen Position.

Wenn Sie den Parameter length nicht angeben, wird der Standardwert 0 verwendet, sodass alle Daten beginnend ab der mit offset festgelegten Position geschrieben werden.

Wenn Sie auch den Parameter offset nicht angeben, wird der gesamte Pufferinhalt geschrieben.

Wenn sich offset bzw. length außerhalb des gültigen Bereichs befinden, werden sie auf den Anfang bzw. auf das Ende des byte-Arrays gesetzt.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

bytes:ByteArray — Das ByteArray-Objekt, aus dem die Daten gelesen werden.
 
offset:uint (default = 0) — Der auf null basierende Offset im ByteArray-Objekt bytes, ab dem der Schreibvorgang beginnt.
 
length:uint (default = 0) — Die Anzahl der zu schreibenden Byte. Beim Standardwert 0 wird der gesamte Pufferinhalt ab dem durch den Parameter offset angegebenen Byte geschrieben.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:Number — Der Wert, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:Number — Der Wert, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine 32-Bit-Ganzzahl mit Vorzeichen in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:int — Der Wert, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Byte-Stream.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:String — Der String-Wert, der geschrieben werden soll.
 
charSet:String — Der String, der den zum Interpretieren der Byte zu verwendenden Zeichensatz angibt. Mögliche Zeichensatz-Strings sind u. a. "shift_jis", "CN-GB" und "iso-8859-1". Eine vollständige Liste finden Sie unter Unterstützte Zeichensätze.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt ein Objekt im serialisierten AMF-Format in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

object:* — Das zu serialisierende Objekt


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine 16-Bit-Ganzzahl in das Socket. Die Bytes werden wie folgt geschrieben:

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

Die unteren 16 Bit des Parameters werden verwendet, die oberen 16 Bit werden ignoriert.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:int — Der Wert, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt eine 32-Bit-Ganzzahl ohne Vorzeichen in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:uint — Der Wert, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt die folgenden Daten in das Socket: Eine 16-Bit-Ganzzahl ohne Vorzeichen, die die Länge des angegebenen UTF-8-Strings in Byte angibt, gefolgt von dem eigentlichen String.

Vor dem Schreiben des Strings berechnet die Methode, wie viele Byte zur Darstellung aller Zeichen des Strings erforderlich sind.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:String — Der String, der in das Socket geschrieben werden soll.


Auslöser
RangeError — Die Länge überschreitet 65535.
 
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

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

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Schreibt einen UTF-8-String in das Socket.

Hinweis: Die mit dieser Methode geschriebenen Daten werden nicht unmittelbar übertragen, sondern verbleiben in der Warteschlange, bis die Methode flush() aufgerufen wird.

Parameter

value:String — Der String, der in das Socket geschrieben werden soll.


Auslöser
IOError — Ein E/A-Fehler ist im Socket aufgetreten, oder das Socket ist nicht geöffnet.

Siehe auch

Ereignisdetail
close Ereignis
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.CLOSE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn der Server die Socketverbindung schließt. Das Ereignis close wird nur ausgelöst, wenn der Server die Verbindung schließt. Es wird nicht ausgelöst, wenn Sie die Methode Socket.close() aufrufen.

Definiert den Wert der Eigenschaft type eines close-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, dessen Verbindung geschlossen wurde.
connect Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.CONNECT

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.

Definiert den Wert der Eigenschaft type eines connect-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Socket- oder XMLSocket-Objekt, das eine Netzwerkverbindung hergestellt hat.
ioError Ereignis  
Ereignisobjekttyp: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird beim Auftreten eines Eingabe/Ausgabe-Fehlers ausgelöst, durch den ein Sende- oder Ladevorgang fehlschlägt.

Definiert den Wert der Eigenschaft type eines ioError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt.
textDer als Fehlermeldung anzuzeigende Text.
securityError Ereignis  
Ereignisobjekttyp: flash.events.SecurityErrorEvent
SecurityErrorEvent.type property = flash.events.SecurityErrorEvent.SECURITY_ERROR

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn mit einem Aufruf von Socket.connect() versucht wird, eine Verbindung zu einem Server außerhalb der Sicherheits-Sandbox des Aufrufers oder zu einem Port mit einer niedrigeren Nummer als 1024 herzustellen.

Die Konstante SecurityErrorEvent.SECURITY_ERROR definiert den Wert der type-Eigenschaft eines securityError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, das den Sicherheitsfehler ausgibt.
textDer als Fehlermeldung anzuzeigende Text.

Siehe auch

socketData Ereignis  
Ereignisobjekttyp: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.SOCKET_DATA

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn ein Socket Daten empfangen hat. Für Ereignisse vom Typ socketData wird die Eigenschaft ProgressEvent.bytesTotal nicht verwendet.

Definiert den Wert der Eigenschaft type eines socketData-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, das das Ereignis aktiv verarbeitet.
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotal0. Diese Eigenschaft wird von socketData-Ereignisobjekten nicht verwendet.
targetDer Protokollierungsstatus des Socketobjekts.
Beispiele Verwendung von Beispielen
SocketExample.as

Im folgenden Beispiel werden Socket-Daten gelesen und geschrieben sowie die bei Socket-Ereignissen übertragenen Informationen ausgegeben. Wichtige Beispielauszüge:
  1. Der Konstruktor erstellt eine CustomSocket-Instanz mit dem Namen socket und übergibt den Hostnamen localhost und Port 80 als Argumente. Da es sich bei CustomSocket um eine Erweiterung von "Socket" handelt, wird der Socket-Konstruktor durch einen Aufruf von super() mit localhost als Hostname und 80 als Portnummer aufgerufen.
  2. Danach wird die Methode configureListeners() aufgerufen, die Listener für Socket-Ereignisse hinzufügt.

Hinweis: Zur Ausführung des Beispiels muss in der Domäne, in der sich die SWF-Datei befindet (in diesem Beispiel localhost), ein Server ausgeführt werden, der Port 80 überwacht.


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();
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/Socket.html