Paket | flash.net |
Klasse | public class SecureSocket |
Vererbung | SecureSocket Socket EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf allen Geräten mit AIR für TV. Auf mobilen Geräten wird es unter Android und iOS, angefangen bei AIR 20 unterstützt. Mit der SecureSocket.isSupported
-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum API-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Die SSL/TLS-Protokolle stellen einen Mechanismus bereit, um beide Aspekte einer sicheren Socketverbindung zu verarbeiten:
- Verschlüsselung der Datenkommunikation, die über das Socket läuft
- Authentifizierung der Hostidentität anhand dessen Zertifikats
Die unterstützten Verschlüsselungsprotokolle sind SSL 3.1 und höher sowie TLS 1.0 und höher. (TLS ist das Nachfolgerprotokoll von SSL. TLS 1.0 entspricht SSL 3.1, TLS 1.1 entspricht SSL 3.2 usw.) SSL-Versionen 3.0 oder niedriger werden nicht unterstützt.
Die Validierung des Serverzertifikats wird mithilfe des Vertrauensspeichers und der Zertifikatvalidierungsunterstützung der Clientplattform ausgeführt. Darüber hinaus können Sie Ihre eigenen Zertifikate programmatisch mit der addBinaryChainBuildingCertificate()
-Methode hinzufügen. Diese API wird derzeit nicht auf iOS unterstützt. Bei der Verwendung dieser API auf iOS wurde eine Ausnahme auftreten: ArgumentError: Error #2004
Die SecureSocket-Klasse stellt nur zu Servern mit gültigen, vertrauenswürdigen Zertifikaten eine Verbindung her. Wenn es ein Problem mit dem Zertifikat eines Servers gibt, können Sie keine Verbindung zu diesem Server herstellen. Es ist zum Beispiel nicht möglich, eine Verbindung zu einem Server herzustellen, dessen Zertifikat abgelaufen ist. Dasselbe gilt für ein Zertifikat, das nicht mit einem vertrauenswürdigen Ankerzertifikat verkettet ist. Die Verbindung wird nicht hergestellt, selbst wenn das Zertifikat ansonsten gültig ist.
Die SecureSocket-Klasse ist für die verschlüsselte Kommunikation mit einem vertrauenswürdigen Server hilfreich. Ansonsten verhält sich ein SecureSocket-Objekt wie ein normales Socket-Objekt.
Um die SecureSocket-Klasse zu verwenden, erstellen Sie ein SecureSocket-Objekt (new SecureSocket()
). Als Nächstes richten Sie Ihre Listener ein und führen dann SecureSocket.connect(host, port)
aus. Nachdem Sie die Verbindung zum Server erfolgreich hergestellt haben, setzt das Socket ein connect
-Ereignis ab. Eine Verbindung ist dann erfolgreich, wenn die Sicherheitsprotokolle des Servers unterstützt werden und seine Zertifikate gültig und vertrauenswürdig sind. Wenn das Zertifikat nicht validiert werden kann, setzt der Socket ein IOError
-Ereignis ab.
Wichtig: Das Online Certificate Status Protocol (OCSP) wird nicht von allen Betriebssystemen unterstützt. Benutzer können die OCSP-Überprüfung auf einzelnen Computern deaktivieren. Wenn OCSP nicht unterstützt wird oder deaktiviert ist und ein Zertifikat nicht die erforderlichen Informationen zur Überprüfung der Zertifikatsperrung anhand einer Zertifikatsperrliste (Certificate Revocation List, CRL) enthält, wird die Zertifikatsperrung nicht überprüft. Wenn das Zertifikat ansonsten gültig ist, wird es akzeptiert. Dieses Szenario lässt es zu, dass ein Server ein gesperrtes Zertifikat verwendet.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
bytesAvailable : uint [schreibgeschützt]
Die Byteanzahl der zum Lesen verfügbaren Daten im Eingabepuffer. | Socket | ||
bytesPending : uint [schreibgeschützt]
Gibt die Anzahl der im Schreibpuffer verbleibenden Bytes an. | Socket | ||
connected : Boolean [schreibgeschützt]
Gibt an, ob dieses Socket-Objekt zurzeit verbunden ist. | Socket | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
endian : String
Gibt die Byte-Reihenfolge der Daten an. | Socket | ||
isSupported : Boolean [statisch] [schreibgeschützt]
Gibt an, ob sichere Sockets vom aktuellen System unterstützt werden. | SecureSocket | ||
localAddress : String [schreibgeschützt]
Die IP-Adresse, an die dieser Socket auf dem lokalen Computer gebunden ist. | Socket | ||
localPort : int [schreibgeschützt]
Der Port, an den dieser Socket auf dem lokalen Computer gebunden ist. | Socket | ||
objectEncoding : uint
Steuert die beim Schreiben oder Lesen eines Objekts verwendete AMF-Version. | Socket | ||
remoteAddress : String [schreibgeschützt]
Die IP-Adresse des Remotecomputers, mit der dieser Socket verbunden ist. | Socket | ||
remotePort : int [schreibgeschützt]
Der Port des Remotecomputers, mit dem dieser Socket verbunden ist. | Socket | ||
serverCertificate : X509Certificate [schreibgeschützt]
Enthält das X.509-Zertifikat, das vom Server bezogen wurde, nachdem eine sichere SSL/TLS-Verbindung hergestellt wurde. | SecureSocket | ||
serverCertificateStatus : String [schreibgeschützt]
Gibt den Status des Serverzertifikats zurück. | SecureSocket | ||
timeout : uint
Gibt die Anzahl der Millisekunden an, die auf eine Verbindung gewartet werden soll. | Socket |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein neues SecureSocket-Objekt. | SecureSocket | ||
Fügt der lokalen Zertifikatkette, die Ihr System zum Überprüfen des Serverzertifikats verwendet, ein X.509-Zertifikat hinzu. | SecureSocket | ||
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 den Socket. | Socket | ||
[override]
Verbindet den Socket über SSL oder TLS mit dem angegebenen Host und Port. | SecureSocket | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Gibt alle Daten im Ausgabepuffer des Sockets aus. | Socket | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
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 | ||
Liest die Anzahl der im Parameter „length“ angegebenen Datenbyte 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 | ||
Liest einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Bytestream. | Socket | ||
readObject():*
Liest ein Objekt aus dem Socket, das im serialisierten AMF-Format kodiert 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 | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | ||
Schreibt einen booleschen Wert in den Socket. | Socket | ||
Schreibt ein Byte in den Socket. | Socket | ||
Schreibt eine Anzahl an Byte aus dem angegebenen Bytearray. | Socket | ||
Schreibt eine Gleitkommazahl nach IEEE 754 mit doppelter Genauigkeit in den Socket. | Socket | ||
Schreibt eine Gleitkommazahl nach IEEE 754 mit einfacher Genauigkeit in den Socket. | Socket | ||
Schreibt eine 32-Bit-Ganzzahl mit Vorzeichen in den Socket. | Socket | ||
Schreibt einen Multibyte-String unter Verwendung des angegebenen Zeichensatzes aus dem Bytestream. | Socket | ||
Schreibt ein Objekt im serialisierten AMF-Format in den Socket. | Socket | ||
Schreibt eine 16-Bit-Ganzzahl in den Socket. | Socket | ||
Schreibt eine 32-Bit-Ganzzahl ohne Vorzeichen in den Socket. | Socket | ||
Schreibt die folgenden Daten in den 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 den Socket. | Socket |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Wird ausgelöst, wenn der Server die Socketverbindung schließt. | SecureSocket | |||
Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde. | SecureSocket | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den ein Sende- oder Empfangsvorgang fehlschlägt. | SecureSocket | |||
Wird abgesetzt, wenn ein Socket Daten aus seinem Schreibpuffer auf die Netzwerktransportebene verschiebt | Socket | |||
Wird abgesetzt, wenn ein Aufruf von SecureSocket.connect() aufgrund einer Sicherheitsbeschränkung fehlschlägt. | SecureSocket | |||
Wird ausgelöst, wenn ein Socket Daten empfangen hat. | SecureSocket |
isSupported | Eigenschaft |
isSupported:Boolean
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Gibt an, ob sichere Sockets vom aktuellen System unterstützt werden.
Sichere Sockets werden nicht auf allen Plattformen unterstützt. Überprüfen Sie diese Eigenschaft, bevor Sie versuchen, eine SecureSocket-Instanz zu erstellen.
Implementierung
public static function get isSupported():Boolean
serverCertificate | Eigenschaft |
serverCertificate:X509Certificate
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Enthält das X.509-Zertifikat, das vom Server bezogen wurde, nachdem eine sichere SSL/TLS-Verbindung hergestellt wurde. Wenn keine sichere Verbindung hergestellt wird, wird diese Eigenschaft auf null
gesetzt. Derzeit wird sie jedoch nicht unter iOS unterstützt. Daher ist sie auf null
für iOS festgelegt.
Weitere Informationen zu X.509-Zertifikaten finden Sie unter RFC2459.
Implementierung
public function get serverCertificate():X509Certificate
serverCertificateStatus | Eigenschaft |
serverCertificateStatus:String
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Gibt den Status des Serverzertifikats zurück.
Der Status ist CertificateStatus.UNKNOWN
, bis der Socket versucht, eine Verbindung zu einem Server herzustellen. Nach der Validierung wird als Status einer der von der CertificateStatus-Klasse aufgezählten Strings angegeben. Die Verbindung wird nur dann erfolgreich hergestellt, wenn das Zertifikat gültig und vertrauenswürdig ist. Deshalb ist nach einem connect
-Ereignis der Wert von serverCertificateStatus
immer trusted
.
Hinweis: Nachdem das Zertifikat erfolgreich validiert oder abgelehnt wurde, wird der Status bis zum nächsten Aufruf der connect()
-Methode nicht mehr aktualisiert. Durch den Aufruf von close()
wird der Status nicht auf „unknown“ (unbekannt) zurückgesetzt.
Implementierung
public function get serverCertificateStatus():String
Verwandte API-Elemente
SecureSocket | () | Konstruktor |
public function SecureSocket()
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Erstellt ein neues SecureSocket-Objekt.
Überprüfen Sie SecureSocket.isSupported
, bevor Sie versuchen, eine SecureSocket-Instanz zu erstellen. Wenn SSL 3.0- oder TLS 1.0-Sockets nicht unterstützt werden, gibt die Laufzeitumgebung einen IllegalOperationError aus.
Auslöser
IllegalOperationError — Wenn SSL Version 3.0 (und höher) oder TLS Version 1.0 (und höher) nicht unterstützt wird.
| |
SecurityError — Ü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.
|
addBinaryChainBuildingCertificate | () | Methode |
public function addBinaryChainBuildingCertificate(certificate:ByteArray, trusted:Boolean):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 3 |
Fügt der lokalen Zertifikatkette, die Ihr System zum Überprüfen des Serverzertifikats verwendet, ein X.509-Zertifikat hinzu. Das Zertifikat ist zeitlich befristet und gilt für die Dauer der Sitzung.
Die Überprüfung des Serverzertifikats beruht auf dem Vertrauensspeicher Ihres Systems zur Zertifikatverkettung und -überprüfung. Verwenden Sie diese Methode, um Zertifikatketten und vertrauenswürdige Anker programmgesteuert hinzuzufügen.
Unter Mac OS ist das Schlüsselbund des Systems das standardmäßige Schlüsselbund, das beim SSL/TLS-Handshakeprozess verwendet wird. Alle Zwischenzertifikate in diesem Schlüsselbund werden beim Erstellen der Zertifikatkette einbezogen.
Das Zertifikat, das Sie mit dieser API hinzufügen, muss ein DER-kodiertes X.509-Zertifikat sein. Wenn der trusted
-Parameter den Wert „true“ hat, gilt das Zertifikat, das Sie mit dieser API hinzufügen, als vertrauenswürdiger Anker.
Weitere Informationen zu X.509-Zertifikaten finden Sie unter RFC2459.
Parameter
certificate:ByteArray — Ein ByteArray-Objekt, das ein digitales DER-kodiertes X.509-Zertifikat enthält.
| |
trusted:Boolean — Setzen Sie es auf true, um dieses Zertifikat als Vertrauensanker festzulegen.
|
Auslöser
ArgumentError — Wenn das Zertifikat nicht hinzugefügt werden kann.
|
connect | () | Methode |
override public function connect(host:String, port:int):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Verbindet den Socket über SSL oder TLS mit dem angegebenen Host und Port.
Wenn Sie die SecureSocket.connect()
-Methode aufrufen, probiert das Socket, den SSL/TLS-Handshake mit dem Server auszuführen. Wenn der Handshake erfolgreich ist, versucht das Socket, das Serverzertifikat zu überprüfen. Wenn das Zertifikat gültig und vertrauenswürdig ist, wird die sichere Socketverbindung eingerichtet und das Socket setzt ein connect
-Ereignis ab. Wenn der Handshake fehlschlägt oder das Zertifikat nicht validiert werden kann, setzt der Socket ein IOError
-Ereignis ab. Sie können das Ergebnis der Zertifikatvalidierung überprüfen, indem Sie die serverCertificateStatus
-Eigenschaft lesen, nachdem das IOError
-Ereignis abgesetzt wurde. (Wenn ein connect
-Ereignis abgesetzt wird, ist der Zertifikatstatus immer trusted
.)
Wenn bereits eine Socketverbindung besteht, wird die vorhandene Verbindung zunächst geschlossen.
Parameter
host:String — Der Name oder die IP-Adresse des Hosts, zu dem eine Verbindung hergestellt werden soll.
| |
port:int — Die Portnummer für die herzustellende Verbindung.
|
Ereignisse
connect: — Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.
| |
ioError: — Wird ausgelöst, wenn ein Host angegeben wurde und ein I/O-Fehler auftritt, durch den die Verbindung fehlschlägt. Dies schließt SSL/TLS-Handshake-Fehler sowie das Fehlschlagen der Validierung des Hostserverzertifikats ein.
| |
securityError: — Wird ausgelöst, wenn beim Aufrufen von Socket.connect() versucht wird, eine Verbindung zu einem Server herzustellen, der keine Socket-Richtliniendatei bereitstellt, bzw. zu einem Server, dessen Richtliniendatei dem aufrufenden Host keinen Zugriff auf den angegebenen Port gewährt. Weitere Informationen zu Richtliniendateien finden Sie unter „Websitesteuerungen (Richtliniendateien)“ im ActionScript 3.0 Entwicklerhandbuch und im Flash Player Developer Center im Artikel: Sicherheit.
|
Auslöser
IOError — Wenn Sie keinen Host angeben und die Verbindung fehlschlägt.
| |
SecurityError — Wenn Sie einen Socketport unter 0 oder über 65535 angeben.
|
close | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.CLOSE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
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.
Event.CLOSE
-Konstante definiert den Wert der type
-Eigenschaft 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. |
connect | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.CONNECT
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Wird ausgelöst, wenn eine Netzwerkverbindung hergestellt wurde.
DieEvent.CONNECT
-Konstante definiert den Wert der type
-Eigenschaft 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. |
ioError | Ereignis |
flash.events.IOErrorEvent
Eigenschaft IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den ein Sende- oder Empfangsvorgang fehlschlägt.
Wenn ein Serverzertifikat nicht validiert werden kann, ist das abgesetzte Fehlerereignis ein IOError. In diesem Fall können Sie die serverCertificateStatus
-Eigenschaft überprüfen, um die Ursache des Problems zu ermitteln.
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. |
errorID | Die Referenznummer des spezifischen Fehlers (nur AIR). |
target | Das Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt. |
text | Der als Fehlermeldung anzuzeigende Text. |
securityError | Ereignis |
flash.events.SecurityErrorEvent
Eigenschaft SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Wird abgesetzt, wenn ein Aufruf von SecureSocket.connect()
aufgrund einer Sicherheitsbeschränkung fehlschlägt.
Ein Sicherheitsfehler-Ereignis wird abgesetzt, wenn Code, der in Flash Player oder in AIR außerhalb der Sicherheitssandbox der Anwendung ausgeführt wird, versucht, eine Verbindung zu einem Server in einer anderen Domäne oder zu einem Port unter 1024 herzustellen und der Server keine Richtliniendatei bereitstellt, die diese Verbindung zulässt. Beachten Sie, dass Code, der innerhalb der AIR-Sicherheitssandbox ausgeführt wird, eine Verbindung zu einem Server in jeder beliebigen Domäne und zu Ports unter 1024 herstellen kann, ohne dass eine Richtliniendatei erforderlich ist.
Die KonstanteSecurityErrorEvent.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. |
Verwandte API-Elemente
socketData | Ereignis |
flash.events.ProgressEvent
Eigenschaft ProgressEvent.type =
flash.events.ProgressEvent.SOCKET_DATA
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | Flash Player 11, AIR 2 |
Wird ausgelöst, wenn ein Socket Daten empfangen hat. Für Ereignisse vom Typ socketData
wird die Eigenschaft ProgressEvent.bytesTotal
nicht verwendet.
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 Socket, dessen Fortschritt protokolliert wird. |
package { import flash.display.Sprite; import flash.errors.IOError; import flash.events.Event; import flash.events.IOErrorEvent; import flash.net.SecureSocket; public class SecureSocketExample extends Sprite { private var secureSocket:SecureSocket = new SecureSocket(); public function SecureSocketExample() { secureSocket.addEventListener( Event.CONNECT, onConnect ) secureSocket.addEventListener( IOErrorEvent.IO_ERROR, onError ); try { secureSocket.connect( "208.77.188.166", 443 ); } catch ( error:Error ) { trace ( error.toString() ); } } private function onConnect( event:Event ):void { trace("Connected."); } private function onError( error:IOErrorEvent ):void { trace( error.text + ", " + secureSocket.serverCertificateStatus ); } } }
Tue Jun 12 2018, 10:04 AM Z