ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
air.net 

SocketMonitor  - AS3

Paketair.net
Klassepublic class SocketMonitor
VererbungSocketMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object
Unterklassen SecureSocketMonitor

Laufzeitversionen: AIR 1.0

Ein SocketMonitor-Objekt überwacht die Verfügbarkeit eines TCP-Endpunkts.

Diese Klasse ist in der Datei „aircore.swc“ enthalten. Flash Builder lädt diese Klasse automatisch, wenn Sie ein Projekt für AIR erstellen. Das Flex SDK enthält ebenfalls die Datei „aircore.swc“, die Sie beim Kompilieren der Anwendung einschließen sollten, wenn Sie das Flex SDK verwenden.

In Adobe® Flash® Professional CS3 ist diese Klasse in der ServiceMonitorShim.sw-Datei enthalten. Um Klassen im air.net-Paket zu verwenden, müssen Sie zunächst die ServiceMonitorShim-Komponente aus dem Bedienfeld „Komponenten“ in die Bibliothek ziehen und dann die folgende import-Anweisung in den ActionScript 3.0-Code einfügen:

import air.net.*;

So verwenden Sie das air.net-Paket in Adobe® Flash® Professional (CS4 oder höher):

  1. Wählen Sie „Datei“ > „Einstellungen für Veröffentlichungen“.
  2. Klicken Sie im Flash-Bedienfeld auf die Schaltfläche „Einstellungen“ für ActionScript 3.0. Wählen Sie „Bibliothekspfad“.
  3. Klicken Sie auf die Schaltfläche „Zur SWC-Datei navigieren“. Navigieren Sie zur Datei „Adobe Flash CSn/AIKn.n/frameworks/libs/air/aircore.swc“ im Adobe Flash Professional-Installationsordner.
  4. Klicken Sie auf „OK“.
  5. Fügen Sie dem ActionScript 3.0-Code folgende import-Anweisung hinzu: import air.net.*;



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inherited    available : Boolean
Gibt an, ob der Dienst zurzeit als „verfügbar“ behandelt wird. Der ursprüngliche Wert ist „false“, bis die Eigenschaft durch eine Statusüberprüfung als „true“ festgelegt wird oder die Eigenschaft ausdrücklich als „true“ initialisiert wird. Normalerweise wird diese Eigenschaft durch eine checkStatus()-Implementierung in einer Subklasse oder durch einen Specializer gesetzt; wenn die Anwendung jedoch über unabhängige Informationen über die Verfügbarkeit eines Services verfügt (zum Beispiel weil gerade eine Anforderung erfolgreich war oder fehlgeschlagen ist), kann die Eigenschaft ausdrücklich gesetzt werden.
ServiceMonitor
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
      host : String
[schreibgeschützt] Der Host, der überwacht wird.
SocketMonitor
 Inherited    lastStatusUpdate : Date
[schreibgeschützt] Der Zeitpunkt der letzten Statusaktualisierung.
ServiceMonitor
 Inherited    pollInterval : Number
Das Intervall zum Pollen des Servers in Millisekunden.
ServiceMonitor
      port : int
[schreibgeschützt] Der Port, der überwacht wird.
SocketMonitor
 Inherited    running : Boolean
[schreibgeschützt] Ob die Überwachung gestartet wurde.
ServiceMonitor
Öffentliche Methoden
 MethodeDefiniert von
  
    SocketMonitor(host:String, port:int)
Erstellt ein SocketMonitor-Objekt für einen festgelegten TCP-Endpunkt.
SocketMonitor
 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
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 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
    makeJavascriptSubclass(constructorFunction:Object):void
[statisch] Fügt dem Prototyp einer JavaScript-Konstrukturfunktion öffentliche ServiceMonitor-Methoden hinzu.
ServiceMonitor
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 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
    start():void
Startet die Dienstüberwachung.
ServiceMonitor
 Inherited
    stop():void
Beendet die Überwachung des Dienstes.
ServiceMonitor
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
  
    toString():String
[override] Gibt das angegebene Objekt als String zurück.
SocketMonitor
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Geschützte Methoden
 MethodeDefiniert von
  
    checkStatus():void
[override] Der Aufruf der checkStatus()-Methode eines SocketMonitor-Objekts führt dazu, dass die Anwendung versucht, eine Verbindung zum Socket herzustellen, um zu prüfen, ob ein connect-Ereignis vorliegt.
SocketMonitor
  
Erstellt ein Socket-Objekt.
SocketMonitor
Ereignisse
 Ereignis Übersicht Definiert von
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.EventDispatcher
 Inherited
    status
Zeigt an, dass sich der Dienststatus geändert hat.ServiceMonitor
Eigenschaftendetails
    

host

Eigenschaft
host:String  [schreibgeschützt]

Laufzeitversionen: AIR 1.0

Der Host, der überwacht wird.



Implementierung
    public function get host():String
    

port

Eigenschaft 
port:int  [schreibgeschützt]

Laufzeitversionen: AIR 1.0

Der Port, der überwacht wird.



Implementierung
    public function get port():int
Konstruktordetails
    

SocketMonitor

()Konstruktor
public function SocketMonitor(host:String, port:int)

Laufzeitversionen: AIR 1.0

Erstellt ein SocketMonitor-Objekt für einen festgelegten TCP-Endpunkt.

Nach dem Erstellen eines SocketMonitor-Objekts sollte der Aufrufer start aufrufen, um mit der Überwachung des Dienststatus zu beginnen.

Wie beim Timer-Objekt sollte der Aufrufer einen Verweis auf das SocketMonitor-Objekt beibehalten. Andernfalls wird das Objekt zur Laufzeit gelöscht und die Überwachung wird beendet.

Parameter
host:String — Der zu überwachende Host.
 
port:int — Der zu überwachende Port.
Methodendetails

    checkStatus

()Methode
override protected function checkStatus():void

Laufzeitversionen: AIR 1.0

Der Aufruf der checkStatus()-Methode eines SocketMonitor-Objekts führt dazu, dass die Anwendung versucht, eine Verbindung zum Socket herzustellen, um zu prüfen, ob ein connect-Ereignis vorliegt.

    createSocket

()Methode 
protected function createSocket():Socket

Laufzeitversionen: AIR 1.0

Erstellt ein Socket-Objekt.

Rückgabewerte
Socket — das Socket-Objekt, das von diesem SocketMonitor verwendet werden soll.

    toString

()Methode 
override public function toString():String

Laufzeitversionen: AIR 1.0

Gibt das angegebene Objekt als String zurück.

Hinweis: Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort override verwenden. So implementiert eine Unterklasse von Object beispielsweise function toString():String anstatt die Basisklasse per „override“ außer Kraft zu setzen.

Rückgabewerte
String — Die Stringdarstellung des Objekts.




[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.