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 

URLMonitor  - AS3

Paketair.net
Klassepublic class URLMonitor
VererbungURLMonitor Inheritance ServiceMonitor Inheritance EventDispatcher Inheritance Object

Laufzeitversionen: AIR 1.0

Die URLMonitor-Klasse überwacht die Verfügbarkeit eines HTTP- oder HTTPS-basierten Dienstes.

Diese Klasse ist in der Datei „aircore.swc“ enthalten. Adobe® Flash® Builder lädt diese Klasse automatisch, wenn Sie ein Projekt für Adobe ® AIR erstellen. Das Adobe® 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® CS3 Professional 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
      acceptableStatusCodes : Array
Der numerische Statuscode, der ein erfolgreiches Ergebnis anzeigt.
URLMonitor
 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
 Inherited    lastStatusUpdate : Date
[schreibgeschützt] Der Zeitpunkt der letzten Statusaktualisierung.
ServiceMonitor
 Inherited    pollInterval : Number
Das Intervall zum Pollen des Servers in Millisekunden.
ServiceMonitor
 Inherited    running : Boolean
[schreibgeschützt] Ob die Überwachung gestartet wurde.
ServiceMonitor
      urlRequest : URLRequest
[schreibgeschützt] Das URLRequest-Objekt, dass die Probe-Anforderung darstellt.
URLMonitor
Öffentliche Methoden
 MethodeDefiniert von
  
    URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)
Erstellt ein URLMonitor-Objekt für einen angegebenen HTTP- oder HTTPS-basierten Dienst.
URLMonitor
 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.
URLMonitor
 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] Versucht, Inhalt von einer URL im Hintergrund zu laden, um zu überprüfen, ob ein HTTP-Statuscode zurückgegeben wird.
URLMonitor
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
    

acceptableStatusCodes

Eigenschaft
acceptableStatusCodes:Array

Laufzeitversionen: AIR 1.0

Der numerische Statuscode, der ein erfolgreiches Ergebnis anzeigt.



Implementierung
    public function get acceptableStatusCodes():Array
    public function set acceptableStatusCodes(value:Array):void
    

urlRequest

Eigenschaft 
urlRequest:URLRequest  [schreibgeschützt]

Laufzeitversionen: AIR 1.0

Das URLRequest-Objekt, dass die Probe-Anforderung darstellt.



Implementierung
    public function get urlRequest():URLRequest
Konstruktordetails
    

URLMonitor

()Konstruktor
public function URLMonitor(urlRequest:URLRequest, acceptableStatusCodes:Array = null)

Laufzeitversionen: AIR 1.0

Erstellt ein URLMonitor-Objekt für einen angegebenen HTTP- oder HTTPS-basierten Dienst.

Nach dem Erstellen eines URLMonitor sollte der Aufrufer die start()-Methode aufrufen, um mit der Überwachung des Dienststatus zu beginnen.

Wie beim Timer-Objekt sollte der Aufrufer einen Verweis auf das URLMonitor-Objekt beibehalten. Andernfalls könnte das Objekt zur Laufzeit gelöscht und die Überwachung damit beendet werden.

Ein URLRequest-Parameter gibt die Probe-Anforderung für den Abruf vom Server an. Normalerweise ist die Anforderungsmethode entweder "GET" oder "HEAD".

Parameter
urlRequest:URLRequest — Das URLRequest-Objekt, das eine Probe-Anforderung zum Abrufen vom Server darstellt.
 
acceptableStatusCodes:Array (default = null) — Ein Array numerischer Statuscodes, in dem die Codes für erfolgreiche Ergebnisse aufgeführt sind.

Wenn Sie keinen Wert für die acceptableStatusCodes-Eigenschaft angeben, werden die folgenden Statuscodes als erfolgreiche Antworten erkannt:

  • 200 (OK)
  • 202 (Akzeptiert)
  • 204 (Kein Inhalt)
  • 205 (Inhalt zurücksetzen)
  • 206 (Teil des Inhalts, als Antwort auf eine Anforderung mit einem Range-Header)
Methodendetails

    checkStatus

()Methode
override protected function checkStatus():void

Laufzeitversionen: AIR 1.0

Versucht, Inhalt von einer URL im Hintergrund zu laden, um zu überprüfen, ob ein HTTP-Statuscode zurückgegeben wird.

Wird ein Statuscode empfangen, der in der acceptableStatusCodes-Eigenschaft aufgeführt ist, wird die available-Eigenschaft auf true gesetzt. Wird ein Statuscode empfangen, der nicht in der acceptableStatusCodes-Liste aufgeführt ist, oder wenn ein Sicherheits- oder E/A-Fehler auftritt, wird die available-Eigenschaft auf false gesetzt.

    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.