Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Ziehen und Ablegen in AIR
In der Praxis sind synchrone Dateizusagen nur von eingeschränktem Nutzen. Bei einer kleinen Datenmenge könnten
Sie einfach eine Datei in einem temporären Verzeichnis erstellen und der Drag & Drop-Zwischenablage ein reguläres
Dateilisten-Array hinzufügen. Wenn die Datenmenge jedoch groß ist oder wenn die Computerressourcen durch das
Generieren der Daten stark beansprucht werden, ist ein langer synchroner Prozess erforderlich. Lange synchrone
Prozesse können die Aktualisierung der Benutzeroberfläche deutlich verzögern, sodass der Eindruck entsteht, dass die
Anwendung nicht reagiert. Um dieses Problem zu vermeiden, können Sie einen asynchronen Datenprovider erstellen,
der von einem Timer gesteuert wird.
Verwenden eines asynchronen Datenprovider in einer Dateizusage
Adobe AIR 2 und höher
Bei Verwendung eines asynchronen Datenprovider-Objekts muss die isAsync-Eigenschaft von IFilePromise auf true
eingestellt sein und das Objekt, das von der open()-Methode zurückgegeben wird, muss die IEventDispatcher-
Schnittstelle implementieren. Die Laufzeit wartet auf mehrere alternative Ereignisse, sodass verschiedene integrierte
Objekte als Datenprovider verwendet werden können. Beispielsweise werden progress-Ereignisse von FileStream-
und URLStream-Objekten ausgelöst, während socketData-Ereignisse von Socket-Objekten ausgelöst werden. Die
Laufzeit wartet auf die entsprechenden Ereignisse von allen diesen Objekten.
Die folgenden Ereignisse steuern den Prozess zum Lesen der Daten aus dem Datenprovider-Objekt:
Event.OPEN – Informiert die Laufzeit, dass die Datenquelle bereit ist.
ProgressEvent.PROGRESS – Informiert die Laufzeit, dass Daten verfügbar sind. Die Laufzeit liest die verfügbare
Datenmenge aus dem Datenprovider-Objekt.
ProgressEvent.SOCKET_DATA – Informiert die Laufzeit, dass Daten verfügbar sind. Das socketData-Ereignis
wird von socketbasierten Objekten ausgelöst. Für andere Objekttypen sollte ein progress-Ereignis ausgelöst
werden. (Die Laufzeit wartet auf beide Ereignisse, um festzustellen, wann Daten gelesen werden können.)
Event.COMPLETE – Informiert die Laufzeit, dass alle Daten gelesen wurden.
Event.CLOSE – Informiert die Laufzeit, dass alle Daten gelesen wurden. (Zu diesem Zweck wartet die Laufzeit auf
close und auf complete.)
IOErrorEvent.IOERROR – Informiert die Laufzeit, dass beim Lesen der Daten ein Fehler aufgetreten ist. Die
Laufzeit bricht die Erstellung der Datei ab und ruft die close()-Methode von IFilePromise auf.
SecurityErrorEvent.SECURITY_ERROR – Informiert die Laufzeit, dass ein Sicherheitsfehler aufgetreten ist. Die
Laufzeit bricht die Erstellung der Datei ab und ruft die close()-Methode von IFilePromise auf.
HTTPStatusEvent.HTTP_STATUS – Wird zusammen mit httpResponseStatus von der Laufzeit verwendet, um
sicherzustellen, dass die verfügbaren Daten den gewünschten Inhalt darstellen und keine Fehlermeldung (wie
beispielsweise einen 404-Seitenfehler). Objekte auf Basis des HTTP-Protokolls sollten dieses Ereignis ausgeben.
HTTPStatusEvent.HTTP_RESPONSE_STATUS – Wird zusammen mit httpStatus von der Laufzeit verwendet,
um sicherzustellen, dass die verfügbaren Daten den gewünschten Inhalt darstellen. Objekte auf Basis des HTTP-
Protokolls sollten dieses Ereignis ausgeben.
Der Datenprovider sollte diese Ereignisse in der folgenden Reihenfolge ausgeben:
1 open-Ereignis
2 progress- oder socketData-Ereignisse
3 complete- oder close-Ereignisse
Hinweis: Die integrierten Objekte, FileStream, Socket und URLStream, setzen die entsprechenden Ereignisse
automatisch ab.
Letzte Aktualisierung 27.6.2012
666