| 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:
- Befindet sich die aufrufende SWF-Datei in der lokalen Sandbox des Dateisystems und die Zieldatei in einer Netzwerk-Sandbox, so ist das Laden von Daten nicht zulässig.
- Das Laden von Daten ist auch dann nicht zulässig, wenn die aufrufende SWF-Datei von einer Netzwerk-Sandbox und die Zielressource aus einer lokalen Quelle stammt.
- Die aufrufende SWF-Datei und die Netzwerkressource, auf die zugegriffen wird, müssen sich in exakt derselben Domäne befinden. Beispiel: Eine SWF-Datei unter adobe.com kann nur eine Verbindung zu einem Serverdaemon herstellen, der sich ebenfalls unter adobe.com befindet.
- Mit einer domänenübergreifenden Richtliniendatei kann auf Websites der domänenübergreifende Zugriff auf eine Ressource gestattet werden.
Weitere Informationen finden Sie in den folgenden Abschnitten:
Beispiele anzeigen
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
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
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
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
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.
|
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.
|
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
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.
|
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.
|
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.
|
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.
|
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
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.
|
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
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.
|
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.
|
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.
|
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
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.
|
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.
|
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.
|
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.
|
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
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.
|
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
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.
|
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
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
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
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
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
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
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
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
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
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
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
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
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:
| Eigenschaft | Wert |
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, dessen Verbindung geschlossen wurde. |
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:
| Eigenschaft | Wert |
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Socket- oder XMLSocket-Objekt, das eine Netzwerkverbindung hergestellt hat. |
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:
| Eigenschaft | Wert |
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
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:
| Eigenschaft | Wert |
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, das den Sicherheitsfehler ausgibt. |
text | Der als Fehlermeldung anzuzeigende Text. |
Siehe auch
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:
| Eigenschaft | Wert |
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, das das Ereignis aktiv verarbeitet. |
bytesLoaded | Die Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet. |
bytesTotal | 0. Diese Eigenschaft wird von socketData-Ereignisobjekten nicht verwendet. |
target | Der Protokollierungsstatus des Socketobjekts. |
Im folgenden Beispiel werden Socket-Daten gelesen und geschrieben sowie die bei Socket-Ereignissen übertragenen Informationen ausgegeben. Wichtige Beispielauszüge:
- 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.
- 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();
}
}
© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Fri Oct 12 2007, 2:03 AM GMT-07:00
Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/net/Socket.html